Cambia la estrategia de compactación de Cassandra

Apigee usa la base de datos de Cassandra para almacenar la mayor parte de sus datos, incluidos los datos de proxies, memorias caché y tokens. La compactación es un proceso fundamental para reducir el tamaño de los datos almacenados en las bases de datos, lo que es esencial para mantener operaciones eficientes de la base de datos. Cassandra admite varias estrategias de compactación. Apigee recomienda que todos los clientes de Edge para la nube privada operen sus clústeres de Cassandra con LeveledCompactionStrategy, en lugar de SizeTieredCompactionStrategy predeterminada, para todas las tablas. LeveledCompactionStrategy ofrece un mejor rendimiento, un uso mejorado del disco, compactaciones más eficientes y requiere menos espacio libre en comparación con SizeTieredCompactionStrategy.

Todas las instalaciones nuevas de Edge para nube privada 4.52.02 o versiones posteriores configuran automáticamente Cassandra con LeveledCompactionStrategy. Sin embargo, si actualizaste a Edge para nube privada 4.54.00 desde una versión anterior, es posible que tu instalación aún use Cassandra con SizeTieredCompactionStrategy.

Aunque no se recomienda cambiar la estrategia de compactación a ninguna otra que no sea LeveledCompactionStrategy, en este documento, se describe cómo realizar el cambio si es necesario y se proporcionan instrucciones para verificar tu estrategia de compactación actual. Si cambias la estrategia de compactación a una opción no recomendada, es posible que las futuras actualizaciones de software de Cassandra anulen tus cambios. Te recomendamos que verifiques tu estrategia de compactación después de cada actualización si usas un enfoque no estándar.

Preparación

Requisitos previos

En Edge para nube privada 4.54.00, Cassandra 5.x requiere JDK 17 (Java 17). Antes de ejecutar comandos nodetool o cqlsh en un nodo de Cassandra, asegúrate de que Java 17 esté configurado como la versión predeterminada de Java (por ejemplo, ejecutando sudo alternatives --set java JAVA_17_PATH/bin/java o configurando JAVA_HOME en tu instalación de JDK 17).

Verifica la estrategia de compactación existente

Para verificar la estrategia de compactación existente en las tablas, sigue las instrucciones del Apéndice 1. Si la estrategia de compactación ya es LeveledCompactionStrategy, es posible que se deba a que comenzaste con una instalación de Edge para nube privada 4.51 o versiones posteriores, o que hayas cambiado anteriormente a LeveledCompactionStrategy según lo recomendado por Apigee. Si ya usas LeveledCompactionStrategy, Apigee recomienda continuar con esta estrategia y evitar los cambios. Sin embargo, como tú operas Edge para la nube privada, las siguientes instrucciones explican cómo cambiar la estrategia de compactación si lo deseas.

Copia de seguridad

Dado que cambiar la estrategia de compactación activa un ciclo de compactación completo en los nodos de Cassandra, podría introducir algunas latencias debido a la carga de las compactaciones y el tráfico simultáneo de la aplicación. Para revertir este cambio, no es necesario restablecer desde una copia de seguridad. Puedes revertir la estrategia de compactación directamente como se describe en Opción 1: Revertir cambio. Sin embargo, como precaución, consulta Cómo crear una copia de seguridad para crear una copia de seguridad de tus datos antes de cambiar la estrategia de compactación.

Capacidad de procesamiento de la compactación

Después de que la estrategia de compactación se cambia a LeveledCompactionStrategy, las compactaciones pueden ejecutarse durante un tiempo prolongado. Según el tamaño de la compactación de datos, el tiempo de ejecución puede variar. Durante el ciclo de compactación, Cassandra puede usar más recursos del sistema. Para asegurarte de que la compactación no ocupe muchos recursos del sistema, lo que podría interrumpir las solicitudes del entorno de ejecución de la API, te recomendamos que establezcas límites para la capacidad de procesamiento de la compactación.

Ejecuta el siguiente comando nodetool en cada uno de los nodos para establecer la capacidad de procesamiento de la compactación en un máximo de 128 MB en todos los nodos de Cassandra:

nodetool setcompactionthroughput 128

Dimensionamiento de VMs para compactaciones

Antes de ejecutar este cambio, asegúrate de que los nodos de Cassandra tengan suficientes recursos de CPU y memoria, y que no operen con más del 25% de carga de CPU.

