Cambiare la strategia di compattazione di Cassandra

Apigee utilizza il database Cassandra per archiviare la maggior parte dei dati, compresi quelli per proxy, cache e token. La compattazione è un processo fondamentale per ridurre le dimensioni dei dati archiviati nei database ed è essenziale per mantenere efficienti le operazioni sui database. Cassandra supporta varie strategie di compattazione. Apigee consiglia a tutti i clienti Edge per il cloud privato di gestire i propri cluster Cassandra con LeveledCompactionStrategy, anziché con il valore SizeTieredCompactionStrategy predefinito, per tutte le tabelle. LeveledCompactionStrategy offre prestazioni migliori, utilizzo migliore del disco, compattazioni più efficienti e richiede meno spazio libero rispetto a SizeTieredCompactionStrategy.

Tutte le nuove installazioni di Apigee 4.52.02 o versioni successive configurano automaticamente Cassandra con LeveledCompactionStrategy. Tuttavia, se utilizzi una versione precedente di Apigee o hai eseguito l'upgrade ad Apigee 4.52.02 da una versione precedente, la tua installazione potrebbe comunque utilizzare Cassandra con SizeTieredCompactionStrategy.

Sebbene non sia consigliabile impostare una strategia di compattazione diversa da LeveledCompactionStrategy, questo documento descrive come apportare le modifiche necessarie e fornisce istruzioni per controllare la strategia di compattazione attuale. La modifica della strategia di compattazione in un'opzione non consigliata potrebbe comportare la sovrascrittura delle modifiche da parte dei futuri upgrade del software Cassandra. Se utilizzi un approccio non standard, ti consigliamo di verificare la tua strategia di compattazione dopo ogni upgrade.

Preparazione

Controllare la strategia di compattazione esistente

È possibile verificare la strategia di compattazione esistente nelle tabelle seguendo le istruzioni nell' Appendice 1. Se la strategia di compattazione è già LeveledCompactionStrategy, ciò potrebbe essere dovuto all'inizio con un'installazione di OPDK 4.51 o versioni successive o all'aver precedentemente modificato LeveledCompactionStrategy come consigliato da Apigee. Se usi già LeveledCompactionStrategy, Apigee consiglia di continuare con questa strategia ed evitare modifiche. Tuttavia, poiché Edge per il cloud privato è gestito da te, le seguenti istruzioni spiegano come modificare la strategia di compattazione, se necessario.

Backup

Poiché la modifica della strategia di compattazione attiva un ciclo di compattazione completo nei nodi Cassandra, potrebbe introdurre alcune latenze a causa del carico di compattazioni e del traffico delle applicazioni simultanee. Per ripristinare i nodi Cassandra dai backup potrebbe essere necessario un rollback di questa modifica. Per informazioni su come eseguire il backup dei dati prima di modificare la strategia di compattazione, consulta Come eseguire il backup.

Velocità effettiva di compattazione

Dopo che la strategia di compattazione è cambiata in LeveledCompactionStrategy, le compattazioni possono essere eseguite per molto tempo. A seconda delle dimensioni della compattazione dei dati, il runtime può variare. Durante la compattazione ciclo, Cassandra potrebbe utilizzare più risorse di sistema. Per garantire che la compattazione non occupi molto di risorse di sistema, il che potrebbe interrompere le richieste di runtime API, consigliamo di impostare limiti per di compattazione.

Esegui questo comando nodetool su ciascuno dei nodi per impostare la velocità effettiva di compattazione al massimo di 128 MB su tutti i nodi Cassandra:

nodetool setcompactionthroughput 128

Dimensionamento delle VM per le compattazioni

Assicurati che i nodi Cassandra abbiano risorse di CPU e memoria sufficienti prima di eseguire questa modifica. Prima di eseguire questa modifica, assicurati che nessun nodo Cassandra stia operando a più del 25% del carico della CPU.

Dopo aver modificato una strategia di compattazione, è previsto l'esecuzione di un ciclo di compattazione completo, pertanto è consigliabile cambiare la strategia di compattazione durante i periodi di traffico ridotto.

Corse sfalsate

