Gérer les sauvegardes

Cette page explique comment effectuer des opérations de sauvegarde Bigtable. Avant de lire cette page, vous devez connaître les sauvegardes.

Vous pouvez effectuer des sauvegardes Bigtable au moyen de :

Avant de commencer

Assurez-vous que vous (ou le compte utilisateur que vous utilisez) disposez des autorisations requises pour l'action que vous devez effectuer.

Si vous prévoyez d'utiliser gcloud CLI, installez gcloud CLI pour Bigtable.

Utiliser la sauvegarde automatique

Vous pouvez utiliser gcloud CLI ou la console Google Cloud pour activer la sauvegarde automatique. La sauvegarde automatique crée une sauvegarde quotidienne de votre table avec une période de conservation par défaut de sept jours. Pour modifier la période de conservation dans la stratégie de sauvegarde automatique d'une table, consultez Mettre à jour une stratégie de sauvegarde automatique.

Les étapes de suppression, de mise à jour, de copie et de restauration d'une sauvegarde sont les mêmes, que la sauvegarde soit créée manuellement ou à la suite d'une sauvegarde automatique.

Si votre cluster dépasse les limites recommandées en termes d'utilisation du processeur ou du stockage, la sauvegarde automatique peut être affectée et la création de votre sauvegarde peut être retardée. Pour en savoir plus, consultez la section Comprendre l'utilisation du processeur et du disque.

Par défaut, les sauvegardes créées automatiquement expirent au bout de trois jours. Vous pouvez prolonger la date d'expiration. Pour en savoir plus, consultez Modifier une sauvegarde.

Pendant la phase Preview, tenez compte des facteurs suivants si vous envisagez d'activer la sauvegarde automatique:

  • Si vous ajoutez un cluster à une instance contenant une table pour laquelle la sauvegarde automatique est activée, aucune sauvegarde quotidienne n'est créée sur le cluster ajouté. Pour créer des sauvegardes quotidiennes sur tous les clusters, y compris le nouveau cluster, désactivez la sauvegarde automatique pour la table, puis réactivez-la.
  • Si une table pour laquelle la sauvegarde automatique est activée est supprimée, puis rétablie, vous devez réactiver la sauvegarde automatique sur la table récupérée.
  • La restauration d'une sauvegarde automatique d'une table n'active pas automatiquement la sauvegarde automatique sur la table restaurée. Vous devez activer manuellement la sauvegarde automatique.

Activer la sauvegarde automatique

Vous pouvez activer la sauvegarde automatique à l'aide de la console ou de Google Cloud CLI. Lorsque la sauvegarde automatique est activée, Bigtable crée une sauvegarde standard de la table chaque jour sur chaque cluster de l'instance. Vous ne pouvez pas utiliser la sauvegarde automatique pour créer des sauvegardes à chaud.

Les sauvegardes créées dans le cadre d'une sauvegarde automatique sont associées à des ID commençant par auto. Par exemple, une table dont l'ID est my-table aura un ID de sauvegarde automatique comme auto.my-table.c7x3.20230220-145537, où my-table est l'ID de table tronqué, c7x3 est l'ID de hachage unique et 20230220-145537 est la date et l'heure au format UTC.

Pour créer une table avec la sauvegarde automatique activée, consultez la section Créer et gérer des tables.

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 que vous souhaitez sauvegarder.

  3. Cliquez sur Tables dans le volet de gauche.

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

  4. Dans la colonne Sauvegarde automatique du tableau, cliquez sur Activer. La création de sauvegardes par Bigtable peut prendre jusqu'à une heure.

gcloud

Pour activer la sauvegarde automatique d'une table, exécutez la commande gcloud bigtable tables update. Pour en savoir plus sur l'activation de la sauvegarde automatique lors de la création d'une table, consultez la section Créer une table.

Une fois la règle de sauvegarde automatique activée pour une table, la mise à jour de la configuration peut prendre jusqu'à une heure.

gcloud bigtable tables update TABLE_ID \
--instance=INSTANCE_ID \
--enable-automated-backup

Remplacez les éléments suivants :

  • TABLE_ID: ID de la table à sauvegarder.
  • INSTANCE_ID : identifiant permanent de l'instance.

Facultatif: Pour activer la sauvegarde automatique d'une table et définir une durée de conservation différente de la valeur par défaut de sept jours, utilisez l'indicateur --automated-backup-retention-period au lieu de l'indicateur --enable-automated-backup:

