تغییر راهبرد فشرده‌سازی Cassandra

‫Apigee از پایگاه داده Cassandra برای ذخیره کردن بیشتر داده‌هایش، ازجمله داده‌های مربوط به پراکسی‌ها، حافظه‌های نهان، و نشان‌ها استفاده می‌کند. فشرده‌سازی فرایندی حیاتی برای کاهش اندازه داده‌های ذخیره‌شده در پایگاه‌های داده است که برای حفظ عملیات کارآمد پایگاه داده ضروری است. ‫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 در آینده تغییرات شما را ملغی کند. اگر از روش غیرمعمولی استفاده می‌کنید، توصیه می‌کنیم پس‌از هر ارتقا، استراتژی فشرده‌سازی خود را تأیید کنید.

آماده‌سازی

استراتژی فشرده‌سازی موجود را بررسی کنید

با دنبال کردن دستورالعمل‌های پیوست ۱ می‌توانید استراتژی فشرده‌سازی موجود در جدول‌ها را بررسی کنید. اگر استراتژی فشرده‌سازی ازقبل LeveledCompactionStrategy باشد، ممکن است به‌دلیل شروع با نصب OPDK 4.51 یا جدیدتر، یا تغییر قبلی به LeveledCompactionStrategy طبق توصیه Apigee باشد. اگر ازقبل از LeveledCompactionStrategy استفاده می‌کنید، Apigee توصیه می‌کند که به این استراتژی ادامه دهید و از تغییر آن خودداری کنید. بااین‌حال، ازآنجایی‌که Edge for Private Cloud توسط شما اداره می‌شود، دستورالعمل‌های زیر نحوه تغییر دادن استراتژی فشرده‌سازی را درصورت تمایل توضیح می‌دهد.

پشتیبان‌گیری

ازآنجایی‌که تغییر راهبرد فشرده‌سازی باعث راه‌اندازی چرخه فشرده‌سازی کامل در گره‌های Cassandra می‌شود، ممکن است به‌دلیل بار فشرده‌سازی‌ها و ترافیک هم‌زمان برنامه، تأخیرهایی ایجاد شود. برای بازیابی گره‌های Cassandra از پشتیبان‌گیری‌ها، ممکن است لازم باشد این تغییر را برگردانید. برای آشنایی با نحوه پشتیبان‌گیری از داده‌ها قبل‌از تغییر استراتژی فشرده‌سازی، به نحوه پشتیبان‌گیری مراجعه کنید.

توان گذرداد فشرده‌سازی

پس‌از تغییر استراتژی فشرده‌سازی به LeveledCompactionStrategy، فشرده‌سازی‌ها ممکن است زمان زیادی طول بکشند. بسته به اندازه فشرده‌سازی داده‌ها، زمان اجرا ممکن است متفاوت باشد. درطول چرخه فشرده‌سازی، Cassandra ممکن است از منابع سیستم بیشتری استفاده کند. برای اطمینان از اینکه فشرده‌سازی مقدار زیادی از منابع سیستم را مصرف نمی‌کند، که ممکن است درخواست‌های زمان اجرای API را مختل کند، توصیه می‌کنیم محدودیت‌هایی برای توان عملیاتی فشرده‌سازی تنظیم کنید.

فرمان nodetool زیر را در هریک از گره‌ها اجرا کنید تا توان عملیاتی تراکم را در همه گره‌های Cassandra به حداکثر مقدار ۱۲۸ مگابایت برسانید:

nodetool setcompactionthroughput 128

اندازه‌گیری ماشین‌های مجازی برای فشرده‌سازی

قبل‌از اجرای این تغییر، مطمئن شوید گره‌های Cassandra منابع CPU و حافظه کافی دارند. لطفاً قبل‌از اجرای این تغییر، مطمئن شوید که هیچ‌یک از گره‌های Cassandra با بیش‌از ۲۵٪ بار 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 را پوشش می‌دهد، اما از فرمان‌های مشابهی می‌توان برای تغییر به استراتژی‌های فشرده‌سازی دیگر استفاده کرد.

