Modifier la stratégie de compactage de Cassandra

Apigee utilise la base de données Cassandra pour stocker la plupart de ses données, y compris les données des proxys, des caches et des jetons. Le compactage est un processus essentiel pour réduire la taille des données stockées dans les bases de données, essentiel pour assurer l'efficacité des opérations de base de données. Cassandra prend en charge différentes stratégies de compactage. Apigee recommande à tous les clients Edge for Private Cloud d'exploiter leurs clusters Cassandra avec le LeveledCompactionStrategy, plutôt que le SizeTieredCompactionStrategy par défaut, pour toutes les tables. LeveledCompactionStrategy offre de meilleures performances, une meilleure utilisation du disque, des compactages plus efficaces et nécessite moins d'espace libre par rapport à SizeTieredCompactionStrategy.

Toutes les nouvelles installations d'Apigee 4.52.02 ou d'une version ultérieure configurent automatiquement Cassandra avec LeveledCompactionStrategy. Toutefois, si vous utilisez une ancienne version d'Apigee ou si vous êtes passé à la version 4.52.02 d'Apigee, votre installation peut toujours utiliser Cassandra avec SizeTieredCompactionStrategy.

Bien qu'il ne soit pas recommandé de remplacer la stratégie de compactage par une autre stratégie que LeveledCompactionStrategy, ce document explique comment effectuer la modification si nécessaire et fournit des instructions pour vérifier votre stratégie de compactage actuelle. Changer la stratégie de compactage sur une option non recommandée peut entraîner l'écrasement de vos modifications par les futures mises à niveau du logiciel Cassandra. Si vous utilisez une approche non standard, nous vous recommandons de vérifier votre stratégie de compactage après chaque mise à niveau.

Préparation

Vérifier la stratégie de compactage existante

Vous pouvez vérifier la stratégie de compactage existante sur les tables en suivant les instructions de l' Annexe 1. Si la stratégie de compactage est déjà LeveledCompactionStrategy, cela peut être dû au début d'une installation d'OPDK 4.51 ou version ultérieure, ou au passage à LeveledCompactionStrategy conformément aux recommandations d'Apigee. Si vous utilisez déjà LeveledCompactionStrategy, Apigee vous recommande de poursuivre cette stratégie et d'éviter les modifications. Cependant, comme Edge for Private Cloud est exploité par vous, les instructions suivantes expliquent comment modifier la stratégie de compactage si vous le souhaitez.

Sauvegarde

Étant donné que la modification de la stratégie de compactage déclenche un cycle de compactage complet dans les nœuds Cassandra, elle peut introduire des latences dues à la charge des compactages et au trafic applicatif simultané. Un rollback de cette modification peut être nécessaire pour restaurer des nœuds Cassandra à partir de sauvegardes. Consultez Comment sauvegarder pour savoir comment sauvegarder vos données avant de modifier la stratégie de compactage.

Débit de compactage

Une fois que la stratégie de compactage est passée à LeveledCompactionStrategy, les compactages peuvent durer longtemps. La durée d'exécution peut varier en fonction de la taille du compactage des données. Au cours du cycle de compactage, Cassandra peut utiliser davantage de ressources système. Pour vous assurer que le compactage n'utilise pas beaucoup de ressources système, ce qui pourrait perturber les requêtes d'exécution de l'API, nous vous recommandons de définir des limites pour le débit de compactage.

Exécutez la commande nodetool suivante sur chacun des nœuds pour définir le débit de compactage au maximum de 128 Mo sur tous les nœuds Cassandra:

nodetool setcompactionthroughput 128

Dimensionner des VM pour le compactage

Avant d'exécuter cette modification, assurez-vous que les nœuds Cassandra disposent de suffisamment de ressources de processeur et de mémoire. Assurez-vous qu'aucun nœud Cassandra ne consomme plus de 25% de la charge du processeur avant d'exécuter cette modification.

Après un changement de stratégie de compactage, un cycle de compactage complet doit s’exécuter. Il est donc recommandé de modifier la stratégie de compactage pendant les périodes de faible trafic.

Courses échelonnées