gcloud bigtable tables update TABLE_ID \
--instance=INSTANCE_ID \
--automated-backup-retention-period=RETENTION_PERIOD

Remplacez RETENTION_PERIOD par une valeur d'au moins trois jours et de 90 jours maximum, exprimée sous la forme de nombres accompagnés d'une unité m, h ou d (minutes, heures ou jours), par exemple 15d pour 15 jours.

Désactiver la sauvegarde automatique

Une fois la règle de sauvegarde automatique désactivée pour une table, la mise à jour de la configuration peut prendre jusqu'à une heure. Les sauvegardes créées avant le changement de règle sont conservées jusqu'à leur expiration, sauf si vous les supprimez.

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 désactiver la sauvegarde automatique.

  3. Cliquez sur Tables.

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

  4. Sur la ligne du tableau pour laquelle vous souhaitez désactiver la sauvegarde automatique, cliquez sur  Modifier.

  5. Décochez la case Activer la sauvegarde automatique.

  6. Cliquez sur Enregistrer.

gcloud

Pour désactiver la sauvegarde automatique d'une table, exécutez la commande gcloud bigtable instances tables update.

gcloud bigtable instances tables update TABLE_ID \
--instance=INSTANCE_ID \
--disable-automated-backup

Remplacez les éléments suivants :

  • TABLE_ID: ID de la table.
  • INSTANCE_ID : identifiant permanent de l'instance.

Afficher la règle de sauvegarde automatique

Pour afficher la stratégie de sauvegarde automatique d'une table, exécutez la commande gcloud bigtable instances tables describe.

gcloud bigtable instances tables describe TABLE_ID \
--instance=INSTANCE_ID

Remplacez les éléments suivants :

  • TABLE_ID: ID de la table.
  • INSTANCE_ID : identifiant permanent de l'instance.

La sortie ressemble à ceci :

automatedBackupPolicy:
  retentionPeriod: 3d
  frequency: 24h
columnFamilies:
  my-family: {}
createTime: '2023-02-07T20:10:55.613546Z'
granularity: MILLIS
name: projects/my-project/instances/my-instance/tables/my-table
updateTime: '2023-02-07T20:10:55.613546Z'

Veuillez noter les points suivants :

  • Le champ automatedBackupPolicy est absent lorsque la sauvegarde automatique n'est pas activée pour une table.
  • retentionPeriod indique la durée de conservation des sauvegardes créées automatiquement. Vous pouvez modifier la durée de conservation d'une sauvegarde jusqu'à 90 jours après sa création. Pour mettre à jour la durée de conservation des sauvegardes, consultez Modifier une sauvegarde.

Mettre à jour une règle de sauvegarde automatique

Les modifications apportées à une règle de sauvegarde automatique s'appliquent aux sauvegardes créées après la modification.

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 dont vous souhaitez mettre à jour la stratégie de sauvegarde automatique.

  3. Cliquez sur Tables.

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

  4. Sur la ligne du tableau pour laquelle vous souhaitez configurer la règle de sauvegarde automatique, cliquez sur  Modifier. Le volet "Propriétés du tableau" s'affiche.

  5. Sous Configurer la sauvegarde automatique, dans le champ Période de conservation, saisissez un entier compris entre 3 et 90 pour spécifier le nombre de jours pendant lesquels Bigtable doit conserver les sauvegardes après l'enregistrement de la modification.

  6. Cliquez sur Enregistrer.

gcloud

Pour modifier la stratégie de sauvegarde automatique d'une table, exécutez la commande gcloud bigtable tables update avec l'option --automated-backup-retention-period.

gcloud bigtable tables update TABLE_ID \
    --instance=INSTANCE_ID \
    --automated-backup-retention-period=retention-period=RETENTION_PERIOD

Remplacez les éléments suivants :

  • TABLE_ID: ID de la table dont la sauvegarde est automatisée.
  • INSTANCE_ID : identifiant permanent de l'instance.

  • RETENTION_PERIOD: période de 90 jours maximum, exprimée sous la forme de nombres accompagnés d'une unité m, h ou d (minutes, heures ou jours).

    Exemples: 72h ou 89d

Afficher les journaux des événements

Lorsque la sauvegarde automatique est activée, Bigtable émet des journaux des événements système lorsqu'une sauvegarde est créée. Il émet également un journal des événements si la création de la sauvegarde est retardée.