مراحل ۱۴ تا ۱۶ در زیر فقط درصورتی قابل‌اجرا هستند که از درآمدزایی استفاده کنید.

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 اجرا کنید.

مراحل ۷ تا ۹ در زیر فقط درصورتی قابل‌اجرا هستند که از درآمدزایی استفاده کنید.

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. با دنبال کردن دستورالعمل‌های پیوست ۱، بررسی کنید که تغییر استراتژی فشرده‌سازی در طرحواره اعمال شده باشد.
2. تأیید کنید که «فشرده‌سازی» باموفقیت اجرا شده است و داده‌ها پس‌از تغییر استراتژی فشرده شده‌اند:
   1. در هر گره Cassandra، فرمان nodetool زیر را اجرا کنید تا ببینید آیا همه فشرده‌سازی‌ها تکمیل شده‌اند و چیزی معلقه نیست:

      nodetool compactionstats

   2. پس‌از درستی‌سنجی بااستفاده از دستور بالا برای اطمینان از اینکه هیچ فشرده‌سازی معلقی وجود ندارد، مُهر زمان آخرین تغییر فایل‌های داده (در /opt/apigee/data/apigee-cassandra/data/) را بررسی کنید تا بعداز مُهر زمان اجرای تغییر استراتژی فشرده‌سازی CQL باشد.

عقب‌گرد

درصورتی‌که نیاز به انجام برگرداندن داشته باشید، می‌توانید یکی از گزینه‌های زیر را انتخاب کنید:

گزینه ۱: برگرداندن تغییر

استراتژی فشرده‌سازی را به استراتژی اصلی‌تان برگردانید.

دستورات مشابه ALTER TABLE را در پیام‌واره CQL که قبلاً اجرا کرده‌اید اجرا کنید تا استراتژی فشرده‌سازی را تغییر دهید.

اگر قبلاً هنگام تغییر استراتژی فشرده‌سازی به LeveledCompactionStrategy نمایه‌ها را بازسازی کرده‌اید، باید نمایه‌ها را دوباره بازسازی کنید. برای بازسازی همه نمایه‌ها، همان مراحل قبلی را دنبال کنید. اگر قبلاً شاخص‌ها را بازسازی نکرده‌اید، نیازی نیست که شاخص‌ها را درطول برگرداندن بازسازی کنید.

گزینه ۲: بازیابی کامل داده‌ها از نسخه پشتیبان

بازیابی داده‌ها از نسخه پشتیبان برای همه فضاهای کلید:

لطفاً دستورالعمل‌های بازیابی را که در بازیابی از نسخه پشتیبان مستند شده است دنبال کنید.

پیوست ۱: بررسی استراتژی فشرده‌سازی

استراتژی‌های فشرده‌سازی در سطح جدول در 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>

می‌توانید استراتژی فشرده‌سازی فعلی را به این صورت تعیین کنید:

هر ردیف در برونداد مربوط به جدولی در فضای کلید است. برای هر ردیف، ستون فشرده‌سازی نشان‌دهنده استراتژی فشرده‌سازی استفاده‌شده توسط جدول است.

• اگر استراتژی فشرده‌سازی روی SizeTieredCompactionStrategy تنظیم شده باشد، ستون فشرده‌سازی در پُرسمان‌های زیر چیزی شبیه به این خواهد بود:

{'class': 'org.apache.cassandra.db.compaction.SizeTieredCompactionStrategy', 'max_threshold': '32', 'min_threshold': '4'}

• اگر استراتژی فشرده‌سازی روی LeveledCompactionStrategy تنظیم شده باشد، ستون فشرده‌سازی در پُرسمان‌های زیر چیزی شبیه به این خواهد بود:

{'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';