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:
-
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'}; -
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:
- Modifica la estrategia de compactación de cada tabla.
- 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 LeveledCompactionStrategyALTER TABLEkms.oauth_20_access_tokens WITH compaction = {'class' : 'LeveledCompactionStrategy'}; # To change to SizeTieredCompactionStrategyALTER TABLEkms.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.
- CQL para cambiar la estrategia de compactación del espacio de claves:
kmsALTER 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'}; - CQL para cambiar la estrategia de compactación del espacio de claves:
user_settingsALTER TABLE user_settings.user_settings WITH compaction = {'class' : 'LeveledCompactionStrategy'}; - CQL para cambiar la estrategia de compactación del espacio de claves:
keyvaluemapALTER TABLE keyvaluemap.keyvaluemaps_r21 WITH compaction = {'class' : 'LeveledCompactionStrategy'}; - CQL para cambiar la estrategia de compactación del espacio de claves:
devconnectALTER TABLE devconnect.developers WITH compaction = {'class' : 'LeveledCompactionStrategy'}; ALTER TABLE devconnect.companies WITH compaction = {'class' : 'LeveledCompactionStrategy'}; ALTER TABLE devconnect.company_developers WITH compaction = {'class' : 'LeveledCompactionStrategy'}; - CQL para cambiar la estrategia de compactación del espacio de claves:
counterALTER 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'}; - CQL para cambiar la estrategia de compactación del espacio de claves:
cacheALTER TABLE cache.cache_entries WITH compaction = {'class' : 'LeveledCompactionStrategy'}; ALTER TABLE cache.cache_sequence_id_r24 WITH compaction = {'class' : 'LeveledCompactionStrategy'}; - CQL para cambiar la estrategia de compactación del espacio de claves:
authALTER TABLE auth.totp WITH compaction = {'class' : 'LeveledCompactionStrategy'}; - CQL para cambiar la estrategia de compactación del espacio de claves:
auditALTER TABLE audit.audits WITH compaction = {'class' : 'LeveledCompactionStrategy'}; ALTER TABLE audit.audits_ref WITH compaction = {'class' : 'LeveledCompactionStrategy'}; - CQL para cambiar la estrategia de compactación del espacio de claves:
apprepoALTER 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'}; - CQL para cambiar la estrategia de compactación del espacio de claves:
apimodel_v2ALTER 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'}; - CQL para cambiar la estrategia de compactación del espacio de claves:
identityzoneALTER TABLE identityzone.IdentityZones WITH compaction = {'class' : 'LeveledCompactionStrategy'}; ALTER TABLE identityzone.OrgToIdentityZone WITH compaction = {'class' : 'LeveledCompactionStrategy'}; - CQL para cambiar la estrategia de compactación del espacio de claves:
dekALTER TABLE dek.keys WITH compaction = {'class' : 'LeveledCompactionStrategy'}; - CQL para cambiar la estrategia de compactación del espacio de claves:
analyticsALTER 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'}; - [Solo monetización] CQL para cambiar la estrategia de compactación del espacio de claves:
mintALTER 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'}; - [Solo monetización] CQL para cambiar la estrategia de compactación del espacio de claves:
taurusALTER 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'}; - [Solo monetización] CQL para cambiar la estrategia de compactación del espacio de claves:
notificationALTER 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.
-
Vuelve a compilar los índices del espacio de claves:
kmsnodetool 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
-
Vuelve a compilar los índices del espacio de claves:
devconnectnodetool 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
-
Vuelve a compilar los índices del espacio de claves:
cachenodetool rebuild_index cache cache_entries cache_entries_cache_name_idx
-
Vuelve a compilar los índices del espacio de claves:
auditnodetool 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
-
Vuelve a compilar los índices del espacio de claves:
apimodel_v2nodetool 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
-
Vuelve a compilar los índices del espacio de claves:
deknodetool rebuild_index dek keys usecase_index
-
[Solo monetización] Vuelve a compilar los índices del espacio de claves:
mintnodetool 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
-
[Solo monetización] Vuelve a compilar los índices del espacio de claves:
taurusnodetool 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
-
[Solo monetización] Vuelve a compilar los índices del espacio de claves:
notificationnodetool 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
- Para verificar que el cambio en la estrategia de compactación del esquema haya entrado en vigencia, sigue las instrucciones de Apéndice 1.
- Verifica que la compactación se haya ejecutado correctamente y que los datos se hayan compactado después del cambio de estrategia:
- 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
- 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.
- En cada nodo de Cassandra, ejecuta el siguiente comando nodetool para ver si se completaron todas las compactaciones y no hay nada pendiente:
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:
- 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.SizeTieredCompactionStrategy', 'max_threshold': '32', 'min_threshold': '4'}{'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';