เปลี่ยนกลยุทธ์การกะทัดรัด 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 สำหรับ Private Cloud วิธีการต่อไปนี้จึงอธิบายวิธีเปลี่ยนกลยุทธ์การบีบอัดหากต้องการ

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

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

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

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

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

nodetool setcompactionthroughput 128

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

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

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

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

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

ตัวอย่างเช่น หากต้องการเปลี่ยนกลยุทธ์การบีบอัดของตาราง oauth_20_access_tokens ในสคีมา kms เป็น LeveledCompactionStrategy ให้ทําดังนี้

  1. Alter table เพื่อเปลี่ยนกลยุทธ์การบีบอัดโดยเรียกใช้ 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 คอลัมน์ 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';