Cassandra-Verdichtungsstrategie ändern

Apigee verwendet die Cassandra-Datenbank zum Speichern der meisten Daten, einschließlich Daten für Proxys, Caches und Tokens. Die Datenkomprimierung ist ein wichtiger Prozess zur Verringerung der Größe der in Datenbanken gespeicherten Daten. Sie ist für die effiziente Ausführung von Datenbankabläufen unerlässlich. Cassandra unterstützt verschiedene Verdichtungsstrategien. Apigee empfiehlt allen Edge for Private Cloud-Kunden, ihre Cassandra-Cluster für alle Tabellen mit der LeveledCompactionStrategy anstelle der Standardeinstellung SizeTieredCompactionStrategy auszuführen. LeveledCompactionStrategy bietet eine bessere Leistung, eine verbesserte Laufwerknutzung, eine effizientere Komprimierung und benötigt im Vergleich zu SizeTieredCompactionStrategy weniger freien Speicherplatz.

Bei allen neuen Installationen von Apigee 4.52.02 oder höher wird Cassandra automatisch mit LeveledCompactionStrategy konfiguriert. Wenn Sie jedoch eine ältere Version von Apigee verwenden oder von einer älteren Version auf Apigee 4.53.00 umgestellt haben, wird in Ihrer Installation möglicherweise weiterhin Cassandra mit SizeTieredCompactionStrategy verwendet.

Es wird nicht empfohlen, die Komprimierungsstrategie in einen anderen Wert als LeveledCompactionStrategy zu ändern. In diesem Dokument wird jedoch beschrieben, wie Sie die Änderung bei Bedarf vornehmen und Ihre aktuelle Komprimierungsstrategie prüfen. Wenn Sie die Komprimierungsstrategie in eine nicht empfohlene Option ändern, werden Ihre Änderungen bei zukünftigen Cassandra-Software-Upgrades möglicherweise überschrieben. Wenn Sie einen nicht standardmäßigen Ansatz verwenden, sollten Sie Ihre Verdichtungsstrategie nach jedem Upgrade überprüfen.

Vorbereitung

Vorhandene Verdichtungsstrategie prüfen

Sie können die vorhandene Komprimierungsstrategie für Tabellen mithilfe der Anleitung in Anhang 1 prüfen. Wenn die Komprimierungsstrategie bereits LeveledCompactionStrategy ist, kann das daran liegen, dass Sie mit einer Installation von OPDK 4.51 oder höher begonnen haben oder die Strategie zuvor gemäß der Empfehlung von Apigee auf LeveledCompactionStrategy umgestellt haben. Wenn Sie LeveledCompactionStrategy bereits verwenden, empfiehlt Apigee, diese Strategie beizubehalten und keine Änderungen vorzunehmen. Da Edge for Private Cloud jedoch von Ihnen betrieben wird, können Sie in der folgenden Anleitung die Verdichtungsstrategie bei Bedarf ändern.

Sicherung

Da durch die Änderung der Komprimierungsstrategie ein vollständiger Komprimierungszyklus in Cassandra-Knoten ausgelöst wird, kann es aufgrund der Komprimierungslast und des gleichzeitigen Anwendungstraffics zu einigen Verzögerungen kommen. Möglicherweise ist ein Rollback dieser Änderung erforderlich, um Cassandra-Knoten aus Sicherungen wiederherzustellen. Unter Informationen zum Sichern erfahren Sie, wie Sie Ihre Daten sichern, bevor Sie die Verdichtungsstrategie ändern.

Verdichtungsdurchsatz

Nachdem die Verdichtungsstrategie in LeveledCompactionStrategy geändert wurde, können Verdichtungen noch lange gedauert. Je nach Größe der Datenverdichtung kann die Laufzeit variieren. Während der Verdichtung verbraucht Cassandra möglicherweise mehr Systemressourcen. Damit die Komprimierung nicht zu viele Systemressourcen beansprucht, was die API-Laufzeitanfragen beeinträchtigen könnte, empfehlen wir, Limits für den Komprimierungsdurchsatz festzulegen.

Führen Sie den folgenden nodetool-Befehl auf jedem der Knoten aus, um den Komprimierungsdurchsatz auf allen Cassandra-Knoten auf 128 MB zu maximieren:

nodetool setcompactionthroughput 128

Größe von VMs für Komprimierungen festlegen

Achten Sie darauf, dass die Cassandra-Knoten über ausreichende CPU- und Arbeitsspeicherressourcen verfügen, bevor Sie diese Änderung vornehmen. Achten Sie darauf, dass bei keinem Cassandra-Knoten mehr als 25 % der CPU-Auslastung erreicht werden, bevor Sie diese Änderung vornehmen.

Nach einer Änderung der Komprimierungsstrategie wird voraussichtlich ein vollständiger Komprimierungszyklus ausgeführt. Daher wird empfohlen, die Komprimierungsstrategie in Zeiten mit wenig Traffic zu ändern.

Gestaffelte Ausführungen

