Apigee משתמשת במסד הנתונים של Cassandra כדי לאחסן את רוב הנתונים, כולל נתונים של שרתי proxy, מטמון ואסימונים. דחיסה הוא תהליך קריטי לצמצום גודל הנתונים שמאוחסנים במסדי נתונים, חיוני לתחזוקה יעילה של מסדי נתונים. Cassandra תומכת באסטרטגיות שונות לדחיסה. ב-Apigee ממליצים לכל לקוחות Edge for Private Cloud להפעיל את אשכולות Cassandra שלהם עם LeveledCompactionStrategy
, במקום SizeTieredCompactionStrategy
שמוגדר כברירת מחדל, לכל הטבלאות. LeveledCompactionStrategy
מציע ביצועים טובים יותר, ניצול יעיל יותר של הדיסק, דחיסות יעילות יותר וצורך בפחות מקום פנוי בהשוואה ל-SizeTieredCompactionStrategy
.
כל התקנות החדשות של Apigee בגרסה 4.52.02 ואילך מגדירות את Cassandra באופן אוטומטי באמצעות LeveledCompactionStrategy
. עם זאת, אם אתה משתמש בגרסה ישנה יותר של Apigee או שדרגת ל-Apigee 4.53.00 מגרסה ישנה יותר, יכול להיות שההתקנה שלך עדיין תשתמש ב-Cassandra עם SizeTieredCompactionStrategy
.
למרות שלא מומלץ לשנות את אסטרטגיית הדחיסה מלבד LeveledCompactionStrategy
, במסמך הזה מוסבר איך לבצע את השינוי במקרה הצורך, ומוצגות הוראות לבדיקה של אסטרטגיית הדחיסה הנוכחית. שינוי של אסטרטגיית הדחיסה לאפשרות לא מומלצת עלול לגרום לכך ששדרוגי תוכנה עתידיים של Cassandra יחליפו את השינויים שלך. אם אתם משתמשים בגישה לא סטנדרטית, מומלץ לאמת את אסטרטגיית הדחיסה אחרי כל שדרוג.
הכנה
בדיקה של שיטת הדחיסה הקיימת
כדי לבדוק את אסטרטגיית הדחיסה הקיימת בטבלאות, פועלים לפי ההוראות שמפורטות בנספח 1. אם שיטת הדחיסה כבר מוגדרת כ-LeveledCompactionStrategy
, יכול להיות שהסיבה לכך היא שהתחילתם עם התקנה של OPDK מגרסה 4.51 ואילך, או ששיניתם בעבר ל-LeveledCompactionStrategy
בהתאם להמלצה של Apigee. אם אתם כבר משתמשים ב-LeveledCompactionStrategy
, מומלץ להמשיך להשתמש בשיטה הזו ולהימנע משינויים. עם זאת, מאחר ש-Edge for Private Cloud מופעל על ידכם, בהוראות הבאות מוסבר איך לשנות את אסטרטגיית הדחיסה אם רוצים.
גיבוי
מאחר ששינוי אסטרטגיית הדחיסה מפעיל מחזור דחיסה מלא בצמתים של Cassandra, לכן הוא עשוי לגרום לזמני אחזור מסוימים עקב העומס של הדחוסות והתנועה בו-זמנית באפליקציות. יכול להיות שצריך להחזיר את השינוי הזה למצב קודם כדי לשחזר צמתים של Cassandra מהגיבויים. במאמר איך מגבים מוסבר איך לגבות את הנתונים לפני שמשנים את אסטרטגיית הדחיסה.
תפוקת הדחיסה
אחרי שינוי אסטרטגיית הדחיסה ל-LeveledCompactionStrategy
, הדחיסות עשויות לפעול במשך זמן רב. זמן הריצה עשוי להשתנות בהתאם לגודל דחיסת הנתונים. במהלך מחזור הדחיסה, Cassandra עשויה לנצל יותר משאבי מערכת. כדי לוודא שהדחיסה לא תגזול הרבה משאבי מערכת, דבר שעלול לשבש בקשות של סביבת זמן הריצה של ה-API, מומלץ להגדיר מגבלות על תפוקת הדחיסה.
מריצים את הפקודה nodetool
הבאה בכל אחד מהצמתים כדי להגדיר את תפוקת הדחיסה למקסימום של 128MB בכל צמתים של Cassandra:
nodetool setcompactionthroughput 128
התאמת גודל המכונות הווירטואליות לדחיסה
לפני שמבצעים את השינוי הזה, צריך לוודא שיש לצמתים של Cassandra מספיק משאבי מעבד (CPU) וזיכרון. לפני שמבצעים את השינוי הזה, חשוב לוודא שאף צומת של Cassandra לא פועל עם יותר מ-25% מעומס המעבד.
אחרי שינוי של שיטת הדחיסה, צפויה להיפתח מחזור דחיסה מלא, לכן מומלץ לשנות את שיטת הדחיסה בתקופות שבהן יש תנועה נמוכה.
הפעלות מושהות
יכול להיות שלא תוכלו להשלים את השינוי בכל הצמתים בתוך יום, במיוחד אם אתם מפעילים אשכולות גדולים של Cassandra, כי צריך לבנות מחדש את האינדקסים בכל צומת בנפרד. אתם יכולים לשנות את אסטרטגיית הדחיסה של סכימה אחת או של טבלה אחת בכל פעם. לשם כך, צריך לשנות את הטבלה ולשנות את אסטרטגיית הדחיסה שלה, ואז לבנות מחדש את כל האינדקסים בטבלה (אם יש) בכל הצמתים. לאחר מכן, חוזרים על התהליך שלמעלה לכל טבלה או מרחב מפתחות. אפשר לפרק רצים כאלה בטבלה אחת או במרחב מפתחות אחד, כך שאפשר יהיה להשתמש בהם בימים שונים.
לדוגמה, כדי לשנות את שיטת הדחיסה של הטבלה oauth_20_access_tokens
בסכימה kms
ל-LeveledCompactionStrategy
, אפשר לבצע את הפעולות הבאות:
-
כדי לשנות את אסטרטגיית הדחיסה של הטבלה, מריצים את ה-CQL הבא:
ALTER TABLE kms.oauth_20_access_tokens WITH compaction = {'class' : 'LeveledCompactionStrategy'};
-
יצירת מחדש של כל המדדים של הטבלה הזו בלבד:
nodetool rebuild_index kms oauth_20_access_tokens oauth_20_access_tokens_app_id_idx nodetool rebuild_index kms oauth_20_access_tokens oauth_20_access_tokens_client_id_idx nodetool rebuild_index kms oauth_20_access_tokens oauth_20_access_tokens_refresh_token_idx
שינוי אסטרטגיית הדחיסה
ככלל, שינוי אסטרטגיית הדחיסה הוא תהליך דו-שלבי:
- אתם יכולים לשנות את אסטרטגיית הדחיסה של כל טבלה.
- צריך לבנות מחדש את כל המדדים בכל צומת בנפרד.
כדי לשנות את אסטרטגיית הדחיסה, צריך להריץ פקודת ALTER TABLE
בכל טבלה בנפרד. פקודת ALTER TABLE
לדוגמה תיראה כך:
# To change to LeveledCompactionStrategyALTER TABLE
kms.oauth_20_access_tokens WITH compaction = {'class' : 'LeveledCompactionStrategy'}; # To change to SizeTieredCompactionStrategyALTER TABLE
kms.oauth_20_access_tokens WITH compaction = {'class' : 'SizeTieredCompactionStrategy'};
שינוי טבלה להגדרת אסטרטגיית דחיסה חדשה
מריצים את ערכי ה-CQL הבאים בכל צומת של Cassandra כדי לשנות את האסטרטגיה למרחב מפתחות אחד בכל פעם. אפשר להריץ CQL לפקודת CQL. הוראות להפעלת הנחיית CQL:
/opt/apigee/apigee-cassandra/bin/cqlsh `hostname -i`
התבצע חיבור ל-Apigee בכתובת XXXXXXXX:9042.
[cqlsh 5.0.1 | Cassandra 3.11.16 | CQL spec 3.4.4 | Native protocol v4] Use HELP for help. cqlsh>
הפקודות הבאות עוסקות בשינוי אסטרטגיית הדחיסה ל-LeveledCompactionStrategy
, אבל אפשר להשתמש בפקודות דומות כדי לשנות לאסטרטגיות דחיסה אחרות.
שלבים 14 עד 16 שבהמשך רלוונטיים רק אם אתם משתמשים במונטיזציה.
- שאילתות CQL לשינוי אסטרטגיית הדחיסה של מרחבי המפתחות:
kms
ALTER TABLE kms.organizations WITH compaction = {'class' : 'LeveledCompactionStrategy'}; ALTER TABLE kms.maps WITH compaction = {'class' : 'LeveledCompactionStrategy'}; ALTER TABLE kms.apps WITH compaction = {'class' : 'LeveledCompactionStrategy'}; ALTER TABLE kms.app_credentials WITH compaction = {'class' : 'LeveledCompactionStrategy'}; ALTER TABLE kms.api_products WITH compaction = {'class' : 'LeveledCompactionStrategy'}; ALTER TABLE kms.apiproducts_appslist WITH compaction = {'class' : 'LeveledCompactionStrategy'}; ALTER TABLE kms.api_resources WITH compaction = {'class' : 'LeveledCompactionStrategy'}; ALTER TABLE kms.app_end_user WITH compaction = {'class' : 'LeveledCompactionStrategy'}; ALTER TABLE kms.oauth_20_authorization_codes WITH compaction = {'class' : 'LeveledCompactionStrategy'}; ALTER TABLE kms.oauth_20_access_tokens WITH compaction = {'class' : 'LeveledCompactionStrategy'}; ALTER TABLE kms.oauth_10_request_tokens WITH compaction = {'class' : 'LeveledCompactionStrategy'}; ALTER TABLE kms.oauth_10_access_tokens WITH compaction = {'class' : 'LeveledCompactionStrategy'}; ALTER TABLE kms.oauth_10_verifiers WITH compaction = {'class' : 'LeveledCompactionStrategy'}; ALTER TABLE kms.app_enduser_tokens WITH compaction = {'class' : 'LeveledCompactionStrategy'};
- כללי CQL לשינוי אסטרטגיית הדחיסה למרחב המפתחות:
user_settings
ALTER TABLE user_settings.user_settings WITH compaction = {'class' : 'LeveledCompactionStrategy'};
- כללי CQL לשינוי אסטרטגיית הדחיסה למרחב המפתחות:
keyvaluemap
ALTER TABLE keyvaluemap.keyvaluemaps_r21 WITH compaction = {'class' : 'LeveledCompactionStrategy'};
- כללי CQL לשינוי אסטרטגיית הדחיסה למרחב המפתחות:
devconnect
ALTER TABLE devconnect.developers WITH compaction = {'class' : 'LeveledCompactionStrategy'}; ALTER TABLE devconnect.companies WITH compaction = {'class' : 'LeveledCompactionStrategy'}; ALTER TABLE devconnect.company_developers WITH compaction = {'class' : 'LeveledCompactionStrategy'};
- כללי CQL לשינוי אסטרטגיית הדחיסה למרחב המפתחות:
counter
ALTER TABLE counter.counters_current_version WITH compaction = {'class' : 'LeveledCompactionStrategy'}; ALTER TABLE counter.counters_with_expiry WITH compaction = {'class' : 'LeveledCompactionStrategy'}; ALTER TABLE counter.counters WITH compaction = {'class' : 'LeveledCompactionStrategy'}; ALTER TABLE counter.key_timestamp_count WITH compaction = {'class' : 'LeveledCompactionStrategy'}; ALTER TABLE counter.timestamp_key WITH compaction = {'class' : 'LeveledCompactionStrategy'}; ALTER TABLE counter.period_timestamp WITH compaction = {'class' : 'LeveledCompactionStrategy'}; ALTER TABLE counter.gateway_quota WITH compaction = {'class' : 'LeveledCompactionStrategy'};
- שאילתות CQL לשינוי אסטרטגיית הדחיסה של מרחבי המפתחות:
cache
ALTER TABLE cache.cache_entries WITH compaction = {'class' : 'LeveledCompactionStrategy'}; ALTER TABLE cache.cache_sequence_id_r24 WITH compaction = {'class' : 'LeveledCompactionStrategy'};
- כללי CQL לשינוי אסטרטגיית הדחיסה למרחב המפתחות:
auth
ALTER TABLE auth.totp WITH compaction = {'class' : 'LeveledCompactionStrategy'};
- שאילתות CQL לשינוי אסטרטגיית הדחיסה של מרחבי המפתחות:
audit
ALTER TABLE audit.audits WITH compaction = {'class' : 'LeveledCompactionStrategy'}; ALTER TABLE audit.audits_ref WITH compaction = {'class' : 'LeveledCompactionStrategy'};
- שאילתות CQL לשינוי אסטרטגיית הדחיסה של מרחבי המפתחות:
apprepo
ALTER TABLE apprepo.organizations WITH compaction = {'class' : 'LeveledCompactionStrategy'}; ALTER TABLE apprepo.environments WITH compaction = {'class' : 'LeveledCompactionStrategy'}; ALTER TABLE apprepo.apiproxies WITH compaction = {'class' : 'LeveledCompactionStrategy'}; ALTER TABLE apprepo.apiproxy_revisions WITH compaction = {'class' : 'LeveledCompactionStrategy'}; ALTER TABLE apprepo.api_proxy_revisions_r21 WITH compaction = {'class' : 'LeveledCompactionStrategy'};
- כללי CQL לשינוי אסטרטגיית הדחיסה למרחב המפתחות:
apimodel_v2
ALTER TABLE apimodel_v2.apis WITH compaction = {'class' : 'LeveledCompactionStrategy'}; ALTER TABLE apimodel_v2.apis_revision WITH compaction = {'class' : 'LeveledCompactionStrategy'}; ALTER TABLE apimodel_v2.resource WITH compaction = {'class' : 'LeveledCompactionStrategy'}; ALTER TABLE apimodel_v2.method WITH compaction = {'class' : 'LeveledCompactionStrategy'}; ALTER TABLE apimodel_v2.revision_counters WITH compaction = {'class' : 'LeveledCompactionStrategy'}; ALTER TABLE apimodel_v2.template_counters WITH compaction = {'class' : 'LeveledCompactionStrategy'}; ALTER TABLE apimodel_v2.template WITH compaction = {'class' : 'LeveledCompactionStrategy'}; ALTER TABLE apimodel_v2.credentials WITH compaction = {'class' : 'LeveledCompactionStrategy'}; ALTER TABLE apimodel_v2.credentialsv2 WITH compaction = {'class' : 'LeveledCompactionStrategy'}; ALTER TABLE apimodel_v2.schemas WITH compaction = {'class' : 'LeveledCompactionStrategy'}; ALTER TABLE apimodel_v2.security WITH compaction = {'class' : 'LeveledCompactionStrategy'}; ALTER TABLE apimodel_v2.template_auth WITH compaction = {'class' : 'LeveledCompactionStrategy'};
- שאילתות CQL לשינוי אסטרטגיית הדחיסה של מרחבי המפתחות:
identityzone
ALTER TABLE identityzone.IdentityZones WITH compaction = {'class' : 'LeveledCompactionStrategy'}; ALTER TABLE identityzone.OrgToIdentityZone WITH compaction = {'class' : 'LeveledCompactionStrategy'};
- כללי CQL לשינוי אסטרטגיית הדחיסה למרחב המפתחות:
dek
ALTER TABLE dek.keys WITH compaction = {'class' : 'LeveledCompactionStrategy'};
- כללי CQL לשינוי אסטרטגיית הדחיסה למרחב המפתחות:
analytics
ALTER TABLE analytics.custom_aggregates_defn WITH compaction = {'class' : 'LeveledCompactionStrategy'}; ALTER TABLE analytics.custom_rules_defn WITH compaction = {'class' : 'LeveledCompactionStrategy'}; ALTER TABLE analytics.custom_aggregates_defn_updates WITH compaction = {'class' : 'LeveledCompactionStrategy'}; ALTER TABLE analytics.custom_rules_defn_updates WITH compaction = {'class' : 'LeveledCompactionStrategy'};
- [מונטיזציה בלבד] CQL לשינוי אסטרטגיית הדחיסה למרחב המפתחות:
mint
ALTER TABLE mint.limits WITH compaction = {'class' : 'LeveledCompactionStrategy'}; ALTER TABLE mint.suspended_developer_products WITH compaction = {'class' : 'LeveledCompactionStrategy'}; ALTER TABLE mint.invitations WITH compaction = {'class' : 'LeveledCompactionStrategy'};
- [מונטיזציה בלבד] CQL לשינוי אסטרטגיית הדחיסה למרחב המפתחות:
taurus
ALTER TABLE taurus.triggers WITH compaction = {'class' : 'LeveledCompactionStrategy'}; ALTER TABLE taurus.job_details WITH compaction = {'class' : 'LeveledCompactionStrategy'}; ALTER TABLE taurus.org_triggers WITH compaction = {'class' : 'LeveledCompactionStrategy'}; ALTER TABLE taurus.triggers_suite WITH compaction = {'class' : 'LeveledCompactionStrategy'};
- [Monetization only] שאילתות CQL לשינוי אסטרטגיית הדחיסה של מרחבי המפתחות:
notification
ALTER TABLE notification.notification_service_item WITH compaction = {'class' : 'LeveledCompactionStrategy'}; ALTER TABLE notification.notification_service_black_list_item WITH compaction = {'class' : 'LeveledCompactionStrategy'}; ALTER TABLE notification.notification_email_template_item WITH compaction = {'class' : 'LeveledCompactionStrategy'};
בנייה מחדש של אינדקסים
צריך לבצע את השלב הזה אחרי כל שינוי באסטרטגיית הדחיסה. עליך להריץ את פקודות nodetool
הבאות אחת אחרי השנייה בכל צומת של Cassandra.
שלבים 7 עד 9 שבהמשך רלוונטיים רק אם אתם משתמשים במונטיזציה.
-
יצירת מחדש של אינדקסים למרחב המפתחות:
kms
nodetool rebuild_index kms api_products api_products_organization_name_idx nodetool rebuild_index kms app_credentials app_credentials_api_products_idx nodetool rebuild_index kms app_credentials app_credentials_organization_app_id_idx nodetool rebuild_index kms app_credentials app_credentials_organization_name_idx nodetool rebuild_index kms app_end_user app_end_user_app_id_idx nodetool rebuild_index kms apps apps_app_family_idx nodetool rebuild_index kms apps apps_app_id_idx nodetool rebuild_index kms apps apps_app_type_idx nodetool rebuild_index kms apps apps_name_idx nodetool rebuild_index kms apps apps_organization_name_idx nodetool rebuild_index kms apps apps_parent_id_idx nodetool rebuild_index kms apps apps_parent_status_idx nodetool rebuild_index kms apps apps_status_idx nodetool rebuild_index kms maps maps_organization_name_idx nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_app_id_idx nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_consumer_key_idx nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_organization_name_idx nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_status_idx nodetool rebuild_index kms oauth_10_request_tokens oauth_10_request_tokens_consumer_key_idx nodetool rebuild_index kms oauth_10_request_tokens oauth_10_request_tokens_organization_name_idx nodetool rebuild_index kms oauth_10_verifiers oauth_10_verifiers_organization_name_idx nodetool rebuild_index kms oauth_10_verifiers oauth_10_verifiers_request_token_idx nodetool rebuild_index kms oauth_20_access_tokens oauth_20_access_tokens_app_id_idx nodetool rebuild_index kms oauth_20_access_tokens oauth_20_access_tokens_client_id_idx nodetool rebuild_index kms oauth_20_access_tokens oauth_20_access_tokens_refresh_token_idx nodetool rebuild_index kms oauth_20_authorization_codes oauth_20_authorization_codes_client_id_idx nodetool rebuild_index kms oauth_20_authorization_codes oauth_20_authorization_codes_organization_name_idx
-
בנייה מחדש של אינדקסים במרחב המפתחות:
devconnect
nodetool rebuild_index devconnect companies companies_name_idx nodetool rebuild_index devconnect companies companies_organization_name_idx nodetool rebuild_index devconnect companies companies_status_idx nodetool rebuild_index devconnect company_developers company_developers_company_name_idx nodetool rebuild_index devconnect company_developers company_developers_developer_email_idx nodetool rebuild_index devconnect company_developers company_developers_organization_name_idx nodetool rebuild_index devconnect developers developers_email_idx nodetool rebuild_index devconnect developers developers_organization_name_idx nodetool rebuild_index devconnect developers developers_status_idx
-
יצירת מחדש של אינדקסים למרחב המפתחות:
cache
nodetool rebuild_index cache cache_entries cache_entries_cache_name_idx
-
יצירת מחדש של אינדקסים למרחב המפתחות:
audit
nodetool rebuild_index audit audits audits_operation_idx nodetool rebuild_index audit audits audits_requesturi_idx nodetool rebuild_index audit audits audits_responsecode_idx nodetool rebuild_index audit audits audits_timestamp_idx nodetool rebuild_index audit audits audits_user_idx
-
יצירת מחדש של אינדקסים למרחב המפתחות:
apimodel_v2
nodetool rebuild_index apimodel_v2 apis a_name nodetool rebuild_index apimodel_v2 apis a_org_name nodetool rebuild_index apimodel_v2 apis_revision ar_a_active_rev nodetool rebuild_index apimodel_v2 apis_revision ar_a_def_index_template nodetool rebuild_index apimodel_v2 apis_revision ar_a_def_method_template nodetool rebuild_index apimodel_v2 apis_revision ar_a_latest_rev nodetool rebuild_index apimodel_v2 apis_revision ar_a_name nodetool rebuild_index apimodel_v2 apis_revision ar_a_uuid nodetool rebuild_index apimodel_v2 apis_revision ar_base_url nodetool rebuild_index apimodel_v2 apis_revision ar_is_active nodetool rebuild_index apimodel_v2 apis_revision ar_is_latest nodetool rebuild_index apimodel_v2 apis_revision ar_name nodetool rebuild_index apimodel_v2 apis_revision ar_org_name nodetool rebuild_index apimodel_v2 apis_revision ar_rel_ver nodetool rebuild_index apimodel_v2 apis_revision ar_rev_num nodetool rebuild_index apimodel_v2 method m_a_name nodetool rebuild_index apimodel_v2 method m_api_uuid nodetool rebuild_index apimodel_v2 method m_ar_uuid nodetool rebuild_index apimodel_v2 method m_base_url nodetool rebuild_index apimodel_v2 method m_name nodetool rebuild_index apimodel_v2 method m_org_name nodetool rebuild_index apimodel_v2 method m_r_name nodetool rebuild_index apimodel_v2 method m_r_uuid nodetool rebuild_index apimodel_v2 method m_res_path nodetool rebuild_index apimodel_v2 method m_rev_num nodetool rebuild_index apimodel_v2 resource r_a_name nodetool rebuild_index apimodel_v2 resource r_api_uuid nodetool rebuild_index apimodel_v2 resource r_ar_uuid nodetool rebuild_index apimodel_v2 resource r_base_url nodetool rebuild_index apimodel_v2 resource r_name nodetool rebuild_index apimodel_v2 resource r_org_name nodetool rebuild_index apimodel_v2 resource r_res_path nodetool rebuild_index apimodel_v2 resource r_rev_num nodetool rebuild_index apimodel_v2 schemas s_api_uuid nodetool rebuild_index apimodel_v2 schemas s_ar_uuid nodetool rebuild_index apimodel_v2 security sa_api_uuid nodetool rebuild_index apimodel_v2 security sa_ar_uuid nodetool rebuild_index apimodel_v2 template t_a_name nodetool rebuild_index apimodel_v2 template t_a_uuid nodetool rebuild_index apimodel_v2 template t_entity nodetool rebuild_index apimodel_v2 template t_name nodetool rebuild_index apimodel_v2 template t_org_name nodetool rebuild_index apimodel_v2 template_auth au_api_uuid
-
יצירת מחדש של אינדקסים למרחב המפתחות:
dek
nodetool rebuild_index dek keys usecase_index
-
[מונטיזציה בלבד] יצירה מחדש של אינדקסים במרחב המפתחות:
mint
nodetool rebuild_index mint limits limits_created_date_idx nodetool rebuild_index mint limits limits_id_idx nodetool rebuild_index mint limits limits_org_id_idx nodetool rebuild_index mint limits limits_updated_date_idx nodetool rebuild_index mint suspended_developer_products suspended_developer_products_created_date_idx nodetool rebuild_index mint suspended_developer_products suspended_developer_products_currency_idx nodetool rebuild_index mint suspended_developer_products suspended_developer_products_dev_id_idx nodetool rebuild_index mint suspended_developer_products suspended_developer_products_id_idx nodetool rebuild_index mint suspended_developer_products suspended_developer_products_limit_id_idx nodetool rebuild_index mint suspended_developer_products suspended_developer_products_org_id_idx nodetool rebuild_index mint suspended_developer_products suspended_developer_products_prod_id_idx nodetool rebuild_index mint suspended_developer_products suspended_developer_products_reason_code_idx nodetool rebuild_index mint suspended_developer_products suspended_developer_products_sub_org_id_idx nodetool rebuild_index mint invitations invitations_company_id_idx nodetool rebuild_index mint invitations invitations_created_at_idx nodetool rebuild_index mint invitations invitations_developer_id_idx nodetool rebuild_index mint invitations invitations_lastmodified_at_idx nodetool rebuild_index mint invitations invitations_org_id_idx
-
[Monetization only] Rebuild indices for keyspace:
taurus
nodetool rebuild_index taurus triggers triggers_env_idx nodetool rebuild_index taurus triggers triggers_job_id_idx nodetool rebuild_index taurus triggers triggers_org_id_idx nodetool rebuild_index taurus job_details job_details_job_class_name_idx nodetool rebuild_index taurus job_details job_details_job_group_idx nodetool rebuild_index taurus job_details job_details_job_name_idx nodetool rebuild_index taurus org_triggers org_triggers_org_id_idx nodetool rebuild_index taurus triggers_suite triggers_suite_group_idx nodetool rebuild_index taurus triggers_suite triggers_suite_name_idx nodetool rebuild_index taurus triggers_suite triggers_suite_suite_id_idx
-
[מונטיזציה בלבד] יצירה מחדש של אינדקסים במרחב המפתחות:
notification
nodetool rebuild_index notification notification_service_item notification_service_item_org_id_idx nodetool rebuild_index notification notification_service_item notification_service_item_status_idx nodetool rebuild_index notification notification_service_black_list_item notification_service_black_list_item_org_id_idx nodetool rebuild_index notification notification_service_black_list_item notification_service_black_list_item_to_email_idx nodetool rebuild_index notification notification_email_template_item notification_email_template_item_name_idx nodetool rebuild_index notification notification_email_template_item notification_email_template_item_org_id_idx
אימות
- כדי לבדוק שהשינוי בשיטת הדחיסה בתבנית נכנס לתוקף, פועלים לפי ההוראות שמפורטות בנספח 1.
- מוודאים שהדחיסה פועלת בהצלחה ושהנתונים דחוסים אחרי שינוי השיטה:
- בכל צומת של Cassandra, מריצים את הפקודה הבאה של nodetool כדי לבדוק אם כל הדחיסות הושלמו ושאין שום דחיסה בהמתנה:
nodetool compactionstats
- אחרי שאומת באמצעות הפקודה שלמעלה, כדי לוודא שאין פעולות דחיסה בהמתנה, צריך לבדוק את חותמת הזמן של השינוי האחרון בקובצי הנתונים (בערך
/opt/apigee/data/apigee-cassandra/data/
) אחרי חותמת הזמן של מועד ביצוע השינוי של CQL לשיטת הדחיסה.
- בכל צומת של Cassandra, מריצים את הפקודה הבאה של nodetool כדי לבדוק אם כל הדחיסות הושלמו ושאין שום דחיסה בהמתנה:
Rollback
אם צריך לבצע חזרה לאחור, אפשר לבחור באחת מהאפשרויות הבאות:
אפשרות 1: ביטול השינוי
מבצעים חזרה לאחור של אסטרטגיית הדחיסה לאסטרטגיה שהיתה לכם במקור.
מריצים פקודות דומות של ALTER TABLE בהודעת ה-CQL שהרצתם קודם כדי לשנות את אסטרטגיית הדחיסה.
אם כבר בנית מחדש מדדים כששינית את אסטרטגיית הדחיסה ל-LeveledCompactionStrategy
, יהיה עליך לבנות מחדש את האינדקסים שוב. מבצעים את אותם השלבים כמו קודם כדי לבנות מחדש את כל האינדקסים. אם לא בנית מחדש את האינדקסים קודם, אין צורך לבנות מחדש את האינדקסים במהלך החזרה למצב הקודם.
אפשרות 2: שחזור נתונים מלא מהגיבוי
שחזור נתונים מהגיבוי בכל מרחבי המפתחות:
יש לפעול לפי ההוראות לשחזור שמפורטות במאמר שחזור מהגיבוי.
נספח 1: בדיקת אסטרטגיית הדחיסה
שיטות הדחיסה מוגדרות ברמת הטבלה ב-Cassandra. אפשר להשתמש בשאילתות הבאות כדי לבדוק את שיטת הדחיסה של כל טבלה.
אפשר להריץ את ה-CQL לפקודת ה-CQL. כדי להפעיל את ה-prompt של CQL:
/opt/apigee/apigee-cassandra/bin/cqlsh `hostname -i`
תראו תגובה שדומה לזו:
Connected to apigee at XX.XX.XX.XX:9042. [cqlsh 5.0.1 | Cassandra 3.11.16 | CQL spec 3.4.4 | Native protocol v4] Use HELP for help. cqlsh>
אפשר לקבוע את אסטרטגיית הדחיסה הנוכחית כך:
כל שורה בפלט מתייחסת לטבלה במרחב מפתחות. בכל שורה, העמודה compaction מציינת את שיטת הדחיסה שבה נעשה שימוש בטבלה.
- אם שיטת הדחיסה מוגדרת כ-SizeTieredCompactionStrategy, העמודה compaction בשאילתות הבאות תיראה כך:
- אם שיטת הדחיסה מוגדרת לערך LeveledCompactionStrategy, העמודה compaction בשאילתות שלמטה תהיה בערך כך:
{'class': 'org.apache.cassandra.db.compaction.SizeTieredCompactionStrategy', 'max_threshold': '32', 'min_threshold': '4'}
{'class': 'org.apache.cassandra.db.compaction.LeveledCompactionStrategy'}
אפשר להריץ את השאילתות הבאות כדי לקבוע את אסטרטגיית הדחיסה לכל טבלה במרחב מפתחות מסוים:
select keyspace_name, table_name, compaction from system_schema.tables where keyspace_name = 'kms'; select keyspace_name, table_name, compaction from system_schema.tables where keyspace_name = 'user_settings'; select keyspace_name, table_name, compaction from system_schema.tables where keyspace_name = 'keyvaluemap'; select keyspace_name, table_name, compaction from system_schema.tables where keyspace_name = 'devconnect'; select keyspace_name, table_name, compaction from system_schema.tables where keyspace_name = 'counter'; select keyspace_name, table_name, compaction from system_schema.tables where keyspace_name = 'cache'; select keyspace_name, table_name, compaction from system_schema.tables where keyspace_name = 'auth'; select keyspace_name, table_name, compaction from system_schema.tables where keyspace_name = 'audit'; select keyspace_name, table_name, compaction from system_schema.tables where keyspace_name = 'apprepo'; select keyspace_name, table_name, compaction from system_schema.tables where keyspace_name = 'apimodel_v2'; select keyspace_name, table_name, compaction from system_schema.tables where keyspace_name = 'identityzone'; select keyspace_name, table_name, compaction from system_schema.tables where keyspace_name = 'dek'; select keyspace_name, table_name, compaction from system_schema.tables where keyspace_name = 'analytics'; #If you are using Monetization, check the below as well select keyspace_name, table_name, compaction from system_schema.tables where keyspace_name = 'mint'; select keyspace_name, table_name, compaction from system_schema.tables where keyspace_name = 'taurus'; select keyspace_name, table_name, compaction from system_schema.tables where keyspace_name = 'notification';