เปลี่ยนกลยุทธ์การกะทัดรัด Cassandra

Apigee ใช้ฐานข้อมูล Cassandra เพื่อจัดเก็บข้อมูลส่วนใหญ่ ซึ่งรวมถึงข้อมูลสำหรับพร็อกซี แคช และโทเค็น การประมวลผลเป็นกระบวนการสำคัญในการลดขนาดข้อมูลที่จัดเก็บไว้ในฐานข้อมูล ซึ่งจำเป็นต่อการรักษาการทำงานของฐานข้อมูลให้มีประสิทธิภาพ Cassandra รองรับกลยุทธ์ที่หลากหลายในการบีบอัด Apigee แนะนำให้ลูกค้า Edge for Private Cloud ทุกรายใช้งานคลัสเตอร์ Cassandra ด้วย LeveledCompactionStrategy แทนที่จะเป็น SizeTieredCompactionStrategy เริ่มต้นสำหรับทุกตาราง LeveledCompactionStrategy ให้ประสิทธิภาพที่ดีกว่า การใช้งานดิสก์เพิ่มขึ้น การบีบอัดมีประสิทธิภาพมากขึ้น และต้องการพื้นที่ว่างน้อยกว่าเมื่อเทียบกับ SizeTieredCompactionStrategy

การติดตั้ง Apigee 4.52.02 ขึ้นไปทั้งหมดจะกำหนดค่า Cassandra โดยอัตโนมัติด้วย LeveledCompactionStrategy อย่างไรก็ตาม หากคุณใช้ Apigee เวอร์ชันเก่าหรืออัปเกรดเป็น Apigee 4.52.02 จากเวอร์ชันเก่าอยู่ การติดตั้งของคุณก็อาจยังใช้ Cassandra กับ SizeTieredCompactionStrategy อยู่

ถึงแม้เราจะไม่แนะนําให้เปลี่ยนกลยุทธ์การย่อข้อมูลเป็นอย่างอื่นที่ไม่ใช่ LeveledCompactionStrategy แต่เอกสารนี้จะสรุปวิธีทำการเปลี่ยนแปลงหากจำเป็น รวมถึงให้วิธีการตรวจสอบกลยุทธ์การย่อข้อมูลปัจจุบัน การเปลี่ยนกลยุทธ์การย่อขนาดเป็นตัวเลือกที่ไม่แนะนำอาจส่งผลให้การอัปเกรดซอฟต์แวร์ Cassandra ในอนาคตจะเขียนทับการเปลี่ยนแปลงของคุณ เราขอแนะนําให้ตรวจสอบกลยุทธ์การย่อข้อมูลหลังการอัปเกรดทุกครั้งหากใช้วิธีการที่ไม่ใช่แบบมาตรฐาน

การเตรียมพร้อม

ตรวจสอบกลยุทธ์การย่อข้อมูลที่มีอยู่

คุณตรวจสอบกลยุทธ์การย่อข้อมูลที่มีอยู่ในตารางได้โดยทำตามวิธีการใน ภาคผนวก 1 หากกลยุทธ์การบีบอัดคือ LeveledCompactionStrategy อยู่แล้ว อาจเป็นเพราะเริ่มต้นด้วยการติดตั้ง OPDK 4.51 ขึ้นไป หรือได้เปลี่ยนเป็น LeveledCompactionStrategy ตามที่ Apigee แนะนำ หากคุณใช้ LeveledCompactionStrategy อยู่แล้ว Apigee แนะนำให้ใช้กลยุทธ์นี้ต่อไปและหลีกเลี่ยงการเปลี่ยนแปลง อย่างไรก็ตาม เนื่องจาก Edge for Private Cloud เป็นผู้ดําเนินการเอง วิธีการต่อไปนี้จึงอธิบายวิธีเปลี่ยนกลยุทธ์การย่อขนาดหากต้องการ

การสำรองข้อมูล

