Cambia la estrategia de compactación de Cassandra

Apigee usa la base de datos de Cassandra para almacenar la mayoría de sus datos, incluidos los datos para proxies, cachés y tokens. La compactación es un proceso crítico para reducir el tamaño de los datos almacenados en las bases de datos, 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 el LeveledCompactionStrategy, en lugar del SizeTieredCompactionStrategy predeterminado, para todas las tablas. LeveledCompactionStrategy ofrece un mejor rendimiento y un uso mejorado del disco, compactaciones más eficientes y requiere menos espacio libre en comparación con SizeTieredCompactionStrategy.

Todas las instalaciones nuevas de Apigee 4.52.02 o versiones posteriores configuran automáticamente Cassandra con LeveledCompactionStrategy. Sin embargo, si usas una versión anterior de Apigee o actualizaste a Apigee 4.52.02 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 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 actualizaciones futuras de software de Cassandra reemplacen 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

Verifica la estrategia de compactación existente

Puedes verificar la estrategia de compactación existente en las tablas siguiendo las instrucciones del Apéndice 1. Si la estrategia de compactación ya es LeveledCompactionStrategy, puede deberse a que comenzó con una instalación de OPDK 4.51 o posterior, o a que antes cambió a LeveledCompactionStrategy, según lo recomendado por Apigee. Si ya usas LeveledCompactionStrategy, Apigee recomienda continuar con esta estrategia y evitar los cambios. Sin embargo, dado que tú operas el perímetro de la nube privada, en las siguientes instrucciones se explica 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, es posible que ingrese algunas latencias debido a la carga de compactaciones y el tráfico simultáneo de aplicaciones. Es posible que se requiera una reversión de este cambio para restablecer los nodos de Cassandra a partir de las copias de seguridad. Consulta Cómo crear una copia de seguridad para aprender a crear una copia de seguridad de tus datos antes de cambiar la estrategia de compactación.

Capacidad de procesamiento de compactación

Después de que la estrategia de compactación se cambia a LeveledCompactionStrategy, las compactaciones pueden ejecutarse durante mucho tiempo. El tiempo de ejecución puede variar según el tamaño de la compactación de datos. Durante el ciclo de compactación, Cassandra puede agotar más recursos del sistema. Para garantizar que la compactación no consuma muchos recursos del sistema, lo que podría interrumpir las solicitudes del entorno de ejecución de la API, recomendamos establecer límites para la capacidad de procesamiento de compactación.

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

nodetool setcompactionthroughput 128

Tamaño de las VMs para compactaciones

Asegúrate de que los nodos de Cassandra tengan suficientes recursos de CPU y memoria antes de ejecutar este cambio. Asegúrate de que ningún nodo de Cassandra funcione a más del 25% de la carga de CPU antes de ejecutar este cambio.

Después de un cambio de 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 períodos de poco tráfico.

Carreras escalonadas

Es posible que no puedas completar el cambio de todos los nodos en un día, especialmente 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 de 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 hubiera) en todos los nodos. Luego, repite el procedimiento anterior para cada tabla o espacio de teclas. Estas ejecuciones para una tabla o un espacio de claves se pueden desglosar para ejecutarlas 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. Modificar 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 solo 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

Cambiar la estrategia de compactación

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

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

Para modificar la estrategia de compactación, debes ejecutar un comando ALTER TABLE en cada tabla, uno 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'};

Modificar 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 la instrucción de CQL. Instrucciones para invocar el mensaje de CQL:

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

Se estableció conexión con Apigee en XXXXXXXX:9042.

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

En los siguientes comandos, se explica cómo cambiar la estrategia de compactación a LeveledCompactionStrategy, pero se pueden usar comandos similares para cambiar a otras estrategias de compactación.

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

  1. CQL para cambiar la estrategia de compactación para el 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 para el espacio de claves: user_settings 
    ALTER TABLE user_settings.user_settings WITH compaction = {'class' : 'LeveledCompactionStrategy'};
  3. CQL para cambiar la estrategia de compactación para el espacio de claves: keyvaluemap 
    ALTER TABLE keyvaluemap.keyvaluemaps_r21 WITH compaction = {'class' : 'LeveledCompactionStrategy'};
  4. CQL para cambiar la estrategia de compactación para el 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 para el 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 para el 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 para el espacio de claves: auth 
    ALTER TABLE auth.totp WITH compaction = {'class' : 'LeveledCompactionStrategy'};
  8. CQL para cambiar la estrategia de compactación para el 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 para el 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 para el 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 para el 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 para el espacio de claves: dek 
    ALTER TABLE dek.keys WITH compaction = {'class' : 'LeveledCompactionStrategy'};
  13. CQL para cambiar la estrategia de compactación para el 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'};

Volver a compilar índices

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

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

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

    nodetool rebuild_index cache cache_entries cache_entries_cache_name_idx

  4. Volver 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. Volver 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. Volver 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. Sigue las instrucciones del Apéndice 1 para comprobar si se aplicó el cambio de estrategia de compactación en el esquema.
  2. Verifica que la compactación se haya ejecutado correctamente y que los datos estén compactados 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 si no hay nada pendiente: 
      nodetool compactionstats
    2. Una vez que se verifique con el comando anterior para asegurarte de que no haya compactaciones pendientes, comprueba que la última marca de tiempo modificada de los archivos de datos (en /opt/apigee/data/apigee-cassandra/data/) sea posterior a la marca de tiempo en la que se ejecutó el CQL del 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 el cambio

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

Ejecuta comandos ALTER TABLE similares en el mensaje de CQL que ejecutaste antes para cambiar la estrategia de compactación.

Si ya volviste a compilar los índices mientras cambiaste la estrategia de compactación a LeveledCompactionStrategy, tendrás que volver a compilar los índices. 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 vuelvas a compilarlos durante la reversión.

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

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

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

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

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

Puedes ejecutar CQL en la ventana de CQL. Para invocar el mensaje de CQL, haz lo siguiente:

/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 5.0.1 | Cassandra 3.11.16 | CQL spec 3.4.4 | Native protocol v4]
Use HELP for help.
cqlsh>

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

Cada fila en el 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 será similar a lo siguiente:
    • {'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 será similar a lo siguiente:
    • {'class': 'org.apache.cassandra.db.compaction.LeveledCompactionStrategy'}

Las siguientes consultas se pueden ejecutar para determinar la estrategia de compactación para 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';