Configurer des flux de modifications

Si vous souhaitez suivre les modifications de données apportées à une table Bigtable, vous pouvez activer un flux de modifications pour la table, puis le lire à l'aide d'une application comme Dataflow. Avant de lire ce document, consultez la section Présentation flux de modifications. En particulier, assurez-vous assurez-vous de connaître les coûts encourus lors de la diffusion de modifications.

Cette page explique comment activer, désactiver et modifier la durée de conservation des un flux de modifications.

Pour obtenir des instructions sur la création d'une table avec un flux de modifications activé, consultez Créez un tableau.

Rôle requis

Pour obtenir les autorisations nécessaires pour activer, désactiver ou modifier un flux de modifications Bigtable, demandez à votre administrateur de vous accorder le le rôle IAM suivant.

  • Administrateur Bigtable (roles/bigtable.admin) sur l'instance Bigtable qui contient la table que vous prévoyez diffuser les modifications

Activer un flux de modifications

Pour activer un flux de modifications sur une table existante, procédez comme suit:

Console

  1. Ouvrez la liste des instances Bigtable dans la console Google Cloud.

    Ouvrir la liste des instances

  2. Cliquez sur l'instance contenant la table pour laquelle vous souhaitez effectuer une modification. flux.

  3. Cliquez sur Tables dans le volet de gauche.

    La page Tables affiche une liste des tables de l'instance.

  4. Cliquez sur Modifier à côté de la table pour laquelle vous souhaitez activer une modification. flux.

  5. Cliquez sur Activer le flux de modifications.

  6. Dans le champ Délai d'expiration, saisissez un nombre compris entre 1 et 7 configurer le nombre de jours pendant lesquels et conservés.

  7. Cliquez sur Enregistrer.

gcloud

Pour activer un flux de modifications sur une table, utilisez la gcloud bigtable instances tables update .

  gcloud bigtable instances tables update TABLE_ID \
        --instance=INSTANCE_ID \
        --project=PROJECT_ID \
        --change-stream-retention-period=CHANGE_STREAM_RETENTION_PERIOD

Remplacez les éléments suivants :

  • TABLE_ID: ID de la table dont vous souhaitez apporter les modifications. pour diffuser en streaming
  • INSTANCE_ID: instance contenant la table
  • PROJECT_ID: projet contenant l'instance
  • CHANGE_STREAM_RETENTION_PERIOD: durée pendant laquelle Bigtable doit conserver les données des flux de modifications pour la table. Doit être comprise entre un et sept jours, exprimée sous forme de nombre et une lettre correspondant à l'unité. Les unités acceptées sont les jours (d), les heures (h), minutes (m) et secondes (s). Exemple : 5d

Désactiver un flux de modifications

Vous pouvez désactiver le flux de modifications d'une table à tout moment. d'enregistrements de flux de données créés avant la désactivation du flux de modifications continuent à consommer de l'espace de stockage. jusqu'au compactage suivant, mais vous n'êtes pas plus de frais pour cet espace de stockage. Vous ne pouvez pas lire un flux de modifications après avoir la désactiver, y compris les modifications enregistrées avant la désactivation du flux.

Console

  1. Ouvrez la liste des instances Bigtable dans la console Google Cloud.

    Ouvrir la liste des instances

  2. Cliquez sur l'instance dont vous souhaitez consulter les tables.

  3. Cliquez sur Tables dans le volet de gauche.

    La page Tables affiche une liste des tables de l'instance.

  4. Cliquez sur Modifier à côté de la table dont vous souhaitez configurer le flux de modifications. pour la désactiver.

  5. Décochez la case Activer le flux de modifications.

  6. Cliquez sur Enregistrer.

gcloud

Pour désactiver un flux de modifications sur une table, utilisez la gcloud bigtable instances tables update .

  gcloud bigtable instances tables update TABLE_ID \
        --instance=INSTANCE_ID \
        --project=PROJECT_ID \
        --clear-change-stream-retention-period

Remplacez les éléments suivants :

  • TABLE_ID: ID de la table dont vous souhaitez apporter les modifications. pour diffuser en streaming
  • INSTANCE_ID: instance contenant la table
  • PROJECT_ID: projet contenant l'instance

Modifier la durée de conservation d'un flux de modifications

Vous pouvez modifier le nombre de jours pendant lesquels Bigtable conserve votre modification des enregistrements de flux. Si vous réduisez le nombre de jours, les enregistrements diffusés avant la modification de la configuration continuent à consommer de l'espace de stockage jusqu'au prochain compactage. Après la configuration modification, vous ne pouvez diffuser que les modifications apportées à la période que vous venez de spécifier.

L'augmentation de la durée de conservation n'est pas rétroactive : les flux de modifications sont conservés pendant le nombre de jours augmenté à compter de la date de modification configuration.

Console

  1. Ouvrez la liste des instances Bigtable dans la console Google Cloud.

    Ouvrir la liste des instances

  2. Cliquez sur l'instance dont vous souhaitez consulter les tables.

  3. Cliquez sur Tables dans le volet de gauche.

    La page Tables affiche une liste des tables de l'instance.

  4. Cliquez sur Modifier à côté de la table dont vous souhaitez configurer le flux de modifications. à modifier.

  5. Dans le champ Délai d'expiration, saisissez un nombre compris entre 1 et 7 pour le nombre de jours pendant lesquels les enregistrements de flux de données doivent être conservés.

  6. Cliquez sur Enregistrer.

gcloud

Pour modifier la durée de conservation du flux de modifications d'une table, utilisez l'gcloud bigtable instances tables update .

  gcloud bigtable instances tables update TABLE_ID \
        --instance=INSTANCE_ID \
        --project=PROJECT_ID \
        --change-stream-retention-period=CHANGE_STREAM_RETENTION_PERIOD

Remplacez les éléments suivants :

  • TABLE_ID: ID de la table dont vous souhaitez diffuser les modifications
  • INSTANCE_ID: instance contenant la table
  • PROJECT_ID: projet contenant l'instance
  • CHANGE_STREAM_RETENTION_PERIOD: durée pendant laquelle Bigtable doit conserver les données des flux de modifications pour la table. Doit être compris entre un et sept jours, sous la forme d'un chiffre et d'une lettre pour l'unité. Les unités acceptées sont les jours (d), les heures (h), les minutes (m) et secondes (s). Exemple : 5d

Étape suivante