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

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

همه نصب‌های جدید Edge for Private Cloud نسخه ۴.۵۲.۰۲ یا جدیدتر به‌طور خودکار Cassandra را با LeveledCompactionStrategy پیکربندی می‌کنند. بااین‌حال، اگر از نسخه قبلی به Edge for Private Cloud 4.54.00 ارتقا داده باشید، نصب شما ممکن است همچنان از Cassandra با SizeTieredCompactionStrategy استفاده کند.

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

آماده‌سازی

پیش‌نیازها

در Edge for Private Cloud نسخه ۴.۵۴.۰۰،‏ Cassandra نسخه 5.x به JDK 17 (جاوا ۱۷) نیاز دارد. قبل‌از اجرای فرمان‌های nodetool یا cqlsh در گره Cassandra، مطمئن شوید که Java 17 به‌عنوان نسخه پیش‌فرض Java پیکربندی شده باشد (برای مثال، با اجرای sudo alternatives --set java JAVA_17_PATH/bin/java یا تنظیم JAVA_HOME روی نصب JDK 17).

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

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

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

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

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

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

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

nodetool setcompactionthroughput 128

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

قبل‌از اجرای این تغییر، مطمئن شوید که گره‌های Cassandra منابع CPU و حافظه کافی دارند و با بار 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 6.2.0 | Cassandra 5.0.8 | CQL spec 3.4.7 | Native protocol v5]
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 6.2.0 | Cassandra 5.0.8 | CQL spec 3.4.7 | Native protocol v5]
Use HELP for help.
cqlsh>

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

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

• اگر استراتژی فشرده‌سازی روی 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';