Después de un cambio en la estrategia de compactación, se espera que se ejecute un ciclo de compactación completo, por lo que se recomienda cambiar la estrategia de compactación durante los períodos de poco tráfico.

Ejecuciones escalonadas

Es posible que no puedas completar el cambio de todos los nodos en un día, en especial si operas clústeres grandes de Cassandra, ya que los índices deben volver a compilarse en cada nodo uno por uno. Puedes cambiar la estrategia de compactación de un esquema o una tabla a la vez. Para ello, modifica la tabla para cambiar su estrategia de compactación y, luego, vuelve a compilar todos los índices de la tabla (si los hay) en todos los nodos. Luego, repite el procedimiento anterior para cada tabla o espacio de claves. Estas ejecuciones para una tabla o un espacio de claves se pueden desglosar para ejecutarse en diferentes días.

Por ejemplo, para cambiar la estrategia de compactación de la tabla oauth_20_access_tokens en el esquema kms a LeveledCompactionStrategy, puedes hacer lo siguiente:

  1. Modifica la tabla para cambiar la estrategia de compactación ejecutando el siguiente CQL:

    ALTER TABLE kms.oauth_20_access_tokens WITH compaction = {'class' : 'LeveledCompactionStrategy'};
  2. Vuelve a compilar todos los índices de esta tabla:

    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   
        

Cambia la estrategia de compactación

En términos generales, cambiar la estrategia de compactación es un proceso de dos pasos:

  1. Modifica la estrategia de compactación de cada tabla.
  2. Vuelve a compilar todos los índices en cada nodo uno por uno.

Para modificar la estrategia de compactación, debes ejecutar un comando ALTER TABLE en cada tabla una a la vez. Un comando ALTER TABLE de muestra se vería de la siguiente manera:

# 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 la tabla para establecer una nueva estrategia de compactación

Ejecuta los siguientes CQL en cualquier nodo de Cassandra para cambiar la estrategia de un espacio de claves a la vez. Los CQL se pueden ejecutar en el símbolo del sistema de CQL. Instrucciones para invocar el símbolo del sistema de CQL:

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

Te conectaste a Apigee en XXXXXXXX:9042.

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

Los siguientes comandos abarcan el cambio de la estrategia de compactación a LeveledCompactionStrategy, pero se pueden usar comandos similares para cambiar a otras estrategias de compactación.

Los pasos 14 a 16 que se indican a continuación solo se aplican si usas la monetización.

  1. CQL para cambiar la estrategia de compactación del espacio de claves: 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 para cambiar la estrategia de compactación del espacio de claves: user_settings
    ALTER TABLE user_settings.user_settings WITH compaction = {'class' : 'LeveledCompactionStrategy'};
    
  3. CQL para cambiar la estrategia de compactación del espacio de claves: keyvaluemap
    ALTER TABLE keyvaluemap.keyvaluemaps_r21 WITH compaction = {'class' : 'LeveledCompactionStrategy'};
    
  4. CQL para cambiar la estrategia de compactación del espacio de claves: 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 para cambiar la estrategia de compactación del espacio de claves: 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 para cambiar la estrategia de compactación del espacio de claves: cache
    ALTER TABLE cache.cache_entries WITH compaction = {'class' : 'LeveledCompactionStrategy'};
    ALTER TABLE cache.cache_sequence_id_r24 WITH compaction = {'class' : 'LeveledCompactionStrategy'};
    
  7. CQL para cambiar la estrategia de compactación del espacio de claves: auth
    ALTER TABLE auth.totp WITH compaction = {'class' : 'LeveledCompactionStrategy'};
  8. CQL para cambiar la estrategia de compactación del espacio de claves: audit
    ALTER TABLE audit.audits WITH compaction = {'class' : 'LeveledCompactionStrategy'};
    ALTER TABLE audit.audits_ref WITH compaction = {'class' : 'LeveledCompactionStrategy'};
    
  9. CQL para cambiar la estrategia de compactación del espacio de claves: 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 para cambiar la estrategia de compactación del espacio de claves: 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 para cambiar la estrategia de compactación del espacio de claves: identityzone
    ALTER TABLE identityzone.IdentityZones WITH compaction = {'class' : 'LeveledCompactionStrategy'};
    ALTER TABLE identityzone.OrgToIdentityZone WITH compaction = {'class' : 'LeveledCompactionStrategy'};
  12. CQL para cambiar la estrategia de compactación del espacio de claves: dek
    ALTER TABLE dek.keys WITH compaction = {'class' : 'LeveledCompactionStrategy'};
  13. CQL para cambiar la estrategia de compactación del espacio de claves: 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 monetización] CQL para cambiar la estrategia de compactación del espacio de claves: 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 monetización] CQL para cambiar la estrategia de compactación del espacio de claves: 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 monetización] CQL para cambiar la estrategia de compactación del espacio de claves: 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'};