เนื่องจากการเปลี่ยนกลยุทธ์การกะทัดรัดจะทำให้เกิดรอบการบดอัดอย่างสมบูรณ์ในโหนด Cassandra จึงอาจเกิดความล่าช้าบางส่วนเนื่องจากปริมาณการอัดแน่นและการรับส่งข้อมูลของแอปพลิเคชันแบบพร้อมกัน อาจต้องย้อนกลับการเปลี่ยนแปลงนี้เพื่อกู้คืนโหนด Cassandra จากข้อมูลสำรอง โปรดดูวิธีสำรองข้อมูลเพื่อเรียนรู้วิธีสำรองข้อมูลก่อนเปลี่ยนกลยุทธ์การบีบอัด

อัตราการส่งข้อมูลของการประมวลผล

หลังจากเปลี่ยนกลยุทธ์การย่อเป็น LeveledCompactionStrategy แล้ว การอัดแน่นอาจทำงานเป็นเวลา เป็นเวลานาน รันไทม์อาจแตกต่างกันไปตามขนาดของการบีบอัดข้อมูล ระหว่างการอัด Cassandra อาจใช้ทรัพยากรระบบมากขึ้น เพื่อให้มั่นใจว่าการบดอัดจะไม่กินพื้นที่มาก ทรัพยากรระบบ ซึ่งอาจขัดขวางคำขอรันไทม์ของ API เราขอแนะนำให้ตั้งค่าขีดจำกัดสำหรับ อัตราการส่งข้อมูลของการบีบอัด

เรียกใช้คำสั่ง nodetool ต่อไปนี้ในแต่ละโหนดเพื่อตั้งค่าอัตราการส่งข้อมูลของการบีบอัดเป็นค่าสูงสุด ที่ 128 MB บนโหนด Cassandra ทั้งหมด

nodetool setcompactionthroughput 128

การปรับขนาด VM สำหรับการบีบอัด

ตรวจสอบว่าโหนด Cassandra มีทรัพยากร CPU และหน่วยความจำเพียงพอก่อนดำเนินการเปลี่ยนแปลงนี้ โปรดตรวจสอบว่าไม่มีโหนด Cassandra ที่ทำงานโดยใช้โหลด CPU เกิน 25% ก่อนดำเนินการเปลี่ยนแปลงนี้

หลังจากเปลี่ยนกลยุทธ์การกระชับ ระบบคาดว่าจะทํางานรอบการอัดแน่นอย่างสมบูรณ์ ดังนั้นจึงขอแนะนําให้เปลี่ยนกลยุทธ์การกระชับในช่วงที่มีการเข้าชมต่ำ

การวิ่งแบบเหวี่ยงแห

คุณอาจไม่สามารถเปลี่ยนแปลงโหนดทั้งหมดให้เสร็จสิ้นได้ภายใน 1 วัน โดยเฉพาะหากคุณใช้งานคลัสเตอร์ Cassandra ขนาดใหญ่ เนื่องจากต้องสร้างดัชนีใหม่ในแต่ละโหนดทีละรายการ คุณเปลี่ยนกลยุทธ์การย่อของสคีมา 1 รายการหรือทีละตารางได้ สำหรับกรณีนี้ ให้แก้ไขตารางเพื่อเปลี่ยนกลยุทธ์การบีบอัด แล้วสร้างดัชนีทั้งหมดในตารางอีกครั้ง (หากมี) บนโหนดทั้งหมด จากนั้นทำซ้ำขั้นตอนข้างต้นสำหรับแต่ละตารางหรือคีย์เว้นวรรค การเรียกใช้ดังกล่าวสำหรับ 1 ตารางหรือ 1 Keyspace สามารถแบ่งย่อยเพื่อเรียกใช้ในวันต่างๆ

เช่น หากต้องการเปลี่ยนกลยุทธ์การย่อข้อมูลของตาราง 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   
       

การเปลี่ยนกลยุทธ์การกระชับ

การเปลี่ยนกลยุทธ์การกระชับเป็นกระบวนการที่มี 2 ขั้นตอนในระดับสูง ได้แก่

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 1 โหนดเพื่อเปลี่ยนกลยุทธ์สำหรับแป้นเว้นวรรคทีละรายการ CQL สามารถเรียกใช้ได้ในข้อความแจ้ง CQL วิธีการเรียกใช้ข้อความแจ้ง CQL

/opt/apigee/apigee-cassandra/bin/cqlsh `hostname -i`

เชื่อมต่อกับ Apigee ที่ XXXXXXXX:9042