Pour afficher les journaux des événements système de sauvegarde automatique sur la page de présentation du cluster Bigtable dans la console, procédez comme suit:

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

    Ouvrir la liste des instances

  2. Cliquez sur l'ID d'instance.

  3. Cliquez sur l'ID du cluster.

    Si des journaux d'événements de sauvegarde automatique ont été créés au cours de la dernière heure, ils s'affichent dans le volet Journaux.

  4. Facultatif: Pour afficher d'anciens journaux d'événements, cliquez sur la flèche à côté de 1 heure, puis sélectionnez une autre période.

Pour afficher les journaux des événements du système de sauvegarde automatique dans l'explorateur de journaux, procédez comme suit:

  1. Accédez à l'explorateur de journaux :

    Accéder à l'explorateur de journaux

    Sélectionnez le projet Google Cloud approprié.

  2. Pour afficher les événements de création de sauvegarde, saisissez ce qui suit dans le champ Requête:

    resource.type="audited_resource" resource.labels.service="bigtableadmin.googleapis.com"
resource.labels.method="CreateAutomatedBackup"

  3. Cliquez sur Exécuter la requête.

  4. Pour afficher les événements de retard de sauvegarde, saisissez ce qui suit dans le champ Requête:

    resource.type="audited_resource" resource.labels.service="bigtableadmin.googleapis.com"
resource.labels.method="DelayedAutomatedBackup"

  5. Cliquez sur Exécuter la requête.

    Le résultat de la requête inclut un message semblable à celui-ci:

    Automated backup is delayed for table ab-test on cluster my-cluster-staging-c1.

Créer une sauvegarde standard

Vous pouvez créer une sauvegarde standard d'une table à l'aide de la Google Cloud CLI, de la console ou de l'une des bibliothèques clientes Bigtable. Vous pouvez également activer la sauvegarde automatique pour que Bigtable crée une sauvegarde standard quotidienne pour vous.

Console

  1. Accédez à la page Instances Bigtable de la console Google Cloud.

    Ouvrir la liste des instances

  2. Cliquez sur l'instance contenant la table que vous souhaitez sauvegarder.

  3. Dans le volet de navigation de gauche, cliquez sur Tables.

  4. Cliquez sur Créer une sauvegarde en fonction de la table que vous souhaitez sauvegarder.

  5. Si vous utilisez la réplication, utilisez le menu déroulant pour choisir l'ID du cluster qui doit stocker la sauvegarde. (Si vous avez cliqué sur Créer une sauvegarde à côté d'un ID de cluster plutôt qu'un ID d'instance sur la page Tables, le cluster est présélectionné.)

  6. Saisissez un ID unique pour la sauvegarde.

  7. Définissez une date d'expiration.

  8. Cliquez sur Créer.

    La console affiche la page Sauvegardes filtrée pour afficher la sauvegarde et ses informations.

  9. Cliquez sur Activité pour afficher l'état de la sauvegarde.

    La colonne d'état indique Sauvegarde terminée lorsque la sauvegarde est terminée.

gcloud

Remplacez toutes les commandes par les valeurs suivantes :

  • INSTANCE_ID : identifiant permanent de l'instance.
  • CLUSTER_ID : identifiant permanent du cluster.
  • TABLE_ID : ID de la table à sauvegarder.
  • BACKUP_ID : ID que vous attribuez à la sauvegarde.

  • EXPIRATION_DATE: date à 90 jours ou moins, formatée en horodatage UTC "Zulu", à la nanoseconde près.

    Exemple : 2022-10-02T15:01:23.045123456Z

  • RETENTION_PERIOD: période de 90 jours maximum, exprimée sous la forme de nombres accompagnés d'une unité m, h ou d (minutes, heures ou jours).

    Exemples: 36h ou 89d

  1. Si vous ne connaissez pas l'ID d'instance, exécutez la commande bigtable instances list pour afficher la liste des instances du projet :

    gcloud bigtable instances list

  2. Affichez la liste des sauvegardes de l'instance contenant la table que vous souhaitez sauvegarder. Vous pourrez ainsi choisir un ID de sauvegarde qui n'est pas déjà utilisé sur le cluster prévu.

    gcloud bigtable backups list --instance=INSTANCE_ID \
  --cluster=CLUSTER_ID

  3. Consultez la liste des tables pour confirmer l'ID de la table que vous souhaitez sauvegarder.

    gcloud bigtable instances tables list --instances=INSTANCE_ID

  4. Exécutez la commande gcloud bigtable instances backups create pour créer une sauvegarde à partir de la table, en indiquant une date d'expiration ou une période de conservation de 90 jours maximum.

    gcloud bigtable backups create BACKUP_ID --instance=INSTANCE_ID \
  --cluster=CLUSTER_ID \
  --table=TABLE_ID \
  --async \
  --expiration-date=EXPIRATION_DATE \
  --retention-period=RETENTION_PERIOD

    L'option --async est facultative. Utilisez-la si vous souhaitez que le terminal renvoie l'ID de l'opération avant que celle-ci prenne fin. Cela est utile si vous souhaitez vérifier l'état de l'opération.

  5. Affichez la liste des sauvegardes pour vérifier que votre sauvegarde a été créée.

    gcloud bigtable backups list --instance=INSTANCE_ID \
  --cluster=CLUSTER_ID

  6. Si la sauvegarde n'est pas répertoriée, vérifiez l'état de l'opération.

    L'état Ready indique que la sauvegarde est terminée.

