Sauvegardes Spanner Omni

Aperçu

Ce produit ou cette fonctionnalité est une offre en préversion soumise aux "Conditions des offres de pré-DG" de la section Conditions générales du service des Conditions spécifiques du service. Il ne peut être utilisé qu'à des fins de développement, de test, de prototypage et de démonstration de programmes logiciels. Il ne peut être utilisé à des fins de traitement de données ni à des fins commerciales. Les produits et fonctionnalités de pré-DG sont proposés "en l'état" et peuvent présenter une compatibilité limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

Spanner Omni vous permet de créer des sauvegardes complètes de bases de données à la demande ou à l'aide d'une planification des sauvegardes. Les sauvegardes stockent l'ensemble des données d'une base de données. Vous pouvez restaurer les sauvegardes lorsque des erreurs d'opérateur ou d'application entraînent une corruption logique des données.

Présentation des sauvegardes Spanner Omni

Les sauvegardes sont disponibilité élevée et peuvent être conservées jusqu'à un an après leur création. Chaque sauvegarde est associée à un createTime et un versionTime. Le createTime correspond à l'horodatage du moment où Spanner Omni commence à créer la sauvegarde. Le versionTime correspond à l'horodatage du moment où la sauvegarde capture le contenu de la base de données. La sauvegarde contient une vue cohérente de la base de données au versionTime.

Pour les sauvegardes à la demande, le createTime et le versionTime sont identiques par défaut. Si nécessaire, vous pouvez spécifier un versionTime plus ancien lors de la création d'une sauvegarde à la demande, s'il se trouve dans la période de conservation des versions de la base de données.

Pour les sauvegardes planifiées, le versionTime correspond à l'heure que vous choisissez lorsque vous créez la planification des sauvegardes. Spanner Omni commence à créer la sauvegarde dans les quatre heures suivant le versionTime. Le createTime se situe donc dans cette fenêtre de quatre heures. Contrairement aux sauvegardes à la demande, Spanner Omni commence à créer la sauvegarde lorsqu'il reçoit la requête.

Supposons, par exemple, que vous créez une planification des sauvegardes avec une fréquence de 0 7 * * * UTC (tous les jours à 7h00 UTC). Cela signifie que pour chaque sauvegarde, le versionTime est 7h00 UTC et le createTime est un horodatage compris dans la fenêtre de quatre heures entre 7h00 UTC et 11h00 UTC.

Principales fonctionnalités

Les sauvegardes Spanner Omni offrent une cohérence des données, une réplication externe résiliente et une expiration automatisée.

• Cohérence des données : les sauvegardes d'une base de données Spanner Omni sont transactionnelles et cohérentes en externe au versionTime de la sauvegarde.

• Réplication : les fichiers de sauvegarde sont stockés dans un système de stockage externe, en dehors du déploiement Spanner Omni.

• Expiration automatique : la date d'expiration spécifiée par l'utilisateur détermine la date de suppression de toutes les sauvegardes. Spanner Omni supprime les sauvegardes expirées de manière asynchrone. Il peut donc y avoir un décalage entre le moment où une sauvegarde expire et celui où elle est réellement supprimée.

Stockage externe

Le stockage externe représente un stockage à distance qui se trouve en dehors du déploiement Spanner Omni. Vous pouvez configurer Amazon Simple Storage Service (Amazon S3), Cloud Storage ou tout stockage compatible avec Amazon S3 comme stockage externe. Spanner Omni stocke les fichiers de sauvegarde dans ce stockage externe.

Gestion du stockage externe

Gérez le stockage externe en créant, en supprimant et en listant les emplacements de stockage de vos sauvegardes.

Créer un stockage externe

Pour créer un stockage externe Amazon S3, exécutez la commande suivante :

spanner external-storages create EXTERNAL_STORAGE_ID \
  --s3-bucket-name=BUCKET_NAME \
  --s3-region=AWS_REGION \
  --s3-assume-role-arn=ASSUME_ROLE_ARN

Créer un stockage externe Cloud Storage

Pour créer un stockage externe Cloud Storage, exécutez la commande suivante :

spanner external-storages create EXTERNAL_STORAGE_ID \
   --gcs-bucket-name=BUCKET_NAME

Créer un stockage externe compatible avec Amazon S3