[cqlsh 5.0.1 | Cassandra 3.11.16 | CQL spec 3.4.4 | Native protocol v4]
Use HELP for help.
cqlsh>

คำสั่งด้านล่างครอบคลุมการเปลี่ยนกลยุทธ์การอัดเป็น LeveledCompactionStrategy แต่คุณใช้คำสั่งที่คล้ายกันเพื่อเปลี่ยนไปใช้กลยุทธ์การย่อขนาดอื่นได้

ขั้นตอนที่ 14 ถึง 16 ด้านล่างจะใช้ได้ก็ต่อเมื่อคุณใช้การสร้างรายได้

1. CQL ที่จะเปลี่ยนกลยุทธ์การบีบอัดสำหรับช่องว่าง: kms

   ALTER TABLE kms.organizations WITH compaction = {'class' : 'LeveledCompactionStrategy'};
   ALTER TABLE kms.maps WITH compaction = {'class' : 'LeveledCompactionStrategy'};
   ALTER TABLE kms.apps WITH compaction = {'class' : 'LeveledCompactionStrategy'};
   ALTER TABLE kms.app_credentials WITH compaction = {'class' : 'LeveledCompactionStrategy'};
   ALTER TABLE kms.api_products WITH compaction = {'class' : 'LeveledCompactionStrategy'};
   ALTER TABLE kms.apiproducts_appslist WITH compaction = {'class' : 'LeveledCompactionStrategy'};
   ALTER TABLE kms.api_resources WITH compaction = {'class' : 'LeveledCompactionStrategy'};
   ALTER TABLE kms.app_end_user WITH compaction = {'class' : 'LeveledCompactionStrategy'};
   ALTER TABLE kms.oauth_20_authorization_codes WITH compaction = {'class' : 'LeveledCompactionStrategy'};
   ALTER TABLE kms.oauth_20_access_tokens WITH compaction = {'class' : 'LeveledCompactionStrategy'};
   ALTER TABLE kms.oauth_10_request_tokens WITH compaction = {'class' : 'LeveledCompactionStrategy'};
   ALTER TABLE kms.oauth_10_access_tokens WITH compaction = {'class' : 'LeveledCompactionStrategy'};
   ALTER TABLE kms.oauth_10_verifiers WITH compaction = {'class' : 'LeveledCompactionStrategy'};
   ALTER TABLE kms.app_enduser_tokens WITH compaction = {'class' : 'LeveledCompactionStrategy'};
   

2. CQL ที่จะเปลี่ยนกลยุทธ์การบีบอัดสำหรับช่องว่าง: user_settings

   ALTER TABLE user_settings.user_settings WITH compaction = {'class' : 'LeveledCompactionStrategy'};
   

3. CQL ที่จะเปลี่ยนกลยุทธ์การบีบอัดสำหรับช่องว่าง: keyvaluemap

   ALTER TABLE keyvaluemap.keyvaluemaps_r21 WITH compaction = {'class' : 'LeveledCompactionStrategy'};
   

4. CQL ที่จะเปลี่ยนกลยุทธ์การบีบอัดสำหรับช่องว่าง: devconnect

   ALTER TABLE devconnect.developers WITH compaction = {'class' : 'LeveledCompactionStrategy'};
   ALTER TABLE devconnect.companies WITH compaction = {'class' : 'LeveledCompactionStrategy'};
   ALTER TABLE devconnect.company_developers WITH compaction = {'class' : 'LeveledCompactionStrategy'};
   

5. CQL ที่จะเปลี่ยนกลยุทธ์การบีบอัดสำหรับช่องว่าง: counter

   ALTER TABLE counter.counters_current_version WITH compaction = {'class' : 'LeveledCompactionStrategy'};
   ALTER TABLE counter.counters_with_expiry WITH compaction = {'class' : 'LeveledCompactionStrategy'};
   ALTER TABLE counter.counters WITH compaction = {'class' : 'LeveledCompactionStrategy'};
   ALTER TABLE counter.key_timestamp_count WITH compaction = {'class' : 'LeveledCompactionStrategy'};
   ALTER TABLE counter.timestamp_key WITH compaction = {'class' : 'LeveledCompactionStrategy'};
   ALTER TABLE counter.period_timestamp WITH compaction = {'class' : 'LeveledCompactionStrategy'};
   ALTER TABLE counter.gateway_quota WITH compaction = {'class' : 'LeveledCompactionStrategy'};
   