Vuelve a compilar los índices

Este paso debe ejecutarse después de cualquier cambio en la estrategia de compactación. Ejecuta los siguientes nodetool comandos uno por uno en cada nodo de Cassandra.

Los pasos 7 a 9 que se indican a continuación solo se aplican si usas la monetización.

  1. Vuelve a compilar los índices del espacio de claves: 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. Vuelve a compilar los índices del espacio de claves: 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. Vuelve a compilar los índices del espacio de claves: cache

    nodetool rebuild_index cache cache_entries cache_entries_cache_name_idx
    
  4. Vuelve a compilar los índices del espacio de claves: 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. Vuelve a compilar los índices del espacio de claves: 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. Vuelve a compilar los índices del espacio de claves: dek

    nodetool rebuild_index dek keys usecase_index
    
  7. [Solo monetización] Vuelve a compilar los índices del espacio de claves: 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 monetización] Vuelve a compilar los índices del espacio de claves: 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 monetización] Vuelve a compilar los índices del espacio de claves: 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
    

Verificación

  1. Para verificar que el cambio en la estrategia de compactación del esquema haya entrado en vigencia, sigue las instrucciones de Apéndice 1.
  2. Verifica que la compactación se haya ejecutado correctamente y que los datos se hayan compactado después del cambio de estrategia:
    1. En cada nodo de Cassandra, ejecuta el siguiente comando nodetool para ver si se completaron todas las compactaciones y no hay nada pendiente:
      nodetool compactionstats
    2. Una vez que se verifique con el comando anterior para asegurarse de que no haya compactaciones pendientes, verifica la marca de tiempo de la última modificación de los archivos de datos (en /opt/apigee/data/apigee-cassandra/data/) para que sea posterior a la marca de tiempo cuando se ejecutó el CQL de cambio de estrategia de compactación.

Revertir

En caso de que necesites realizar una reversión, puedes elegir una de las siguientes opciones:

Opción 1: Revertir cambio

Revierte la estrategia de compactación a la que tenías originalmente.

Ejecuta comandos ALTER TABLE similares en el símbolo del sistema de CQL que ejecutaste antes para cambiar la estrategia de compactación.

Si ya volviste a compilar los índices mientras cambiabas la estrategia de compactación a LeveledCompactionStrategy, deberás volver a compilarlos. Sigue los mismos pasos que antes para volver a compilar todos los índices. Si no volviste a compilar los índices antes, no es necesario que lo hagas durante la reversión.

Opción 2: Restablecimiento completo de datos desde la copia de seguridad

Restablece los datos de la copia de seguridad para todos los espacios de claves:

Sigue las instrucciones para restablecer como se documenta en Restablece desde una copia de seguridad.

Apéndice 1: Verifica la estrategia de compactación

Las estrategias de compactación se establecen a nivel de la tabla en Cassandra. Puedes usar las siguientes consultas para verificar la estrategia de compactación de cada tabla.

Puedes ejecutar CQL en el símbolo del sistema de CQL. Para invocar el símbolo del sistema de CQL:

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

Verás una respuesta como la siguiente:

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>

Puedes determinar la estrategia de compactación actual de la siguiente manera:

Cada fila del resultado pertenece a una tabla dentro de un espacio de claves. Para cada fila, la columna compaction indica la estrategia de compactación que usa la tabla.

  • Si la estrategia de compactación se establece en SizeTieredCompactionStrategy, la columna compaction en las siguientes consultas se verá de la siguiente manera:
  • {'class': 'org.apache.cassandra.db.compaction.SizeTieredCompactionStrategy', 'max_threshold': '32', 'min_threshold': '4'}
  • Si la estrategia de compactación se establece en LeveledCompactionStrategy, la columna compaction en las siguientes consultas se verá de la siguiente manera:
  • {'class': 'org.apache.cassandra.db.compaction.LeveledCompactionStrategy'}

Se pueden ejecutar las siguientes consultas para determinar la estrategia de compactación de cada tabla en un espacio de claves en particular:

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