Il se peut que vous ne puissiez pas procéder au changement de tous les nœuds en une journée, en particulier si vous exploitez de grands clusters Cassandra, car les index doivent être recréés sur chaque nœud un par un. Vous pouvez modifier la stratégie de compactage d'un schéma ou d'une table à la fois. Pour ce faire, modifiez la table pour changer sa stratégie de compactage, puis reconstruisez tous les index de la table (le cas échéant) sur tous les nœuds. Répétez ensuite la procédure ci-dessus pour chaque table ou espace de clés. Ces exécutions pour une table ou un espace de clés peuvent être décomposées pour être exécutées sur différents jours.

Par exemple, pour remplacer la stratégie de compactage de la table oauth_20_access_tokens dans le schéma kms par LeveledCompactionStrategy, vous pouvez procéder comme suit:

  1. Modifiez la table pour changer de stratégie de compactage en exécutant la requête CQL suivante:

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

  2. Reconstruisez tous les index de cette table uniquement:

    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

Changer de stratégie de compactage

Dans les grandes lignes, la modification de la stratégie de compactage s'effectue en deux étapes:

  1. Modifiez la stratégie de compactage de chaque table.
  2. Reconstruisez tous les index de chaque nœud un par un.

Pour modifier la stratégie de compactage, vous devez exécuter une commande ALTER TABLE sur chaque table, une par une. Voici un exemple de commande ALTER TABLE:

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

Modifiez la table pour définir une nouvelle stratégie de compactage

Exécutez les requêtes CQL suivantes sur n'importe quel nœud Cassandra afin de modifier la stratégie pour un espace de clés à la fois. Les requêtes de recherche qualifiées peuvent être exécutées sur une requête CQL. Instructions pour appeler l'invite CQL:

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

Connecté à Apigee à l'adresse XXXXXXXX:9042.

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

Les commandes ci-dessous permettent de définir la stratégie de compactage sur LeveledCompactionStrategy, mais vous pouvez utiliser des commandes similaires pour passer à d'autres stratégies de compactage.

Les étapes 14 à 16 ci-dessous ne s'appliquent que si vous utilisez la monétisation.

  1. Les CQL doivent modifier la stratégie de compactage pour l'espace de clés: 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. Les CQL doivent modifier la stratégie de compactage pour l'espace de clés: user_settings 
    ALTER TABLE user_settings.user_settings WITH compaction = {'class' : 'LeveledCompactionStrategy'};
  3. Les CQL doivent modifier la stratégie de compactage pour l'espace de clés: keyvaluemap 
    ALTER TABLE keyvaluemap.keyvaluemaps_r21 WITH compaction = {'class' : 'LeveledCompactionStrategy'};
  4. Les CQL doivent modifier la stratégie de compactage pour l'espace de clés: 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. Les CQL doivent modifier la stratégie de compactage pour l'espace de clés: 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. Les CQL doivent modifier la stratégie de compactage pour l'espace de clés: cache 
    ALTER TABLE cache.cache_entries WITH compaction = {'class' : 'LeveledCompactionStrategy'};
ALTER TABLE cache.cache_sequence_id_r24 WITH compaction = {'class' : 'LeveledCompactionStrategy'};
  7. Les CQL doivent modifier la stratégie de compactage pour l'espace de clés: auth 
    ALTER TABLE auth.totp WITH compaction = {'class' : 'LeveledCompactionStrategy'};
  8. Les CQL doivent modifier la stratégie de compactage pour l'espace de clés: audit 
    ALTER TABLE audit.audits WITH compaction = {'class' : 'LeveledCompactionStrategy'};
ALTER TABLE audit.audits_ref WITH compaction = {'class' : 'LeveledCompactionStrategy'};
  9. Les CQL doivent modifier la stratégie de compactage pour l'espace de clés: 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. Les CQL doivent modifier la stratégie de compactage pour l'espace de clés: 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. Les CQL doivent modifier la stratégie de compactage pour l'espace de clés: identityzone 
    ALTER TABLE identityzone.IdentityZones WITH compaction = {'class' : 'LeveledCompactionStrategy'};
ALTER TABLE identityzone.OrgToIdentityZone WITH compaction = {'class' : 'LeveledCompactionStrategy'};
  12. Les CQL doivent modifier la stratégie de compactage pour l'espace de clés: dek 
    ALTER TABLE dek.keys WITH compaction = {'class' : 'LeveledCompactionStrategy'};
  13. Les CQL doivent modifier la stratégie de compactage pour l'espace de clés: 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. [Monétisation uniquement] Changement de stratégie de compactage pour l'espace de clés avec les langage CQL: 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. [Monétisation uniquement] Changement de stratégie de compactage pour l'espace de clés avec les langage CQL: 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. [Monétisation uniquement] Changement de stratégie de compactage pour l'espace de clés avec les langage CQL: 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'};