Potresti non essere in grado di completare la modifica di tutti i nodi entro un giorno, soprattutto se gestisci cluster Cassandra di grandi dimensioni, poiché gli indici devono essere ricreati su ciascun nodo uno alla volta. Puoi modificare la strategia di compattazione di uno schema o di una tabella alla volta. Per farlo, modifica la tabella per cambiare la strategia di compattazione e poi ricrea tutti gli indici della tabella (se presenti) su tutti i nodi. quindi ripeti la procedura precedente per ogni tabella o spazio delle chiavi. Queste esecuzioni per una tabella o uno spazio delle chiavi possono essere suddivise per essere eseguite in giorni diversi.

Ad esempio, per modificare in LeveledCompactionStrategy la strategia di compattazione della tabella oauth_20_access_tokens nello schema kms:

  1. Modifica la tabella per cambiare la strategia di compattazione eseguendo il seguente CQL:

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

  2. Ricrea tutti gli indici solo di questa tabella:

    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

Modifica della strategia di compattazione

A livello generale, la modifica della strategia di compattazione è un processo in due fasi:

  1. Modifica la strategia di compattazione di ogni tabella.
  2. Ricrea tutti gli indici su ciascun nodo uno alla volta.

Per modificare la strategia di compattazione, devi eseguire un comando ALTER TABLE su ogni tabella uno alla volta. Di seguito è riportato un comando ALTER TABLE di esempio:

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

Modifica tabella per impostare una nuova strategia di compattazione

Esegui i seguenti CQL su qualsiasi nodo Cassandra per modificare la strategia per uno spazio delle chiavi alla volta. I CQL possono essere eseguiti nel prompt CQL. Istruzioni per richiamare il prompt CQL:

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

Connessione ad Apigee al numero XXXXXXXX:9042.

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

I comandi riportati di seguito descrivono la modifica della strategia di compattazione in LeveledCompactionStrategy, ma è possibile utilizzare comandi simili per passare ad altre strategie di compattazione.

I passaggi da 14 a 16 riportati di seguito sono applicabili solo se utilizzi la monetizzazione.

  1. CQL per cambiare la strategia di compattazione per lo spazio delle chiavi: 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 per cambiare la strategia di compattazione per lo spazio delle chiavi: user_settings 
    ALTER TABLE user_settings.user_settings WITH compaction = {'class' : 'LeveledCompactionStrategy'};
  3. CQL per cambiare la strategia di compattazione per lo spazio delle chiavi: keyvaluemap 
    ALTER TABLE keyvaluemap.keyvaluemaps_r21 WITH compaction = {'class' : 'LeveledCompactionStrategy'};
  4. CQL per cambiare la strategia di compattazione per lo spazio delle chiavi: 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 per cambiare la strategia di compattazione per lo spazio delle chiavi: 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 per cambiare la strategia di compattazione per lo spazio delle chiavi: cache 
    ALTER TABLE cache.cache_entries WITH compaction = {'class' : 'LeveledCompactionStrategy'};
ALTER TABLE cache.cache_sequence_id_r24 WITH compaction = {'class' : 'LeveledCompactionStrategy'};
  7. CQL per cambiare la strategia di compattazione per lo spazio delle chiavi: auth 
    ALTER TABLE auth.totp WITH compaction = {'class' : 'LeveledCompactionStrategy'};
  8. CQL per cambiare la strategia di compattazione per lo spazio delle chiavi: audit 
    ALTER TABLE audit.audits WITH compaction = {'class' : 'LeveledCompactionStrategy'};
ALTER TABLE audit.audits_ref WITH compaction = {'class' : 'LeveledCompactionStrategy'};
  9. CQL per cambiare la strategia di compattazione per lo spazio delle chiavi: 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 per cambiare la strategia di compattazione per lo spazio delle chiavi: 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 per cambiare la strategia di compattazione per lo spazio delle chiavi: identityzone 
    ALTER TABLE identityzone.IdentityZones WITH compaction = {'class' : 'LeveledCompactionStrategy'};
ALTER TABLE identityzone.OrgToIdentityZone WITH compaction = {'class' : 'LeveledCompactionStrategy'};
  12. CQL per cambiare la strategia di compattazione per lo spazio delle chiavi: dek 
    ALTER TABLE dek.keys WITH compaction = {'class' : 'LeveledCompactionStrategy'};
  13. CQL per cambiare la strategia di compattazione per lo spazio delle chiavi: 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. [Solo monetizzazione] CQL per cambiare la strategia di compattazione per lo spazio delle chiavi: 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. [Solo monetizzazione] CQL per cambiare la strategia di compattazione per lo spazio delle chiavi: 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. [Solo monetizzazione] CQL per cambiare la strategia di compattazione per lo spazio delle chiavi: 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'};