Créer une sauvegarde à chaud

gcloud

Remplacez toutes les commandes par les valeurs suivantes :

  • INSTANCE_ID : identifiant permanent de l'instance.
  • CLUSTER_ID : identifiant permanent du cluster.
  • TABLE_ID : ID de la table à sauvegarder.
  • BACKUP_ID : ID que vous attribuez à la sauvegarde.

  • EXPIRATION_DATE: date à 90 jours ou moins, formatée en horodatage UTC "Zulu", à la nanoseconde près.

    Exemple : 2022-10-02T15:01:23.045123456Z

  • RETENTION_PERIOD: période de 90 jours maximum, exprimée sous la forme de nombres accompagnés d'une unité m, h ou d (minutes, heures ou jours).

    Exemples: 36h ou 89d

  • HOT_TO_STANDARD_TIME: (facultatif) date et heure auxquelles Bigtable doit convertir la sauvegarde d'une sauvegarde à chaud en sauvegarde standard. Cette valeur doit être d'au moins 24 heures après l'heure de création de la sauvegarde.

    Exemple : 2024-08-02T15:01:23.045123456Z

    Vous pouvez également fournir une date et une heure de durée relative. Pour en savoir plus, consultez la section gcloud topic datetimes.

    Exemple: +P30D pendant 30 jours

  1. Si vous ne connaissez pas l'ID d'instance, exécutez la commande bigtable instances list pour afficher la liste des instances du projet :

    gcloud bigtable instances list

  2. Affichez la liste des sauvegardes de l'instance contenant la table que vous souhaitez sauvegarder. Vous pourrez ainsi choisir un ID de sauvegarde qui n'est pas déjà utilisé sur le cluster prévu.

    gcloud bigtable backups list --instance=INSTANCE_ID \
  --cluster=CLUSTER_ID

  3. Consultez la liste des tables pour confirmer l'ID de la table que vous souhaitez sauvegarder.

    gcloud bigtable instances tables list --instances=INSTANCE_ID

  4. Exécutez la commande gcloud bigtable instances backups create pour créer une sauvegarde à chaud de la table, en indiquant une date d'expiration ou une période de conservation de 90 jours maximum.

    gcloud bigtable backups create BACKUP_ID --instance=INSTANCE_ID \
  --cluster=CLUSTER_ID \
  --table=TABLE_ID \
  --async \
  --expiration-date=EXPIRATION_DATE \
  --retention-period=RETENTION_PERIOD \
  --backup-type=HOT \
  --hot-to-standard-time=HOT_TO_STANDARD_TIME

    L'option --async est facultative. Utilisez-la si vous souhaitez que le terminal renvoie l'ID de l'opération avant que celle-ci prenne fin. Cela est utile si vous souhaitez vérifier l'état de l'opération.

  5. Affichez la liste des sauvegardes pour vérifier que votre sauvegarde a été créée.

    gcloud bigtable backups list --instance=INSTANCE_ID \
  --cluster=CLUSTER_ID

  6. Si la sauvegarde n'est pas répertoriée, vérifiez l'état de l'opération.

    L'état Ready indique que la sauvegarde est terminée.

Restaurer à partir d'une sauvegarde

La sauvegarde automatique n'est pas activée pour une nouvelle table restaurée à partir d'une sauvegarde, même si elle l'était pour la table source. Si vous souhaitez une sauvegarde automatique de la nouvelle table, vous devez l'activer.

La procédure de restauration à partir d'une sauvegarde est la même, qu'il s'agisse d'une sauvegarde standard ou à chaud.