6. CQL ที่จะเปลี่ยนกลยุทธ์การบีบอัดสำหรับช่องว่าง: cache

   ALTER TABLE cache.cache_entries WITH compaction = {'class' : 'LeveledCompactionStrategy'};
   ALTER TABLE cache.cache_sequence_id_r24 WITH compaction = {'class' : 'LeveledCompactionStrategy'};
   

7. CQL ที่จะเปลี่ยนกลยุทธ์การบีบอัดสำหรับช่องว่าง: auth

   ALTER TABLE auth.totp WITH compaction = {'class' : 'LeveledCompactionStrategy'};

8. CQL ที่จะเปลี่ยนกลยุทธ์การบีบอัดสำหรับช่องว่าง: audit

   ALTER TABLE audit.audits WITH compaction = {'class' : 'LeveledCompactionStrategy'};
   ALTER TABLE audit.audits_ref WITH compaction = {'class' : 'LeveledCompactionStrategy'};
   

9. CQL ที่จะเปลี่ยนกลยุทธ์การบีบอัดสำหรับช่องว่าง: apprepo

   ALTER TABLE apprepo.organizations WITH compaction = {'class' : 'LeveledCompactionStrategy'};
   ALTER TABLE apprepo.environments WITH compaction = {'class' : 'LeveledCompactionStrategy'};
   ALTER TABLE apprepo.apiproxies WITH compaction = {'class' : 'LeveledCompactionStrategy'};
   ALTER TABLE apprepo.apiproxy_revisions WITH compaction = {'class' : 'LeveledCompactionStrategy'};
   ALTER TABLE apprepo.api_proxy_revisions_r21 WITH compaction = {'class' : 'LeveledCompactionStrategy'};

10. CQL ที่จะเปลี่ยนกลยุทธ์การบีบอัดสำหรับช่องว่าง: apimodel_v2

    ALTER TABLE apimodel_v2.apis WITH compaction = {'class' : 'LeveledCompactionStrategy'};
    ALTER TABLE apimodel_v2.apis_revision WITH compaction = {'class' : 'LeveledCompactionStrategy'};
    ALTER TABLE apimodel_v2.resource WITH compaction = {'class' : 'LeveledCompactionStrategy'};
    ALTER TABLE apimodel_v2.method WITH compaction = {'class' : 'LeveledCompactionStrategy'};
    ALTER TABLE apimodel_v2.revision_counters WITH compaction = {'class' : 'LeveledCompactionStrategy'};
    ALTER TABLE apimodel_v2.template_counters WITH compaction = {'class' : 'LeveledCompactionStrategy'};
    ALTER TABLE apimodel_v2.template WITH compaction = {'class' : 'LeveledCompactionStrategy'};
    ALTER TABLE apimodel_v2.credentials WITH compaction = {'class' : 'LeveledCompactionStrategy'};
    ALTER TABLE apimodel_v2.credentialsv2 WITH compaction = {'class' : 'LeveledCompactionStrategy'};
    ALTER TABLE apimodel_v2.schemas WITH compaction = {'class' : 'LeveledCompactionStrategy'};
    ALTER TABLE apimodel_v2.security WITH compaction = {'class' : 'LeveledCompactionStrategy'};
    ALTER TABLE apimodel_v2.template_auth WITH compaction = {'class' : 'LeveledCompactionStrategy'};

11. CQL ที่จะเปลี่ยนกลยุทธ์การบีบอัดสำหรับช่องว่าง: identityzone

    ALTER TABLE identityzone.IdentityZones WITH compaction = {'class' : 'LeveledCompactionStrategy'};
    ALTER TABLE identityzone.OrgToIdentityZone WITH compaction = {'class' : 'LeveledCompactionStrategy'};

12. CQL ที่จะเปลี่ยนกลยุทธ์การบีบอัดสำหรับช่องว่าง: dek

    ALTER TABLE dek.keys WITH compaction = {'class' : 'LeveledCompactionStrategy'};

