SHOW BACKUPS IN BACKUP SET¶

Répertorie toutes les sauvegardes dans un ensemble de sauvegardes.

Voir aussi :: CREATE BACKUP SET, ALTER BACKUP SET, SHOW BACKUP SETS

Syntaxe¶

SHOW BACKUPS IN BACKUP SET <name>
  [ LIMIT <rows> ]

Copy

Paramètres¶

name

Spécifie l’identificateur de l’ensemble de sauvegardes.

Si l’identificateur contient des espaces ou des caractères spéciaux, toute la chaîne doit être délimitée par des guillemets doubles. Les identificateurs entre guillemets doubles sont également sensibles à la casse.

Pour plus d’informations, voir Exigences relatives à l’identificateur.

LIMIT rows

(Facultatif) Limite le nombre maximum de lignes retournées, tout en permettant la « pagination » des résultats. Le nombre réel de lignes renvoyées peut être inférieur à la limite spécifiée. Par exemple, le nombre d’objets existants est inférieur à la limite spécifiée.

Par défaut : aucune valeur (aucune limite n’est appliquée à la sortie)

Exigences en matière de contrôle d’accès¶

Un rôle utilisé pour exécuter cette opération doit au minimum disposer des privilèges suivants :

Privilège	Remarques
OWNERSHIP	Vous devez avoir le privilège OWNERSHIP sur le jeu de sauvegarde pour voir les sauvegardes qu’il contient.

Pour obtenir des instructions sur la création d’un rôle personnalisé avec un ensemble spécifique de privilèges, voir Création de rôles personnalisés.

Pour des informations générales sur les rôles et les privilèges accordés pour effectuer des actions SQL sur des objets sécurisables, voir Aperçu du contrôle d’accès.

Notes sur l’utilisation¶

La commande renvoie un maximum de dix mille enregistrements pour le type d’objet spécifié, conformément aux privilèges d’accès du rôle utilisé pour exécuter la commande. Aucun enregistrement au-delà de la limite de dix mille enregistrements n’est renvoyé, même si un filtre a été appliqué.

Pour afficher les résultats pour lesquels il existe plus de dix mille enregistrements, interrogez la vue correspondante (le cas échéant) dans Schéma d’information de Snowflake.

Sortie¶

Colonne	Description
`created_on`	La sauvegarde de l’horodatage est créée.
`backup_id`	Identificateur généré par Snowflake de la sauvegarde. L’ID de la sauvegarde est une valeur UUID au format renvoyé par la fonction UUID_STRING.
`backup_set_name`	Nom de l’ensemble de sauvegarde contenant la sauvegarde.
`database_name`	Nom de la base de données contenant l’ensemble de sauvegardes.
`schema_name`	Nom du schéma contenant l’ensemble de sauvegardes.
`expire_on`	Horodatage de l’expiration de la sauvegarde.

Exemples¶

Répertorier toutes les sauvegardes dans l’ensemble de sauvegardes t1_backups:

SHOW BACKUPS IN BACKUP SET t1_backups;

Copy

Afficher la date de création et l’ID de la plus ancienne sauvegarde de l’ensemble de sauvegardes t1_backups :

SHOW BACKUPS IN BACKUP SET t1_backups ->>
  SELECT "created_on", "backup_id" FROM $1
    ORDER BY "created_on" LIMIT 1;

Copy

Afficher l’ID de la sauvegarde et la date et l’heure d’expiration de la sauvegarde finale dans l’ensemble de sauvegardes t1_backups. Cet exemple suppose que la politique des sauvegardes n’inclut pas de planification ou que la politique des sauvegardes est suspendue pour l’ensemble de sauvegardes, afin qu’aucune nouvelle sauvegarde ne soit ajouté à l’ensemble de sauvegardes. Vous attendez simplement que toutes les sauvegardes existantes expirent afin de pouvoir supprimer l’ensemble de sauvegardes.

SHOW BACKUPS IN BACKUP SET t1_backups ->>
  SELECT "expire_on", "backup_id" FROM $1
    ORDER BY "expire_on" DESC LIMIT 1;

Copy