Console

Vous ne pouvez pas restaurer dans un autre projet à l'aide de la console Google Cloud. Si vous devez le faire, utilisez plutôt la gcloud CLI.

  1. Accédez à la page Instances Bigtable de la console Google Cloud.

    Ouvrir la liste des instances

  2. Cliquez sur l'instance contenant la sauvegarde que vous souhaitez restaurer.

  3. Dans le volet de navigation de gauche, cliquez sur Sauvegardes.

  4. Cliquez sur Restaurer pour la sauvegarde que vous souhaitez restaurer.

  5. Sélectionnez l'instance sur laquelle vous souhaitez effectuer la restauration.

    Les instances qui ne disposent pas d'un espace de stockage suffisant pour la nouvelle table sont indisponibles. Si vous n'êtes pas autorisé à créer une table dans une instance, celle-ci n'est pas disponible. Passez la souris sur l'icône pour en savoir plus.

    Si vous effectuez une restauration à partir d'une sauvegarde protégée par une clé CMEK, l'instance de destination doit également être protégée par une clé CMEK.

    Vous ne pouvez pas restaurer dans un autre projet à l'aide de la console Google Cloud. Si nécessaire, utilisez plutôt la gcloud CLI.

  6. Saisissez un ID unique pour la table qui sera créée à partir de la sauvegarde. Vous ne pourrez pas modifier cet ID par la suite.

  7. Cliquez sur Restaurer.

    La console affiche la page Tables filtrée pour afficher la nouvelle table.

    La console affiche l'état de restauration de chaque cluster. Lorsque la colonne d'état de tous les clusters indique Prêt, la table a été restaurée et répliquée sur tous les clusters de l'instance.

gcloud

Remplacez toutes les commandes par les valeurs suivantes :

  • PROJECT_ID_SOURCE: ID du projet contenant la sauvegarde à partir de laquelle la restauration doit être effectuée.
  • INSTANCE_ID_SOURCE: ID permanent de l'instance source.
  • PROJECT_ID_DESTINATION: ID du projet sur lequel vous souhaitez effectuer la restauration. Cette option est facultative. Si vous ne spécifiez pas cette option, la sauvegarde est restaurée dans une nouvelle table de l'instance où elle a été créée.
  • INSTANCE_ID_DESTINATION: ID permanent de l'instance de destination.
  • CLUSTER_ID : identifiant permanent du cluster.
  • BACKUP_ID: ID de la sauvegarde à partir de laquelle vous souhaitez effectuer la restauration.
  • TABLE_ID_NEW: ID de la nouvelle table.

  1. Si vous ne connaissez pas l'ID d'instance, exécutez la commande bigtable instances list pour afficher la liste des instances du projet :

    gcloud bigtable instances list

  2. Affichez la liste des sauvegardes de l'instance contenant la sauvegarde pour vérifier que cette dernière existe.

    gcloud bigtable backups list --instance=INSTANCE_ID_SOURCE \
  --cluster=CLUSTER_ID_SOURCE

  3. Affichez la liste des tables de l'instance de destination, afin de pouvoir choisir un ID qui n'est pas déjà utilisé pour la nouvelle table.

    gcloud bigtable instances tables list --instances=INSTANCE_ID_DESTINATION

  4. Exécutez la commande gcloud bigtable instances tables restore pour restaurer à partir de la sauvegarde vers une nouvelle table.

    gcloud bigtable instances tables restore \
--source=projects/PROJECT_ID_SOURCE/instances/INSTANCE_ID_SOURCE/clusters/CLUSTER_ID/backups/BACKUP_ID \
--async \
--destination=TABLE_ID_NEW \
--destination-instance=INSTANCE_ID_DESTINATION \
--project=PROJECT_ID_DESTINATION

    L'option --async est facultative. Utilisez-la si vous souhaitez que le terminal renvoie l'ID de l'opération avant que celle-ci prenne fin. Cela est utile si vous souhaitez vérifier l'état de l'opération.

  5. Affichez la liste des tables pour vérifier que votre table a été créée.

    gcloud bigtable instances tables list --instances=INSTANCE_ID_DESTINATION

  6. Si la sauvegarde n'est pas répertoriée, vérifiez l'état de l'opération.

Créer une copie d'une sauvegarde

Console