Ricrea gli indici

Questo passaggio deve essere eseguito dopo qualsiasi modifica alla strategia di compattazione. Esegui i seguenti comandi nodetool uno alla volta su ciascun nodo Cassandra.

I passaggi da 7 a 9 riportati di seguito sono applicabili solo se utilizzi la monetizzazione.

  1. Ricrea gli indici per lo spazio delle chiavi: 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. Ricrea gli indici per lo spazio delle chiavi: 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. Ricrea gli indici per lo spazio delle chiavi: cache

    nodetool rebuild_index cache cache_entries cache_entries_cache_name_idx

  4. Ricrea gli indici per lo spazio delle chiavi: 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. Ricrea gli indici per lo spazio delle chiavi: 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. Ricrea gli indici per lo spazio delle chiavi: dek

    nodetool rebuild_index dek keys usecase_index

  7. [Solo monetizzazione] Ricrea gli indici per lo spazio delle chiavi: 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. [Solo monetizzazione] Ricrea gli indici per lo spazio delle chiavi: 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. [Solo monetizzazione] Ricrea gli indici per lo spazio delle chiavi: 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

Verifica

  1. Verifica che la modifica della strategia di compattazione nello schema sia stata applicata seguendo le istruzioni riportate nell'Appendice 1.
  2. Verifica che la compattazione sia stata eseguita correttamente e che i dati siano compattati dopo la modifica della strategia:
    1. Su ciascun nodo Cassandra, esegui il seguente comando nodetool per verificare che tutte le compattazioni siano state completate e che nulla sia in sospeso: 
      nodetool compactionstats
    2. Dopo la verifica utilizzando il comando riportato sopra per assicurarti che non ci siano compattazioni in sospeso, controlla il timestamp dell'ultima modifica dei file di dati (inferiore a /opt/apigee/data/apigee-cassandra/data/) in modo che sia successivo al timestamp dell'esecuzione del CQL della modifica della strategia di compattazione.

Esegui il rollback

Se devi eseguire un rollback, puoi scegliere una delle opzioni seguenti:

Opzione 1: ripristina la modifica

Esegui il rollback della strategia di compattazione alla strategia che avevi in origine.

Esegui comandi ALTER TABLE simili sul prompt CQL che hai eseguito in precedenza per modificare la strategia di compattazione.

Se hai già ricostruito gli indici durante il passaggio della strategia di compattazione a LeveledCompactionStrategy, dovrai ricreare gli indici. Segui gli stessi passaggi descritti in precedenza per ricostruire tutti gli indici. Se non hai ricreato gli indici in precedenza, non è necessario ricreare gli indici durante il rollback.

Opzione 2: ripristino completo dei dati dal backup

Ripristina i dati dal backup per tutti gli spazi delle chiavi:

Segui le istruzioni per il ripristino come documentato in Ripristinare da un backup.

Appendice 1: Controllo della strategia di compattazione

Le strategie di compattazione sono impostate a livello di tabella in Cassandra. Puoi utilizzare le query riportate di seguito per verificare la strategia di compattazione per ogni tabella.

Puoi eseguire CQL al prompt CQL. Per richiamare il prompt CQL:

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

Visualizzerai una risposta simile alla seguente:

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>

È possibile determinare l'attuale strategia di compattazione come segue:

Ogni riga nell'output riguarda una tabella all'interno di uno spazio delle chiavi. Per ogni riga, la colonna compaction indica la strategia di compattazione utilizzata dalla tabella.

  • Se la strategia di compattazione è impostata su SizeTieredCompactionStrategy, la colonna compaction nelle query seguenti sarà simile a questa:
    • {'class': 'org.apache.cassandra.db.compaction.SizeTieredCompactionStrategy', 'max_threshold': '32', 'min_threshold': '4'}
  • Se la strategia di compattazione è impostata su LeveledCompactionStrategy, la colonna compaction nelle query seguenti sarà simile a questa:
    • {'class': 'org.apache.cassandra.db.compaction.LeveledCompactionStrategy'}

È possibile eseguire le query seguenti per determinare la strategia di compattazione per ciascuna tabella in uno spazio delle chiavi specifico:

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