تغيير استراتيجية ضغط 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 في المستقبل استبدال التغييرات التي أجريتها. ننصحك بالتحقّق من استراتيجية الضغط بعد كل ترقية إذا كنت تستخدم نهجًا غير عادي.

الإعداد

التحقّق من استراتيجية التجميع الحالية

يمكنك التحقّق من استراتيجية التجميع الحالية في الجداول باتّباع التعليمات الواردة في الملحق 1. إذا كانت استراتيجية الضغط هي "LeveledCompactionStrategy" حاليًا، قد يكون ذلك بسبب البدء بتثبيت الإصدار OPDK 4.51 أو إصدار أحدث، أو تغييرها في السابق إلى "LeveledCompactionStrategy" وفقًا لما تنصح به Apigee. إذا كنت تستخدم LeveledCompactionStrategy، تنصحك Apigee بمواصلة استخدام هذه الاستراتيجية وتجنُّب إجراء تغييرات. ومع ذلك، بما أنّك تدير Edge for Private Cloud، توضّح التعليمات التالية كيفية تغيير استراتيجية التجميع إذا أردت ذلك.

الاحتفاظ بنسخة احتياطية

بما أنّ تغيير استراتيجية الضغط يؤدي إلى بدء دورة ضغط كاملة في عُقد Cassandra، قد ينتج عن ذلك بعض أوقات الاستجابة بسبب تحميل الضغطات وحركة بيانات التطبيقات المتزامنة. قد يكون من الضروري التراجع عن هذا التغيير لاستعادة عقد Cassandra من النُسخ الاحتياطية. اطّلِع على كيفية الاحتفاظ بنسخة احتياطية للتعرّف على كيفية الاحتفاظ بنسخة احتياطية من بياناتك قبل تغيير استراتيجية التجميع.

سرعة نقل بيانات الضغط

بعد تغيير استراتيجية التجميع إلى LeveledCompactionStrategy، قد يتم تنفيذ عمليات التجميع لعدة أيام. قد يختلف وقت التشغيل حسب حجم تقليل البيانات. أثناء دورة التجميع ، قد يستخدِم Cassandra المزيد من موارد النظام. لضمان عدم استغراق عملية التجميع الكثير من موارد النظام، ما قد يؤدي إلى إيقاف طلبات وقت تشغيل واجهة برمجة التطبيقات، ننصحك بتحديد حدود لمعدّل نقل البيانات في عملية التجميع.

شغِّل الأمر nodetool التالي على كل عقدة لضبط معدل نقل البيانات في عملية التجميع على الحد الأقصى عند 128 ميغابايت على جميع عقد Cassandra:

nodetool setcompactionthroughput 128

تحديد حجم الأجهزة الافتراضية لعمليات الضغط

يُرجى التأكُّد من توفُّر موارد ذاكرة كافية ووحدة المعالجة المركزية (CPU) في عُقد 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. عملاء محتملون مؤهلون لتغيير استراتيجية ضغط البيانات لمساحات المفاتيح: 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. عملاء محتملون مؤهلون لتغيير استراتيجية ضغط البيانات لمساحات المفاتيح: user_settings 
    ALTER TABLE user_settings.user_settings WITH compaction = {'class' : 'LeveledCompactionStrategy'};
  3. عملاء محتملون مؤهلون لتغيير استراتيجية ضغط البيانات لمساحات المفاتيح: 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. عملاء محتملون مؤهلون لتغيير استراتيجية ضغط البيانات لمساحات المفاتيح: auth 
    ALTER TABLE auth.totp WITH compaction = {'class' : 'LeveledCompactionStrategy'};
  8. عملاء محتملون مؤهلون لتغيير استراتيجية ضغط البيانات لمساحات المفاتيح: 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. عملاء محتملون مؤهلون لتغيير استراتيجية ضغط البيانات لمساحات المفاتيح: 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. عملاء محتملون مؤهلون لتغيير استراتيجية ضغط البيانات لمساحات المفاتيح: identityzone 
    ALTER TABLE identityzone.IdentityZones WITH compaction = {'class' : 'LeveledCompactionStrategy'};
ALTER TABLE identityzone.OrgToIdentityZone WITH compaction = {'class' : 'LeveledCompactionStrategy'};
  12. عملاء محتملون مؤهلون لتغيير استراتيجية ضغط البيانات لمساحات المفاتيح: 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. [تحقيق الربح فقط] العملاء المحتملون بنظر فريق التسويق لتغيير استراتيجية ضغط المساحة الأساسية: 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: التحقّق من استراتيجية التجميع

يتم وضع استراتيجيات الضغط على مستوى الجدول في كاساندرا. يمكنك استخدام الاستعلامات أدناه للتحقق من استراتيجية الضغط لكل جدول.

يمكنك تشغيل CQLs عند طلب 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';