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

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

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

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

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

ข้อกำหนดเบื้องต้น

ใน Edge for Private Cloud 4.54.00, Cassandra 5.x ต้องใช้ JDK 17 (Java 17) ก่อนที่จะเรียกใช้คำสั่ง nodetool หรือ cqlsh ในโหนด Cassandra ให้ตรวจสอบว่าได้กำหนดค่า Java 17 เป็นเวอร์ชัน Java เริ่มต้นแล้ว (เช่น โดยการเรียกใช้ sudo alternatives --set java JAVA_17_PATH/bin/java หรือตั้งค่า JAVA_HOME เป็นการติดตั้ง JDK 17)

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

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

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

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

อัตราการส่งข้อมูลของการบดอัด

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

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

nodetool setcompactionthroughput 128

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

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

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

การเรียกใช้แบบเหลื่อมเวลา

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

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

Connected to Apigee at XXXXXXXX:9042.

[cqlsh 6.2.0 | Cassandra 5.0.8 | CQL spec 3.4.7 | Native protocol v5]
Use HELP for help.
cqlsh>

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

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

  1. CQL เพื่อเปลี่ยนกลยุทธ์การบดอัดสำหรับ Keyspace: 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 เพื่อเปลี่ยนกลยุทธ์การบดอัดสำหรับ Keyspace: user_settings 
    ALTER TABLE user_settings.user_settings WITH compaction = {'class' : 'LeveledCompactionStrategy'};
  3. CQL เพื่อเปลี่ยนกลยุทธ์การบดอัดสำหรับ Keyspace: keyvaluemap 
    ALTER TABLE keyvaluemap.keyvaluemaps_r21 WITH compaction = {'class' : 'LeveledCompactionStrategy'};
  4. CQL เพื่อเปลี่ยนกลยุทธ์การบดอัดสำหรับ Keyspace: 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 เพื่อเปลี่ยนกลยุทธ์การบดอัดสำหรับ Keyspace: 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 เพื่อเปลี่ยนกลยุทธ์การบดอัดสำหรับ Keyspace: cache 
    ALTER TABLE cache.cache_entries WITH compaction = {'class' : 'LeveledCompactionStrategy'};
ALTER TABLE cache.cache_sequence_id_r24 WITH compaction = {'class' : 'LeveledCompactionStrategy'};
  7. CQL เพื่อเปลี่ยนกลยุทธ์การบดอัดสำหรับ Keyspace: auth 
    ALTER TABLE auth.totp WITH compaction = {'class' : 'LeveledCompactionStrategy'};
  8. CQL เพื่อเปลี่ยนกลยุทธ์การบดอัดสำหรับ Keyspace: audit 
    ALTER TABLE audit.audits WITH compaction = {'class' : 'LeveledCompactionStrategy'};
ALTER TABLE audit.audits_ref WITH compaction = {'class' : 'LeveledCompactionStrategy'};
  9. CQL เพื่อเปลี่ยนกลยุทธ์การบดอัดสำหรับ Keyspace: 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 เพื่อเปลี่ยนกลยุทธ์การบดอัดสำหรับ Keyspace: 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 เพื่อเปลี่ยนกลยุทธ์การบดอัดสำหรับ Keyspace: identityzone 
    ALTER TABLE identityzone.IdentityZones WITH compaction = {'class' : 'LeveledCompactionStrategy'};
ALTER TABLE identityzone.OrgToIdentityZone WITH compaction = {'class' : 'LeveledCompactionStrategy'};
  12. CQL เพื่อเปลี่ยนกลยุทธ์การบดอัดสำหรับ Keyspace: dek 
    ALTER TABLE dek.keys WITH compaction = {'class' : 'LeveledCompactionStrategy'};
  13. CQL เพื่อเปลี่ยนกลยุทธ์การบดอัดสำหรับ Keyspace: 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 เพื่อเปลี่ยนกลยุทธ์การบดอัดสำหรับ Keyspace: 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 เพื่อเปลี่ยนกลยุทธ์การบดอัดสำหรับ Keyspace: 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 เพื่อเปลี่ยนกลยุทธ์การบดอัดสำหรับ Keyspace: 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. สร้างดัชนีสำหรับ Keyspace: 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. สร้างดัชนีสำหรับ Keyspace: 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. สร้างดัชนีสำหรับ Keyspace: cache ใหม่

    nodetool rebuild_index cache cache_entries cache_entries_cache_name_idx

  4. สร้างดัชนีสำหรับ Keyspace: 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. สร้างดัชนีสำหรับ Keyspace: 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. สร้างดัชนีสำหรับ Keyspace: dek ใหม่

    nodetool rebuild_index dek keys usecase_index

  7. [การสร้างรายได้เท่านั้น] สร้างดัชนีสำหรับ Keyspace: 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. [การสร้างรายได้เท่านั้น] สร้างดัชนีสำหรับ Keyspace: 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. [การสร้างรายได้เท่านั้น] สร้างดัชนีสำหรับ Keyspace: 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: กู้คืนข้อมูลทั้งหมดจากข้อมูลสำรอง

กู้คืนข้อมูลจากข้อมูลสำรองสำหรับ Keyspace ทั้งหมด โดยทำดังนี้

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

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

คุณตั้งค่ากลยุทธ์การบดอัดได้ที่ระดับตารางใน 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>

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

แต่ละแถวในเอาต์พุตเกี่ยวข้องกับตารางภายใน Keyspace สำหรับแต่ละแถว คอลัมน์ 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'}

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

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