Vous ne pouvez pas créer de copie d'une sauvegarde dans un autre projet à l'aide de la console. Si vous devez le faire, utilisez plutôt la gcloud CLI.

  1. Accédez à la page Instances Bigtable de la console Google Cloud.

    Ouvrir la liste des instances

  2. Cliquez sur l'instance contenant la sauvegarde que vous souhaitez copier.

  3. Dans le volet de navigation de gauche, cliquez sur Sauvegardes.

  4. Pour la sauvegarde que vous souhaitez copier, développez le menu "Plus" à côté du mot Restaurer, puis cliquez sur Copier.

  5. Cliquez sur Copier pour la sauvegarde dont vous souhaitez créer une copie.

    Si la sauvegarde est une copie d'une autre sauvegarde, l'option Copier n'est pas disponible.

  6. Sélectionnez l'instance de destination.

    Vous ne pouvez pas créer de copie d'une sauvegarde dans un autre projet à l'aide de la console. Si vous devez le faire, utilisez plutôt la gcloud CLI.

    Les instances qui ne disposent pas d'un espace de stockage suffisant pour la copie de sauvegarde sont indisponibles. Si vous n'êtes pas autorisé à créer une sauvegarde dans une instance, celle-ci n'est pas disponible. Maintenez le pointeur de la souris sur l'icône pour en savoir plus.

    Si vous copiez une sauvegarde protégée par une clé CMEK, l'instance de destination doit également être protégée par une clé CMEK.

  7. Sélectionnez le cluster de destination.

    Comme toute sauvegarde, une copie de sauvegarde n'est stockée que sur un seul cluster d'une instance, même si cette instance utilise la réplication.

  8. Saisissez un ID unique pour la copie qui sera créée à partir de la sauvegarde. Vous ne pourrez pas modifier cet ID par la suite.

  9. Définissez une date d'expiration pour la copie de sauvegarde en indiquant une valeur pour Heure et en sélectionnant une Unité dans le menu déroulant.

  10. Cliquez sur Copier.

  11. Pour afficher votre copie, cliquez sur Afficher la copie.

    La console affiche la page Sauvegardes de l'instance de destination, filtrée pour la copie de sauvegarde que vous venez de créer. Lorsque la colonne d'état indique Prêt, la copie est terminée et prête pour d'autres opérations.

gcloud

Remplacez toutes les commandes par les valeurs suivantes :

  • PROJECT_ID_SOURCE: projet contenant la sauvegarde à copier.
  • INSTANCE_ID_SOURCE: ID permanent de l'instance source.
  • CLUSTER_ID_SOURCE: ID du cluster dans lequel la sauvegarde source est stockée.
  • BACKUP_ID_SOURCE: ID de la sauvegarde à copier.
  • PROJECT_ID_DESTINATION: projet dans lequel vous souhaitez placer la copie.
  • INSTANCE_ID_DESTINATION: ID permanent de l'instance de destination.
  • CLUSTER_ID_DESTINATION: ID du cluster dans l'instance de destination dans laquelle vous souhaitez stocker la copie.
  • BACKUP_ID_DESTINATION: ID que vous attribuez à la copie de la sauvegarde.
  • RETENTION_PERIOD: durée de vie de la copie de sauvegarde, exprimée sous la forme d'un nombre et d'une unité (d ou h). Par exemple, 5d pendant cinq jours ou 15h pendant 15 heures. Utilisez cette valeur ou une date d'expiration.
  • EXPIRATION_DATE: date et heure d'expiration de la copie de sauvegarde, au format 2022-09-01T10:00:00.0Z.

  1. Si vous ne connaissez pas l'ID d'instance, exécutez la commande bigtable instances list pour afficher la liste des instances du projet :

    gcloud bigtable instances list

  2. Affichez la liste des sauvegardes de l'instance source contenant la sauvegarde pour vérifier que la sauvegarde que vous souhaitez copier existe.

    gcloud bigtable backups list --instance=INSTANCE_ID_SOURCE \