13. CQL ที่จะเปลี่ยนกลยุทธ์การบีบอัดสำหรับช่องว่าง: analytics

    ALTER TABLE analytics.custom_aggregates_defn WITH compaction = {'class' : 'LeveledCompactionStrategy'};
    ALTER TABLE analytics.custom_rules_defn WITH compaction = {'class' : 'LeveledCompactionStrategy'};
    ALTER TABLE analytics.custom_aggregates_defn_updates WITH compaction = {'class' : 'LeveledCompactionStrategy'};
    ALTER TABLE analytics.custom_rules_defn_updates WITH compaction = {'class' : 'LeveledCompactionStrategy'};

14. [การสร้างรายได้เท่านั้น] CQL ที่จะเปลี่ยนกลยุทธ์การบีบอัดสำหรับคีย์เว้นวรรค: mint

    ALTER TABLE mint.limits WITH compaction = {'class' : 'LeveledCompactionStrategy'};
    ALTER TABLE mint.suspended_developer_products WITH compaction = {'class' : 'LeveledCompactionStrategy'};
    ALTER TABLE mint.invitations WITH compaction = {'class' : 'LeveledCompactionStrategy'};

15. [การสร้างรายได้เท่านั้น] CQL ที่จะเปลี่ยนกลยุทธ์การบีบอัดสำหรับคีย์เว้นวรรค: taurus

    ALTER TABLE taurus.triggers WITH compaction = {'class' : 'LeveledCompactionStrategy'};
    ALTER TABLE taurus.job_details WITH compaction = {'class' : 'LeveledCompactionStrategy'};
    ALTER TABLE taurus.org_triggers WITH compaction = {'class' : 'LeveledCompactionStrategy'};
    ALTER TABLE taurus.triggers_suite WITH compaction = {'class' : 'LeveledCompactionStrategy'};

16. [การสร้างรายได้เท่านั้น] CQL ที่จะเปลี่ยนกลยุทธ์การบีบอัดสำหรับคีย์เว้นวรรค: notification

    ALTER TABLE notification.notification_service_item WITH compaction = {'class' : 'LeveledCompactionStrategy'};
    ALTER TABLE notification.notification_service_black_list_item WITH compaction = {'class' : 'LeveledCompactionStrategy'};
    ALTER TABLE notification.notification_email_template_item WITH compaction = {'class' : 'LeveledCompactionStrategy'};

สร้างดัชนีใหม่

ต้องดำเนินการขั้นตอนนี้หลังจากมีการเปลี่ยนแปลงกลยุทธ์การกระชับ โปรดเรียกใช้คำสั่ง nodetool ต่อไปนี้ทีละรายการในแต่ละโหนด Cassandra

ขั้นตอนที่ 7 ถึง 9 ด้านล่างจะมีผลในกรณีที่คุณใช้การสร้างรายได้เท่านั้น

1. สร้างดัชนีใหม่สำหรับช่องว่าง: kms

   nodetool rebuild_index kms api_products api_products_organization_name_idx
   nodetool rebuild_index kms app_credentials app_credentials_api_products_idx
   nodetool rebuild_index kms app_credentials app_credentials_organization_app_id_idx
   nodetool rebuild_index kms app_credentials app_credentials_organization_name_idx
   nodetool rebuild_index kms app_end_user app_end_user_app_id_idx
   nodetool rebuild_index kms apps apps_app_family_idx
   nodetool rebuild_index kms apps apps_app_id_idx
   nodetool rebuild_index kms apps apps_app_type_idx
   nodetool rebuild_index kms apps apps_name_idx
   nodetool rebuild_index kms apps apps_organization_name_idx
   nodetool rebuild_index kms apps apps_parent_id_idx
   nodetool rebuild_index kms apps apps_parent_status_idx
   nodetool rebuild_index kms apps apps_status_idx
   nodetool rebuild_index kms maps maps_organization_name_idx
   nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_app_id_idx
   nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_consumer_key_idx
   nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_organization_name_idx
   nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_status_idx
   nodetool rebuild_index kms oauth_10_request_tokens oauth_10_request_tokens_consumer_key_idx
   nodetool rebuild_index kms oauth_10_request_tokens oauth_10_request_tokens_organization_name_idx
   nodetool rebuild_index kms oauth_10_verifiers oauth_10_verifiers_organization_name_idx
   nodetool rebuild_index kms oauth_10_verifiers oauth_10_verifiers_request_token_idx
   nodetool rebuild_index kms oauth_20_access_tokens oauth_20_access_tokens_app_id_idx
   nodetool rebuild_index kms oauth_20_access_tokens oauth_20_access_tokens_client_id_idx
   nodetool rebuild_index kms oauth_20_access_tokens oauth_20_access_tokens_refresh_token_idx
   nodetool rebuild_index kms oauth_20_authorization_codes oauth_20_authorization_codes_client_id_idx
   nodetool rebuild_index kms oauth_20_authorization_codes oauth_20_authorization_codes_organization_name_idx
   