Sie können möglicherweise nicht alle Knoten innerhalb eines Tages ändern, insbesondere wenn Sie große Cassandra-Cluster betreiben, da die Indizes auf jedem Knoten einzeln neu erstellt werden müssen. Sie können die Komprimierungsstrategie für ein Schema oder eine Tabelle auf einmal ändern. Ändern Sie dazu die Verdichtungsstrategie der Tabelle und erstellen Sie dann alle Indizes in der Tabelle (falls vorhanden) auf allen Knoten neu. Wiederholen Sie dann den obigen Vorgang für jede Tabelle oder jeden Schlüsselbereich. Solche Ausführungen für eine Tabelle oder einen Schlüsselbereich können so aufgeschlüsselt werden, dass sie über verschiedene Tage hinweg ausgeführt werden.

Wenn Sie beispielsweise die Komprimierungsstrategie der Tabelle oauth_20_access_tokens im Schema kms in LeveledCompactionStrategy ändern möchten, gehen Sie so vor:

  1. Führen Sie die folgende CQL-Anweisung aus, um die Komprimierungsstrategie zu ändern:

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

  2. Erstellen Sie alle Indizes nur dieser Tabelle neu:

    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

Komprimierungsstrategie ändern

Die Änderung der Komprimierungsstrategie erfolgt in zwei Schritten:

  1. Ändern Sie die Komprimierungsstrategie jeder Tabelle.
  2. Erstellen Sie alle Indexe auf jedem Knoten einzeln neu.

Wenn Sie die Komprimierungsstrategie ändern möchten, müssen Sie den Befehl ALTER TABLE für jede Tabelle einzeln ausführen. Hier ein Beispiel für einen ALTER TABLE-Befehl:

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

Tabelle ändern, um eine neue Komprimierungsstrategie festzulegen

Führen Sie die folgenden CQLs auf einem beliebigen Cassandra-Knoten aus, um die Strategie für jeweils einen Schlüsselraum zu ändern. CQLs können über die CQL-Eingabeaufforderung ausgeführt werden. Anleitung zum Aufrufen der CQL-Eingabeaufforderung:

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

Um XXXXXXXX:9042 mit Apigee verbunden.

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

Mit den folgenden Befehlen wird die Änderung der Verdichtungsstrategie in LeveledCompactionStrategy beschrieben. Es können aber auch ähnliche Befehle für den Wechsel zu anderen Verdichtungsstrategien verwendet werden.

Die Schritte 14 bis 16 unten gelten nur, wenn Sie die Monetarisierung verwenden.

  1. CQLs zum Ändern der Verdichtungsstrategie für den Schlüsselraum: 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. CQLs zum Ändern der Komprimierungsstrategie für den Schlüsselbereich: user_settings 
    ALTER TABLE user_settings.user_settings WITH compaction = {'class' : 'LeveledCompactionStrategy'};
  3. CQLs zum Ändern der Verdichtungsstrategie für den Schlüsselraum: keyvaluemap 
    ALTER TABLE keyvaluemap.keyvaluemaps_r21 WITH compaction = {'class' : 'LeveledCompactionStrategy'};
  4. CQLs zum Ändern der Verdichtungsstrategie für den Schlüsselraum: 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. CQLs zum Ändern der Verdichtungsstrategie für den Schlüsselraum: 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. CQLs zum Ändern der Komprimierungsstrategie für den Schlüsselbereich: cache 
    ALTER TABLE cache.cache_entries WITH compaction = {'class' : 'LeveledCompactionStrategy'};
ALTER TABLE cache.cache_sequence_id_r24 WITH compaction = {'class' : 'LeveledCompactionStrategy'};
  7. CQLs zum Ändern der Verdichtungsstrategie für den Schlüsselraum: auth 
    ALTER TABLE auth.totp WITH compaction = {'class' : 'LeveledCompactionStrategy'};
  8. CQLs zum Ändern der Komprimierungsstrategie für den Schlüsselbereich: audit 
    ALTER TABLE audit.audits WITH compaction = {'class' : 'LeveledCompactionStrategy'};
ALTER TABLE audit.audits_ref WITH compaction = {'class' : 'LeveledCompactionStrategy'};
  9. CQLs zum Ändern der Verdichtungsstrategie für den Schlüsselraum: 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. CQLs zum Ändern der Komprimierungsstrategie für den Schlüsselbereich: 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. CQLs zum Ändern der Verdichtungsstrategie für den Schlüsselraum: identityzone 
    ALTER TABLE identityzone.IdentityZones WITH compaction = {'class' : 'LeveledCompactionStrategy'};
ALTER TABLE identityzone.OrgToIdentityZone WITH compaction = {'class' : 'LeveledCompactionStrategy'};
  12. CQLs zum Ändern der Komprimierungsstrategie für den Schlüsselbereich: dek 
    ALTER TABLE dek.keys WITH compaction = {'class' : 'LeveledCompactionStrategy'};
  13. CQLs zum Ändern der Verdichtungsstrategie für den Schlüsselraum: 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. [Nur Monetarisierung] CQLs zur Änderung der Verdichtungsstrategie für den Schlüsselbereich: 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. [Nur Monetarisierung] CQLs zum Ändern der Komprimierungsstrategie für den Schlüsselbereich: 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. [Nur Monetarisierung] CQLs zum Ändern der Komprimierungsstrategie für den Schlüsselbereich: 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'};