--cluster=CLUSTER_ID_SOURCE

  3. Affichez la liste des sauvegardes de l'instance de destination afin de pouvoir choisir un ID pour la copie qui n'est pas déjà utilisé.

    gcloud bigtable backups list --instances=DESTINATION_INSTANCE

  4. Exécutez la commande gcloud bigtable instances backups copy pour créer la copie de sauvegarde.

    gcloud bigtable backups copy \
  --source-project=PROJECT_ID_SOURCE \
  --source-instance=INSTANCE_ID_SOURCE \
  --source-cluster=CLUSTER_ID_SOURCE \
  --source-backup=BACKUP_ID_SOURCE \
  --destination-project=PROJECT_ID_DESTINATION \
  --destination-instance=INSTANCE_ID_DESTINATION \
  --destination-cluster=CLUSTER_ID_DESTINATION \
  --destination-backup=BACKUP_ID_DESTINATION \

    Ajoutez l'un des éléments suivants à la commande:

    • --retention-period`=RETENTION_PERIOD: période de conservation de la copie de sauvegarde. La valeur doit être comprise entre 6 heures et 30 jours à compter de la création de la sauvegarde source.
    • --expiration-date`=EXPIRATION_DATE: date d'expiration de la copie de sauvegarde. La valeur doit être comprise entre 6 heures et 30 jours à compter de la création de la sauvegarde source.

    Vous pouvez éventuellement ajouter --async à la commande. Utilisez-la si vous souhaitez que le terminal renvoie l'ID de l'opération avant que celle-ci prenne fin. Cela est utile si vous souhaitez vérifier l'état de l'opération.

    Si un message d'expiration est renvoyé, la sauvegarde a peut-être réussi et la copie a peut-être été créée.

  5. Affichez la liste des sauvegardes pour vérifier que votre copie a été créée.

    gcloud bigtable backups list --instances=INSTANCE_ID_DESTINATION

  6. Si la sauvegarde n'est pas répertoriée, vérifiez l'état de l'opération.

Dans le cas rare où une opération de copie de sauvegarde échoue en raison de limites de capacité, réessayez avec un autre cluster de destination. Si cette opération échoue également, contactez l'assistance.

Vérifier l'état d'une opération

Console

  1. Accédez à la page Instances Bigtable de la console Google Cloud.

    Ouvrir la liste des instances

  2. Cliquez sur l'instance contenant la sauvegarde.

  3. Dans le volet de navigation de gauche, cliquez sur Sauvegardes.

  4. Sur la page Sauvegardes, cliquez sur Activité. La colonne d'état affiche l'état actuel de chaque opération.

Lors de la restauration d'une table, les états d'opération sont les suivants :

  • En attente de copie
  • Restauration de la sauvegarde…
  • Initialisation…
  • Prête pour l'optimisation
  • Prêt

Lors de la création d'une sauvegarde, les états d'opération incluent les éléments suivants:

  • Création de la sauvegarde…
  • Sauvegarde terminée

Lors de la copie d'une sauvegarde, les états d'opération sont les suivants:

  • Copie de la sauvegarde…
  • Sauvegarde copiée

gcloud

Pour vérifier l'état d'une opération de sauvegarde ou de restauration, vous avez besoin de l'ID unique de l'opération. Voici un exemple d'ID d'opération :

`instances/instance-name/tables/table-name/locations/us-east1-b/operations/917168358249360635`

Une fois que vous avez exécuté une commande pour créer une sauvegarde ou une restauration dans une nouvelle table à l'aide de l'option --async, le terminal affiche l'ID de l'opération.

  1. Copiez l'ID de l'opération.

  2. Exécutez la commande gcloud bigtable operations describe en remplaçant la valeur copiée par OPERATION_ID.

    gcloud bigtable operations describe OPERATION_ID

    Exemple :

    gcloud bigtable operations describe \
instances/instance-name/tables/table-name/locations/us-east1-b/operations/917168358249360635

    Vous pouvez exécuter cette commande à intervalles réguliers jusqu'à ce que la valeur de DONE soit TRUE.

Si vous ne connaissez pas l'ID de l'opération, soit parce que vous n'avez pas exécuté la commande, soit parce que vous vous trouvez dans une autre fenêtre de terminal, vous pouvez afficher la liste des opérations de l'instance et déterminer l'opération à vérifier.

  1. Affichez une liste des activités d'opération récentes de l'instance contenant la table que vous sauvegardez ou restaurez, en remplaçant l'ID de l'instance par INSTANCE_ID :

    gcloud bigtable operations list --instance=INSTANCE_ID

    Le terminal affiche une liste d'opérations dans les colonnes NAME, START_TIME, END_TIME et DONE. La valeur de la colonne NAME correspond à l'ID de l'opération.

  2. Copiez l'ID de l'opération en commençant par le premier élément de la liste.

  3. Utilisez gcloud bigtable operations describe pour afficher les métadonnées de l'opération.

    gcloud bigtable operations describe OPERATION_ID

    Exemple :

    gcloud bigtable operations describe \