2. สร้างดัชนีใหม่สำหรับช่องว่าง: devconnect

   nodetool rebuild_index devconnect companies companies_name_idx
   nodetool rebuild_index devconnect companies companies_organization_name_idx
   nodetool rebuild_index devconnect companies companies_status_idx
   nodetool rebuild_index devconnect company_developers company_developers_company_name_idx
   nodetool rebuild_index devconnect company_developers company_developers_developer_email_idx
   nodetool rebuild_index devconnect company_developers company_developers_organization_name_idx
   nodetool rebuild_index devconnect developers developers_email_idx
   nodetool rebuild_index devconnect developers developers_organization_name_idx
   nodetool rebuild_index devconnect developers developers_status_idx
   

3. สร้างดัชนีใหม่สำหรับช่องว่าง: cache

   nodetool rebuild_index cache cache_entries cache_entries_cache_name_idx
   

4. สร้างดัชนีใหม่สำหรับช่องว่าง: audit

   nodetool rebuild_index audit audits audits_operation_idx
   nodetool rebuild_index audit audits audits_requesturi_idx
   nodetool rebuild_index audit audits audits_responsecode_idx
   nodetool rebuild_index audit audits audits_timestamp_idx
   nodetool rebuild_index audit audits audits_user_idx
   

5. สร้างดัชนีใหม่สำหรับช่องว่าง: apimodel_v2

   nodetool rebuild_index apimodel_v2 apis a_name
   nodetool rebuild_index apimodel_v2 apis a_org_name
   nodetool rebuild_index apimodel_v2 apis_revision ar_a_active_rev
   nodetool rebuild_index apimodel_v2 apis_revision ar_a_def_index_template
   nodetool rebuild_index apimodel_v2 apis_revision ar_a_def_method_template
   nodetool rebuild_index apimodel_v2 apis_revision ar_a_latest_rev
   nodetool rebuild_index apimodel_v2 apis_revision ar_a_name
   nodetool rebuild_index apimodel_v2 apis_revision ar_a_uuid
   nodetool rebuild_index apimodel_v2 apis_revision ar_base_url
   nodetool rebuild_index apimodel_v2 apis_revision ar_is_active
   nodetool rebuild_index apimodel_v2 apis_revision ar_is_latest
   nodetool rebuild_index apimodel_v2 apis_revision ar_name
   nodetool rebuild_index apimodel_v2 apis_revision ar_org_name
   nodetool rebuild_index apimodel_v2 apis_revision ar_rel_ver
   nodetool rebuild_index apimodel_v2 apis_revision ar_rev_num
   nodetool rebuild_index apimodel_v2 method m_a_name
   nodetool rebuild_index apimodel_v2 method m_api_uuid
   nodetool rebuild_index apimodel_v2 method m_ar_uuid
   nodetool rebuild_index apimodel_v2 method m_base_url
   nodetool rebuild_index apimodel_v2 method m_name
   nodetool rebuild_index apimodel_v2 method m_org_name
   nodetool rebuild_index apimodel_v2 method m_r_name
   nodetool rebuild_index apimodel_v2 method m_r_uuid
   nodetool rebuild_index apimodel_v2 method m_res_path
   nodetool rebuild_index apimodel_v2 method m_rev_num
   nodetool rebuild_index apimodel_v2 resource r_a_name
   nodetool rebuild_index apimodel_v2 resource r_api_uuid
   nodetool rebuild_index apimodel_v2 resource r_ar_uuid
   nodetool rebuild_index apimodel_v2 resource r_base_url
   nodetool rebuild_index apimodel_v2 resource r_name
   nodetool rebuild_index apimodel_v2 resource r_org_name
   nodetool rebuild_index apimodel_v2 resource r_res_path
   nodetool rebuild_index apimodel_v2 resource r_rev_num
   nodetool rebuild_index apimodel_v2 schemas s_api_uuid
   nodetool rebuild_index apimodel_v2 schemas s_ar_uuid
   nodetool rebuild_index apimodel_v2 security sa_api_uuid
   nodetool rebuild_index apimodel_v2 security sa_ar_uuid
   nodetool rebuild_index apimodel_v2 template t_a_name
   nodetool rebuild_index apimodel_v2 template t_a_uuid
   nodetool rebuild_index apimodel_v2 template t_entity
   nodetool rebuild_index apimodel_v2 template t_name
   nodetool rebuild_index apimodel_v2 template t_org_name
   nodetool rebuild_index apimodel_v2 template_auth au_api_uuid
   