Recréer les index

Cette étape doit être exécutée après toute modification de stratégie de compactage. Veuillez exécuter les commandes nodetool suivantes une par une sur chaque nœud Cassandra.

Les étapes 7 à 9 ci-dessous ne s'appliquent que si vous utilisez la monétisation.

  1. Reconstruire les index pour l'espace de clés: 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. Reconstruire les index pour l'espace de clés: 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. Reconstruire les index pour l'espace de clés: cache

    nodetool rebuild_index cache cache_entries cache_entries_cache_name_idx

  4. Reconstruire les index pour l'espace de clés: 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. Reconstruire les index pour l'espace de clés: 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. Reconstruire les index pour l'espace de clés: dek

    nodetool rebuild_index dek keys usecase_index

  7. [Monétisation uniquement] Recréation des index pour l'espace de clés: 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. [Monétisation uniquement] Recréation des index pour l'espace de clés: 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. [Monétisation uniquement] Recréation des index pour l'espace de clés: 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

Validation

  1. Vérifiez que la modification de la stratégie de compactage sur le schéma a été appliquée en suivant les instructions de l'annexe 1.
  2. Vérifiez que le compactage a bien été effectué et que les données sont compactes après le changement de stratégie :
    1. Sur chaque nœud Cassandra, exécutez la commande nodetool suivante pour voir si tous les compactages sont terminés et que rien n'est en attente :
      nodetool compactionstats
    2. Une fois la vérification effectuée à l'aide de la commande ci-dessus pour vous assurer qu'aucun compactage n'est en attente, vérifiez que l'horodatage de la dernière modification des fichiers de données (sous /opt/apigee/data/apigee-cassandra/data/) se situe après l'horodatage du changement de stratégie de compactage CQL a été exécuté.

Rollback

Si vous devez effectuer un rollback, vous pouvez choisir l'une des options ci-dessous:

Option 1: Annuler la modification

Effectuez un rollback de la stratégie de compactage sur la stratégie initiale.

Exécutez des commandes ALTER TABLE semblables à celles utilisées précédemment dans l'invite CQL pour modifier la stratégie de compactage.

Si vous aviez déjà reconstruit les index en changeant la stratégie de compactage à LeveledCompactionStrategy, vous devrez reconstruire les index. Suivez la même procédure que précédemment pour recréer tous les index. Si vous n'avez pas recompilé les index précédemment, vous n'avez pas besoin de le faire lors du rollback.

Option 2: Restauration complète des données à partir d'une sauvegarde

Restaurez les données à partir de la sauvegarde pour tous les espaces de clés:

Veuillez suivre les instructions pour restaurer les données comme indiqué dans Restaurer à partir d'une sauvegarde.

Annexe 1: Vérifier la stratégie de compactage

Les stratégies de compactage sont définies au niveau de la table dans Cassandra. Vous pouvez utiliser les requêtes ci-dessous pour vérifier la stratégie de compactage pour chaque table.

Vous pouvez exécuter des requêtes CQL au niveau de l'invite CQL. Pour appeler l'invite CQL:

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

Un résultat semblable à celui-ci s'affiche:

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>

Vous pouvez déterminer la stratégie de compactage actuelle comme suit:

Chaque ligne de la sortie se rapporte à une table dans un espace de clés. Pour chaque ligne, la colonne compaction indique la stratégie de compactage utilisée par le tableau.

  • Si la stratégie de compactage est définie sur SizeTieredCompactionStrategy, la colonne compaction dans les requêtes ci-dessous se présentera comme suit:
    • {'class': 'org.apache.cassandra.db.compaction.SizeTieredCompactionStrategy', 'max_threshold': '32', 'min_threshold': '4'}
  • Si la stratégie de compactage est définie sur LeveledCompactionStrategy, la colonne compaction dans les requêtes ci-dessous se présente comme suit:
    • {'class': 'org.apache.cassandra.db.compaction.LeveledCompactionStrategy'}

Les requêtes ci-dessous peuvent être exécutées pour déterminer la stratégie de compactage de chaque table dans un espace de clés particulier:

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