Pour créer un stockage externe compatible avec Amazon S3, exécutez la commande suivante :

spanner external-storages create EXTERNAL_STORAGE_ID \
    --s3-compatible-bucket-name=BUCKET_NAME \
    --s3-compatible-endpoint=ENDPOINT \
    --s3-compatible-credential-file-path=FILE

Supprimer un stockage externe

Pour supprimer un stockage externe, assurez-vous d'abord qu'aucune sauvegarde existante ou en cours n'est présente. Exécutez ensuite la commande suivante :

spanner external-storages delete EXTERNAL_STORAGE_ID

Décrire un stockage externe

Pour obtenir des informations sur un stockage externe, exécutez la commande suivante :

spanner external-storages describe EXTERNAL_STORAGE_ID

Lister les stockages externes

Pour obtenir la liste des stockages externes, exécutez la commande suivante :

spanner external-storages list

Descripteur de sauvegarde

Un descripteur de sauvegarde représente les métadonnées et les chemins d'accès aux fichiers de sauvegarde des sauvegardes terminées stockées dans un stockage externe.

spanner external-storages backup-descriptors list EXTERNAL_STORAGE_ID

Informations sur la sauvegarde

Lorsque vous créez une sauvegarde, les métadonnées de sauvegarde sont stockées dans Spanner Omni et les fichiers de sauvegarde résident dans le stockage externe.

Une sauvegarde contient les informations suivantes de la base de données au versionTime de la sauvegarde :

• Une sauvegarde complète contient toutes les données.

• Informations sur le schéma, y compris les noms de tables, les champs, les types de données, les index secondaires, les flux de modifications et les relations entre ces entités.

• Toutes les options de base de données définies avec la commande ALTER DATABASE SET OPTIONS.

Une sauvegarde Spanner Omni n'inclut pas les informations suivantes :

• Toutes les modifications apportées aux données ou au schéma après le versionTime.

• Stratégies de Identity and Access Management (IAM).

• Enregistrements de données de flux de modifications. Bien que le schéma des flux de modifications soit stocké, les données des flux de modifications doivent être diffusées et consommées à peu près au même moment que les modifications qu'elles décrivent.

Pour garantir la cohérence externe de la sauvegarde, Spanner Omni épingle le contenu de la base de données au versionTime. Cela empêche le système de récupération de mémoire de supprimer les valeurs de données pertinentes pendant la durée de l'opération de sauvegarde.

Gestion des sauvegardes

Pour créer des sauvegardes, vous avez besoin des autorisations suivantes. Demandez à votre administrateur de vous accorder les rôles IAM suivants sur un déploiement :

Action	Rôle IAM
Créer, afficher, mettre à jour et supprimer des sauvegardes	roles/spanner.backupAdmin
Créer et afficher des sauvegardes	roles/spanner.backupWriter

Créer une sauvegarde

Créez une sauvegarde à la demande.

spanner backups create BACKUP_NAME \
--database=DATABASE_ID \
--retention-period=RETENTION_PERIOD \
--async

Supprimer une sauvegarde

Supprimez les métadonnées et les fichiers de sauvegarde.

spanner backups delete BACKUP_NAME

Décrire une sauvegarde

Récupérez des informations sur une sauvegarde.

spanner backups describe BACKUP_NAME

Répertorier des sauvegardes

Répertoriez les sauvegardes Spanner Omni existantes dans le déploiement.

spanner backups list

Mettre à jour l'expiration d'une sauvegarde

Mettez à jour la date d'expiration d'une sauvegarde.

spanner backups update-metadata BACKUP_NAME \
--expiration-date=EXPIRATION_DATE

Importer une sauvegarde

Si vous supprimez accidentellement un déploiement, vous pouvez importer des sauvegardes à partir de celui-ci si vous n'avez pas supprimé les fichiers de sauvegarde du stockage externe.

1. Créez un stockage externe dans le nouveau déploiement qui utilise le même bucket Amazon S3 ou Cloud Storage que le déploiement d'origine.

   spanner external-storages create EXTERNAL_STORAGE_ID \
     --gcs-bucket-name=BUCKET_NAME
   

2. Répertoriez les descripteurs de sauvegarde dans le stockage externe.

   spanner external-storages backup-descriptors list EXTERNAL_STORAGE_ID
   