6. สร้างดัชนีใหม่สำหรับช่องว่าง: dek

   nodetool rebuild_index dek keys usecase_index
   

7. [การสร้างรายได้เท่านั้น] สร้างดัชนีใหม่สำหรับคีย์สเปซ: mint

   nodetool rebuild_index mint limits limits_created_date_idx
   nodetool rebuild_index mint limits limits_id_idx
   nodetool rebuild_index mint limits limits_org_id_idx
   nodetool rebuild_index mint limits limits_updated_date_idx
   nodetool rebuild_index mint suspended_developer_products suspended_developer_products_created_date_idx
   nodetool rebuild_index mint suspended_developer_products suspended_developer_products_currency_idx
   nodetool rebuild_index mint suspended_developer_products suspended_developer_products_dev_id_idx
   nodetool rebuild_index mint suspended_developer_products suspended_developer_products_id_idx
   nodetool rebuild_index mint suspended_developer_products suspended_developer_products_limit_id_idx
   nodetool rebuild_index mint suspended_developer_products suspended_developer_products_org_id_idx
   nodetool rebuild_index mint suspended_developer_products suspended_developer_products_prod_id_idx
   nodetool rebuild_index mint suspended_developer_products suspended_developer_products_reason_code_idx
   nodetool rebuild_index mint suspended_developer_products suspended_developer_products_sub_org_id_idx
   nodetool rebuild_index mint invitations invitations_company_id_idx
   nodetool rebuild_index mint invitations invitations_created_at_idx
   nodetool rebuild_index mint invitations invitations_developer_id_idx
   nodetool rebuild_index mint invitations invitations_lastmodified_at_idx
   nodetool rebuild_index mint invitations invitations_org_id_idx
   

8. [การสร้างรายได้เท่านั้น] สร้างดัชนีใหม่สำหรับคีย์สเปซ: taurus

   nodetool rebuild_index taurus triggers triggers_env_idx
   nodetool rebuild_index taurus triggers triggers_job_id_idx
   nodetool rebuild_index taurus triggers triggers_org_id_idx
   nodetool rebuild_index taurus job_details job_details_job_class_name_idx
   nodetool rebuild_index taurus job_details job_details_job_group_idx
   nodetool rebuild_index taurus job_details job_details_job_name_idx
   nodetool rebuild_index taurus org_triggers org_triggers_org_id_idx
   nodetool rebuild_index taurus triggers_suite triggers_suite_group_idx
   nodetool rebuild_index taurus triggers_suite triggers_suite_name_idx
   nodetool rebuild_index taurus triggers_suite triggers_suite_suite_id_idx
   

9. [การสร้างรายได้เท่านั้น] สร้างดัชนีใหม่สำหรับคีย์สเปซ: notification

   nodetool rebuild_index notification notification_service_item notification_service_item_org_id_idx
   nodetool rebuild_index notification notification_service_item notification_service_item_status_idx
   nodetool rebuild_index notification notification_service_black_list_item notification_service_black_list_item_org_id_idx
   nodetool rebuild_index notification notification_service_black_list_item notification_service_black_list_item_to_email_idx
   nodetool rebuild_index notification notification_email_template_item notification_email_template_item_name_idx
   nodetool rebuild_index notification notification_email_template_item notification_email_template_item_org_id_idx
   

