שינוי אסטרטגיית הדחיסה של Cassandra

Apigee משתמשת במסד הנתונים של Cassandra כדי לאחסן את רוב הנתונים, כולל נתונים של שרתי proxy, מטמון ואסימונים. דחיסה הוא תהליך קריטי לצמצום גודל הנתונים שמאוחסנים במסדי נתונים, חיוני לתחזוקה יעילה של מסדי נתונים. Cassandra תומכת באסטרטגיות שונות לדחיסה. ההמלצה של Apigee לכל הלקוחות של Edge for Private Cloud היא להפעיל אשכולות Cassandra באמצעות LeveledCompactionStrategy, ולא את ברירת המחדל SizeTieredCompactionStrategy בכל הטבלאות. LeveledCompactionStrategy מציע ביצועים טובים יותר, ניצול משופר של הדיסק, דחיסת נתונים יעילה יותר והוא דורש פחות מקום פנוי בהשוואה ל-SizeTieredCompactionStrategy.

כל ההתקנות החדשות של Apigee 4.52.02 ואילך מגדירות אוטומטית את Cassandra עם LeveledCompactionStrategy. עם זאת, אם אתה משתמש בגרסה ישנה יותר של Apigee או שדרגת ל-Apigee 4.52.02 מגרסה ישנה יותר, יכול להיות שההתקנה שלך עדיין תשתמש ב-Cassandra עם SizeTieredCompactionStrategy.

למרות שלא מומלץ לשנות את אסטרטגיית הדחיסה מלבד LeveledCompactionStrategy, במסמך הזה מוסבר איך לבצע את השינוי במקרה הצורך, ומוצגות הוראות לבדיקה של אסטרטגיית הדחיסה הנוכחית. שינוי של אסטרטגיית הדחיסה לאפשרות לא מומלצת עלול לגרום לכך ששדרוגי תוכנה עתידיים של Cassandra יחליפו את השינויים שלך. אם אתם משתמשים בגישה לא רגילה, מומלץ לאמת את אסטרטגיית הדחיסה אחרי כל שדרוג.

הכנה

בדיקה של שיטת הדחיסה הקיימת

כדי לבדוק את אסטרטגיית הדחיסה הקיימת בטבלאות, פועלים לפי ההוראות שמפורטות בנספח 1. אם שיטת הדחיסה כבר LeveledCompactionStrategy, יכול להיות שהסיבה לכך היא התחלה בהתקנה של OPDK 4.51 ואילך, או שינוי קודם ל-LeveledCompactionStrategy בהתאם להמלצה של Apigee. אם אתם כבר משתמשים ב-LeveledCompactionStrategy, מערכת Apigee ממליצה להמשיך עם השיטה הזו ולהימנע משינויים. עם זאת, מכיוון שאתם מפעילים את Edge for Private Cloud, בהוראות הבאות מוסבר איך לשנות את אסטרטגיית הדחיסה אם יש צורך בכך.

גיבוי

מאחר ששינוי אסטרטגיית הדחיסה מפעיל מחזור דחיסה מלא בצמתים של Cassandra, לכן הוא עשוי לגרום לזמני אחזור מסוימים עקב העומס של הדחוסות והתנועה בו-זמנית באפליקציות. יכול להיות שצריך להחזיר את השינוי הזה למצב קודם כדי לשחזר צמתים של Cassandra מהגיבויים. במאמר איך מגבים מוסבר איך לגבות את הנתונים לפני שמשנים את אסטרטגיית הדחיסה.

תפוקת הדחיסה

אחרי ששיטת הדחיסה תשתנה ל-LeveledCompactionStrategy, פעולות דחיסה יכולות לפעול במשך הרבה זמן. זמן הריצה עשוי להשתנות בהתאם לגודל דחיסת הנתונים. במהלך הדחיסה מחזור, Cassandra עשויה להשתמש ביותר משאבי מערכת. כדי להבטיח שהדחיסה לא תדרוש הרבה ממשאבי המערכת, שעשויים לשבש בקשות זמן ריצה של API, מומלץ להגדיר מגבלות תפוקת הדחיסה.

מריצים את פקודת nodetool הבאה בכל אחד מהצמתים כדי להגדיר את תפוקת הדחיסה לערך המקסימלי ב-128MB בכל צמתים של Cassandra:

nodetool setcompactionthroughput 128

התאמת גודל המכונות הווירטואליות לדחיסה