instances/instance-name/tables/table-name/locations/us-east1-b/operations/917168358249360635

  4. Si les métadonnées d'une opération affichent une valeur pour backupInfo, vous avez trouvé l'opération appropriée. Vous pouvez répéter cette commande régulièrement jusqu'à ce que la valeur de DONE corresponde à TRUE.

    Si les métadonnées n'affichent pas de valeur pour backupInfo, vérifiez l'opération suivante dans la liste des opérations affichée à l'étape 1.

Modifier une sauvegarde ou une copie de sauvegarde

Console

La console Google Cloud ne vous permet pas de modifier une sauvegarde, y compris les copies.

gcloud

La gcloud CLI vous permet de modifier la date ou la période d'expiration d'une sauvegarde ou d'une copie de sauvegarde. Vous pouvez également convertir une sauvegarde à chaud en sauvegarde standard.

Remplacez toutes les commandes par les valeurs suivantes :

  • INSTANCE_ID : identifiant permanent de l'instance.
  • CLUSTER_ID : identifiant permanent du cluster.
  • BACKUP_ID : ID unique d'une sauvegarde.

  • EXPIRATION_DATE: date à 90 jours ou moins, formatée en horodatage UTC "Zulu", à la nanoseconde près.

    Exemple : 2019-10-02T15:01:23.045123456Z

  • RETENTION_PERIOD: période de 90 jours maximum, exprimée sous la forme de nombres accompagnés d'une unité m, h ou d (minutes, heures ou jours).

    Exemples: 36h ou 89d

  • HOT_TO_STANDARD_TIME: (facultatif) date et heure auxquelles Bigtable doit convertir la sauvegarde d'une sauvegarde à chaud en sauvegarde standard. Cette valeur doit être d'au moins 24 heures après l'heure de création de la sauvegarde.

    Exemple : 2024-08-02T15:01:23.045123456Z

    Vous pouvez également fournir une date et une heure de durée relative. Pour en savoir plus, consultez la section gcloud topic datetimes.

    Exemple: +P30D pendant 30 jours

  1. Affichez la liste des sauvegardes :

        gcloud bigtable backups list --instance=INSTANCE_ID

    Le terminal affiche une liste de sauvegardes.

  2. Notez les ID de sauvegarde et de cluster associés à la sauvegarde que vous devez mettre à jour.

  3. Exécutez la commande gcloud bigtable instances backups update pour ajouter une date d'expiration ou une période de conservation, ou pour convertir une sauvegarde à chaud en sauvegarde standard.

      gcloud bigtable backups update BACKUP_ID \
  --instance=INSTANCE_ID \
  --cluster=CLUSTER_ID \
  --expiration-date=EXPIRATION_DATE \
  --retention-period=RETENTION_PERIOD
  --hot-to-standard-time=HOT_TO_STANDARD_TIME

  4. Exécutez la commande gcloud bigtable instances backups describe pour vérifier que vous avez bien mis à jour l'expiration.

        gcloud bigtable backups describe BACKUP_ID \
    --instance=INSTANCE_ID \
    --cluster=CLUSTER_ID
```

Supprimer une sauvegarde

Si vous souhaitez supprimer une sauvegarde après en avoir créé une copie, vérifiez son état pour vous assurer que l'opération de copie est terminée.

Console

  1. Accédez à la page Instances Bigtable de la console Google Cloud.

    Ouvrir la liste des instances

  2. Cliquez sur l'instance contenant la sauvegarde.

  3. Dans le volet de navigation de gauche, cliquez sur Sauvegardes.

  4. Pour supprimer la sauvegarde, développez le menu "Plus" à côté du mot Restaurer, puis cliquez sur Supprimer.

  5. Saisissez l'ID de sauvegarde dans le champ Confirmer la suppression, puis cliquez sur Supprimer.

gcloud

  1. Affichez la liste des sauvegardes en remplaçant l'ID de l'instance par INSTANCE_ID :

    gcloud bigtable backups list --instance=INSTANCE_ID

    Le terminal affiche une liste de sauvegardes.

  2. Notez l'ID de sauvegarde et l'ID du cluster sur lequel elle est stockée.

  3. Exécutez la commande gcloud bigtable instances backups delete, en remplaçant l'ID de sauvegarde que vous avez noté par BACKUP_ID et l'ID de cluster par CLUSTER_ID.

    gcloud bigtable backups delete BACKUP_ID \
  --instance=INSTANCE_ID \
  --cluster=CLUSTER_ID

Étape suivante