3. Sélectionnez le descripteur de sauvegarde et importez-le dans le nouveau déploiement.

   spanner backups import BACKUP_NAME \
    --external-storage EXTERNAL_STORAGE_ID \
    --backup-descriptor BACKUP_DESCRIPTOR \
    --retention-period 24h
   

Planifications de sauvegarde

Spanner Omni vous permet de planifier des sauvegardes complètes pour les bases de données. Vous pouvez spécifier la fréquence à laquelle Spanner Omni crée des sauvegardes dans la planification.

Une planification de sauvegarde complète crée des sauvegardes toutes les 12 heures ou plus. Les sauvegardes démarrent dans une fenêtre de 30 minutes après l'heure programmée. Vous pouvez avoir un maximum de quatre planifications de sauvegarde par base de données.

Remarque : Les planifications de sauvegarde des bases de données nouvellement créées mettent jusqu'à 24 heures pour devenir actives et commencer à créer des sauvegardes.

Gestion des planifications de sauvegarde

Pour créer et gérer des planifications de sauvegarde, vous avez besoin des autorisations suivantes. Demandez à votre administrateur de vous accorder les rôles IAM suivants sur le déploiement :

• Créer, afficher, mettre à jour et supprimer des planifications de sauvegarde : roles/spanner.backupAdmin

• Créer et afficher des planifications de sauvegarde : roles/spanner.backupWriter

Créer une planification de sauvegarde

Créez une planification de sauvegarde pour la base de données Spanner Omni.

spanner backup-schedules create SCHEDULE_ID \
  --database=DATABASE_ID \
  --retention-duration=RETENTION_DURATION \
  --cron="CRONTAB_EXPRESSION"

Obtenir une planification de sauvegarde

Obtenez des informations sur une planification de sauvegarde spécifique.

spanner backup-schedules describe SCHEDULE_ID --database=DATABASE_ID

Répertorier les planifications de sauvegarde

Répertoriez toutes les planifications de sauvegarde d'une base de données donnée.

spanner backup-schedules list --database=DATABASE_ID

Mettre à jour une planification de sauvegarde

Mettez à jour les propriétés d'une planification de sauvegarde existante.

spanner backup-schedules update SCHEDULE_ID \
  --database=DATABASE_ID \
  --retention-duration=RETENTION_DURATION \
  --cron="CRONTAB_EXPRESSION"

Supprimer une planification de sauvegarde

Supprimez une planification de sauvegarde de la base de données.

spanner backup-schedules delete SCHEDULE_ID --database=DATABASE_ID

Définir une stratégie de contrôle des accès IAM

Définissez la stratégie de contrôle des accès IAM pour une planification de sauvegarde.

spanner backup-schedules set-iam-policy SCHEDULE_ID \
  --database=DATABASE_ID \
  policy.json

Obtenir une stratégie de contrôle des accès IAM

Obtenez la stratégie de contrôle des accès IAM pour une planification de sauvegarde.

spanner backup-schedules get-iam-policy SCHEDULE_ID --database=DATABASE_ID

Comparaison du stockage des sauvegardes et du stockage des bases de données

La taille de stockage d'une sauvegarde peut être inférieure ou supérieure à celle de la base de données source au moment de sa création.

Le stockage d'une sauvegarde peut être inférieur à celui de la base de données, car une sauvegarde ne contient qu'une seule version des données, tandis que la base de données active peut en contenir plusieurs en raison des opérations en cours. Les différences de format de données et de compression peuvent également entraîner une taille de sauvegarde plus petite.

À l'inverse, le stockage d'une sauvegarde peut être supérieur à celui de la base de données, en fonction de l'état de la base de données et du moment où vous créez la sauvegarde.

Pour des raisons similaires, lorsque vous restaurez une base de données à partir d'une sauvegarde, son stockage peut être supérieur à celui de la base de données. Cela peut se produire si un grand ensemble de données a été supprimé et compacté après la création de la sauvegarde. Par conséquent, la taille de la sauvegarde dépend du moment où elle a été créée et des opérations ultérieures sur la base de données.

Aucune formule ne permet de prédire la taille d'une sauvegarde par rapport à la base de données active. Pour une base de données avec un taux d'écriture élevé (une base de données active), la sauvegarde est probablement plus petite que la base de données active. Toutefois, dans certains cas, la taille de la sauvegarde peut être supérieure.