לפני שמבצעים את השינוי הזה, צריך לוודא שלצמתים של Cassandra יש מספיק משאבי מעבד וזיכרון. צריך לוודא שאף צומת של Cassandra לא פועל ביותר מ-25% מעומס המעבד (CPU) לפני ביצוע השינוי הזה.

לאחר שינוי בשיטת הדחיסה, צפוי לפעול מחזור דחיסה מלא, ולכן מומלץ לשנות את אסטרטגיית הדחיסה בתקופות שבהן אין הרבה תנועה.

הפעלות מדורגות

ייתכן שלא תוכלו להשלים את השינוי של כל הצמתים ביום אחד, במיוחד אם אתם מפעילים אשכולות Cassandra גדולים, כי צריך לבנות מחדש את המדדים בכל צומת בנפרד. אתם יכולים לשנות את אסטרטגיית הדחיסה של סכימה אחת או של טבלה אחת בכל פעם. לשם כך, צריך לשנות את הטבלה ולשנות את אסטרטגיית הדחיסה שלה, ואז לבנות מחדש את כל האינדקסים בטבלה (אם יש) בכל הצמתים. לאחר מכן חוזרים על התהליך שלמעלה לכל טבלה או מרחב מקשים. אפשר לפרק רצים כאלה בטבלה אחת או במרחב מפתחות אחד, כך שאפשר יהיה להשתמש בהם בימים שונים.

לדוגמה, כדי לשנות את שיטת הדחיסה של הטבלה oauth_20_access_tokens בסכימה kms ל-LeveledCompactionStrategy, אפשר לבצע את הפעולות הבאות:

  1. לשנות את הטבלה כדי לשנות את אסטרטגיית הדחיסה על ידי הרצת ה-CQL הבא:

    ALTER TABLE kms.oauth_20_access_tokens WITH compaction = {'class' : 'LeveledCompactionStrategy'};
  2. בונים מחדש את כל האינדקסים של הטבלה הזו בלבד:

    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   
        

שינוי אסטרטגיית הדחיסה

ככלל, שינוי אסטרטגיית הדחיסה הוא תהליך דו-שלבי:

  1. אתם יכולים לשנות את אסטרטגיית הדחיסה של כל טבלה.
  2. בונים מחדש את כל האינדקסים בכל צומת בנפרד.

כדי לשנות את אסטרטגיית הדחיסה, צריך להריץ פקודת ALTER TABLE בכל טבלה בנפרד. פקודת ALTER TABLE לדוגמה תיראה כך:

# To change to LeveledCompactionStrategy
ALTER TABLE kms.oauth_20_access_tokens WITH compaction = {'class' : 'LeveledCompactionStrategy'};
  
