تغيير استراتيجية ضغط Cassandra

تستخدم Apigee قاعدة بيانات 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، قد يتم تنفيذ عمليات الضغط لمدة لفترة طويلة. قد تختلف بيئة التشغيل بناءً على حجم ضغط البيانات. أثناء الضغط فقد تستخدم كاساندرا المزيد من موارد النظام. لضمان عدم استهلاك الضغط كثيرًا من موارد النظام، ما قد يؤدي إلى إيقاف طلبات وقت تشغيل واجهة برمجة التطبيقات، ننصح بضبط حدود سرعة نقل البيانات.

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

nodetool setcompactionthroughput 128

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

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