Indizes neu erstellen

Dieser Schritt muss nach jeder Änderung der Verdichtungsstrategie ausgeführt werden. Führen Sie die folgenden nodetool-Befehle nacheinander auf jedem Cassandra-Knoten aus.

Die Schritte 7 bis 9 unten gelten nur, wenn du die Monetarisierung nutzt.

  1. Indices für den Schlüsselbereich neu erstellen: 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. Indexe für Schlüsselraum neu erstellen: 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. Indices für den Schlüsselbereich neu erstellen: cache

    nodetool rebuild_index cache cache_entries cache_entries_cache_name_idx

  4. Indices für den Schlüsselbereich neu erstellen: 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. Indexe für Schlüsselraum neu erstellen: 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. Indices für den Schlüsselbereich neu erstellen: dek

    nodetool rebuild_index dek keys usecase_index

  7. [Nur Monetarisierung] Indices für den Schlüsselbereich neu erstellen: 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. [Nur Monetarisierung] Indices für den Schlüsselbereich neu erstellen: 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. [Nur Monetarisierung] Indexe für Schlüsselraum neu erstellen: 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

Überprüfung

  1. Prüfen Sie, ob die Änderung der Komprimierungsstrategie für das Schema wirksam geworden ist. Folgen Sie dazu der Anleitung in Anhang 1.
  2. Überprüfen Sie, ob die Verdichtung erfolgreich ausgeführt wurde und die Daten nach der Strategieänderung komprimiert wurden:
    1. Führen Sie auf jedem Cassandra-Knoten den folgenden nodetool-Befehl aus, um zu prüfen, ob alle Komprimierungen abgeschlossen sind und keine ausstehend sind: 
      nodetool compactionstats
    2. Nachdem Sie mit dem Befehl oben überprüft haben, dass keine Komprimierungen ausstehend sind, prüfen Sie, ob der Zeitstempel der letzten Änderung der Datendateien (unter /opt/apigee/data/apigee-cassandra/data/) nach dem Zeitstempel liegt, zu dem die CQL-Änderung der Komprimierungsstrategie ausgeführt wurde.

Rollback

Wenn Sie ein Rollback ausführen möchten, haben Sie folgende Möglichkeiten:

Option 1: Änderung rückgängig machen

Führen Sie ein Rollback der Komprimierungsstrategie auf die ursprüngliche Strategie aus.

Führen Sie ähnliche ALTER TABLE-Befehle für den CQL-Prompt aus, den Sie zuvor ausgeführt haben, um die Komprimierungsstrategie zu ändern.

Wenn Sie bereits die Indizes neu erstellt haben, während Sie die Verdichtungsstrategie in LeveledCompactionStrategy geändert haben, müssen Sie die Indizes noch einmal neu erstellen. Führen Sie dieselben Schritte wie zuvor für die Neuerstellung aller Indexe aus. Wenn Sie die Indexe zuvor nicht neu erstellt haben, müssen Sie die Indexe während des Rollbacks nicht neu erstellen.

Option 2: Vollständige Datenwiederherstellung aus einer Sicherung

Daten aus der Sicherung für alle Schlüsselräume wiederherstellen:

Folgen Sie der Anleitung zur Wiederherstellung, wie unter Aus einer Sicherung wiederherstellen beschrieben.

Anhang 1: Komprimierungsstrategie prüfen

Verdichtungsstrategien werden in Cassandra auf Tabellenebene festgelegt. Mit den folgenden Abfragen können Sie die Verdichtungsstrategie für die einzelnen Tabellen prüfen.

Sie können CQLs in der CQL-Eingabeaufforderung ausführen. So rufen Sie die CQL-Eingabeaufforderung auf:

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

Die Antwort sieht in etwa so aus:

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>

Die aktuelle Verdichtungsstrategie kann so festgelegt werden:

Jede Zeile in der Ausgabe bezieht sich auf eine Tabelle in einem Schlüsselbereich. Für jede Zeile gibt die Spalte compaction die von der Tabelle verwendete Verdichtungsstrategie an.

  • Wenn die Komprimierungsstrategie auf „SizeTieredCompactionStrategy“ festgelegt ist, sieht die Spalte compaction in den folgenden Abfragen in etwa so aus:
    • {'class': 'org.apache.cassandra.db.compaction.SizeTieredCompactionStrategy', 'max_threshold': '32', 'min_threshold': '4'}
  • Wenn die Verdichtungsstrategie auf LeveledCompactionStrategy festgelegt ist, sieht die Spalte compaction in den folgenden Abfragen in etwa so aus:
    • {'class': 'org.apache.cassandra.db.compaction.LeveledCompactionStrategy'}

Die folgenden Abfragen können ausgeführt werden, um die Verdichtungsstrategie für jede Tabelle in einem bestimmten Schlüsselbereich zu bestimmen:

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