# To change to SizeTieredCompactionStrategy
ALTER 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 שבהמשך רלוונטיים רק אם אתם משתמשים במונטיזציה.

  1. כללי 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'};
    
  2. כללי CQL לשינוי אסטרטגיית הדחיסה למרחב המפתחות: user_settings
    ALTER TABLE user_settings.user_settings WITH compaction = {'class' : 'LeveledCompactionStrategy'};
    
  3. כללי CQL לשינוי אסטרטגיית הדחיסה למרחב המפתחות: keyvaluemap
    ALTER TABLE keyvaluemap.keyvaluemaps_r21 WITH compaction = {'class' : 'LeveledCompactionStrategy'};
    
  4. כללי 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'};
    
  5. כללי 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'};
    
  6. כללי CQL לשינוי אסטרטגיית הדחיסה למרחב המפתחות: cache
    ALTER TABLE cache.cache_entries WITH compaction = {'class' : 'LeveledCompactionStrategy'};
    ALTER TABLE cache.cache_sequence_id_r24 WITH compaction = {'class' : 'LeveledCompactionStrategy'};
    
  7. כללי CQL לשינוי אסטרטגיית הדחיסה למרחב המפתחות: auth
    ALTER TABLE auth.totp WITH compaction = {'class' : 'LeveledCompactionStrategy'};
  8. כללי CQL לשינוי אסטרטגיית הדחיסה למרחב המפתחות: audit
    ALTER TABLE audit.audits WITH compaction = {'class' : 'LeveledCompactionStrategy'};
    ALTER TABLE audit.audits_ref WITH compaction = {'class' : 'LeveledCompactionStrategy'};
    
  9. כללי 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'};
  10. כללי 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'};
  11. כללי CQL לשינוי אסטרטגיית הדחיסה למרחב המפתחות: identityzone
    ALTER TABLE identityzone.IdentityZones WITH compaction = {'class' : 'LeveledCompactionStrategy'};
    ALTER TABLE identityzone.OrgToIdentityZone WITH compaction = {'class' : 'LeveledCompactionStrategy'};
  12. כללי CQL לשינוי אסטרטגיית הדחיסה למרחב המפתחות: dek
    ALTER TABLE dek.keys WITH compaction = {'class' : 'LeveledCompactionStrategy'};
  13. כללי 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'};
  14. [מונטיזציה בלבד] 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'};
  15. [מונטיזציה בלבד] 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'};
  16. [מונטיזציה בלבד] 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 שבהמשך רלוונטיים רק אם אתם משתמשים במונטיזציה.

  1. בנייה מחדש של אינדקסים במרחב המפתחות: 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
    
  2. בנייה מחדש של אינדקסים במרחב המפתחות: 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
    
  3. בנייה מחדש של אינדקסים במרחב המפתחות: cache

    nodetool rebuild_index cache cache_entries cache_entries_cache_name_idx
    
  4. בנייה מחדש של אינדקסים במרחב המפתחות: 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
    
  5. בנייה מחדש של אינדקסים במרחב המפתחות: 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
    
  6. בנייה מחדש של אינדקסים במרחב המפתחות: dek

    nodetool rebuild_index dek keys usecase_index
    
  7. [מונטיזציה בלבד] יצירה מחדש של אינדקסים במרחב המפתחות: 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
    
  8. [מונטיזציה בלבד] יצירה מחדש של אינדקסים במרחב המפתחות: 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
    
  9. [מונטיזציה בלבד] יצירה מחדש של אינדקסים במרחב המפתחות: 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. כדי לוודא שהשינוי של אסטרטגיית הדחיסה בסכימה נכנס לתוקף, פועלים לפי ההוראות בנספח 1.
  2. מוודאים שהדחיסה פועלת בהצלחה ושהנתונים דחוסים אחרי שינוי השיטה:
    1. בכל צומת Cassandra, מריצים את הפקודה הבאה של כלי הצומת כדי לראות אם כל הדחוסים הושלמו ואין שום דבר בהמתנה:
      nodetool compactionstats
    2. אחרי שאומת באמצעות הפקודה שלמעלה, כדי לוודא שאין פעולות דחיסה בהמתנה, צריך לבדוק את חותמת הזמן של השינוי האחרון בקובצי הנתונים (בערך /opt/apigee/data/apigee-cassandra/data/) אחרי חותמת הזמן של מועד ביצוע השינוי של CQL לשיטת הדחיסה.

חזרה למצב קודם

אם צריך לבצע החזרה למצב קודם, אפשר לבחור באחת מהאפשרויות הבאות:

אפשרות 1: ביטול השינוי

מחזירים את אסטרטגיית הדחיסה לאסטרטגיה המקורית שהייתה לכם.

מריצים פקודות דומות של ALTER TABLE בהודעת ה-CQL שהרצתם קודם כדי לשנות את אסטרטגיית הדחיסה.

אם כבר בנית מחדש מדדים כששינית את אסטרטגיית הדחיסה ל-LeveledCompactionStrategy, יהיה עליך לבנות מחדש את האינדקסים שוב. מבצעים את אותם השלבים כמו קודם כדי לבנות מחדש את כל האינדקסים. אם לא בנית מחדש את האינדקסים קודם, אין צורך לבנות מחדש את האינדקסים במהלך החזרה למצב הקודם.

אפשרות 2: שחזור נתונים מלא מהגיבוי

שחזור נתונים מהגיבוי בכל מרחבי המפתחות:

צריך לבצע את ההוראות לשחזור כפי שמתואר במאמר שחזור מהגיבוי.

נספח 1: בדיקת אסטרטגיית הדחיסה

אסטרטגיות הדחיסה מוגדרות ברמת הטבלה ב-Cassandra. אפשר להשתמש בשאילתות הבאות כדי לבדוק את אסטרטגיית הדחיסה לכל טבלה.

אפשר להריץ את ה-CQL לפקודת ה-CQL. כדי להפעיל את הנחיית ה-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 בשאילתות שלמטה תהיה בערך כך:
  • {'class': 'org.apache.cassandra.db.compaction.SizeTieredCompactionStrategy', 'max_threshold': '32', 'min_threshold': '4'}
  • אם שיטת הדחיסה מוגדרת לערך LeveledCompactionStrategy, העמודה compaction בשאילתות שלמטה תהיה בערך כך:
  • {'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';