การยืนยัน

1. ตรวจสอบว่าการเปลี่ยนแปลงกลยุทธ์การบีบอัดในสคีมามีผลแล้วโดยทําตามวิธีการในภาคผนวก 1
2. ยืนยันว่าการบีบอัดทำงานสำเร็จและบีบอัดข้อมูลหลังจากเปลี่ยนกลยุทธ์
   1. ในแต่ละโหนด Cassandra ให้เรียกใช้คำสั่ง Nodetool ต่อไปนี้เพื่อดูว่าการบีบอัดทั้งหมดเสร็จสมบูรณ์และไม่มีสิ่งใดรอดำเนินการอยู่

      nodetool compactionstats

   2. เมื่อตรวจสอบโดยใช้คำสั่งข้างต้นแล้ว ให้ตรวจสอบว่าไม่มีการบีบอัดที่รอดำเนินการอยู่ ให้ตรวจสอบการประทับเวลาที่แก้ไขล่าสุดของไฟล์ข้อมูล (ต่ำกว่า /opt/apigee/data/apigee-cassandra/data/) ว่าอยู่หลังการประทับเวลาเมื่อมีการดำเนินการ CQL ของการเปลี่ยนกลยุทธ์การย่อขนาด

ย้อนกลับ

ในกรณีที่จำเป็นต้องดำเนินการย้อนกลับ ให้เลือกตัวเลือกใดตัวเลือกหนึ่งด้านล่าง

ตัวเลือกที่ 1: เปลี่ยนกลับการเปลี่ยนแปลง

เปลี่ยนกลยุทธ์การย่อกลับไปเป็นกลยุทธ์เดิมที่มีอยู่

เรียกใช้คำสั่ง ALTER TABLE ที่คล้ายกันในพรอมต์ CQL ที่คุณเรียกใช้ก่อนหน้านี้เพื่อเปลี่ยนกลยุทธ์การบีบอัด

หากสร้างดัชนีอีกครั้งแล้วขณะเปลี่ยนกลยุทธ์การย่อเป็น LeveledCompactionStrategy คุณจะต้องสร้างดัชนีอีกครั้ง ทำตามขั้นตอนเดียวกับก่อนหน้านี้ในการสร้างดัชนีทั้งหมดใหม่ หากคุณไม่ได้สร้างดัชนีใหม่ก่อนหน้านี้ คุณไม่จำเป็นต้องสร้างดัชนีใหม่ในระหว่างการย้อนกลับ

ตัวเลือกที่ 2: คืนค่าข้อมูลทั้งหมดจากข้อมูลสำรอง

กู้คืนข้อมูลจากข้อมูลสำรองสำหรับคีย์สเปซทั้งหมด:

โปรดทำตามวิธีการกู้คืนตามที่อธิบายไว้ในกู้คืนจากข้อมูลสำรอง

ภาคผนวก 1: ตรวจสอบกลยุทธ์การกระชับ

กลยุทธ์การบดอัดตั้งอยู่ที่ระดับตารางใน Cassandra คุณใช้การค้นหาด้านล่างเพื่อตรวจสอบกลยุทธ์การย่อข้อมูลของแต่ละตารางได้

คุณสามารถเรียกใช้ CQL ที่พรอมต์ CQL วิธีเรียกใช้ข้อความแจ้ง CQL

/opt/apigee/apigee-cassandra/bin/cqlsh `hostname -i`

คุณจะเห็นการตอบกลับดังตัวอย่างต่อไปนี้

Connected to apigee at XX.XX.XX.XX:9042.
[cqlsh 5.0.1 | Cassandra 3.11.16 | CQL spec 3.4.4 | Native protocol v4]
Use HELP for help.
cqlsh>

คุณจะระบุกลยุทธ์การย่อข้อมูลในปัจจุบันได้ดังนี้

แต่ละแถวในเอาต์พุตเกี่ยวข้องกับตารางภายในคีย์สเปซ สำหรับแต่ละแถว คอลัมน์การกะทัดรัดจะระบุกลยุทธ์การย่อข้อมูลที่ตารางใช้

• หากตั้งค่ากลยุทธ์การกะทัดรัดเป็น 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';