SHOW SNAPSHOTS IN SNAPSHOT SET

Répertorie tous les :doc:`instantanés </user-guide/snapshots>`dans un ensemble d’instantanés.

Voir aussi :

CREATE SNAPSHOT SET, ALTER SNAPSHOT SET, SHOW SNAPSHOT SETS

Syntaxe

SHOW SNAPSHOTS IN SNAPSHOT SET <name>
Copy

Paramètres

name

Spécifie l’identificateur de l’ensemble d’instantanés.

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.

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 l’instantané pour voir les instantanés 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

L’instantané d’horodatage est créé.

snapshot_id

Identificateur généré par Snowflake de l’instantané. L’ID de l’instantané est une valeur UUID au format renvoyé par la fonction UUID_STRING.

snapshot_set_name

Nom de l’ensemble d’instantanés contenant l’instantané.

database_name

Nom de la base de données contenant l’ensemble d’instantanés.

schema_name

Nom du schéma contenant l’ensemble d’instantanés.

expire_on

Horodatage lors de l’expiration de l’instantané.

Exemples

Répertorier tous les instantanés dans l’ensemble d’instantanés t1_snapshots :

SHOW SNAPSHOTS IN SNAPSHOT SET t1_snapshots;
Copy

Afficher la date de création et l’ID d’instantané pour l’instantané le plus ancien de l’ensemble d’instantanés t1_snapshots :

SHOW SNAPSHOTS IN SNAPSHOT SET t1_snapshots ->>
  SELECT "created_on", "snapshot_id" FROM $1
    ORDER BY "created_on" LIMIT 1;
Copy

Affichez l’ID d’instantané et la date et l’heure lors de l’expiration de l’instantané final dans l’ensemble d’instantané t1_snapshots. Cet exemple suppose que la politique des instantanés n’inclut pas de planification ou que la politique des instantanés est suspendue pour l’ensemble d’instantanés, de sorte qu’aucun nouvel instantané ne soit ajouté à l’ensemble d’instantanés. Vous attendez simplement que tous les instantanés existants expirent afin de pouvoir supprimer l’ensemble d’instantanés.

SHOW SNAPSHOTS IN SNAPSHOT SET t1_snapshots ->>
  SELECT "expire_on", "snapshot_id" FROM $1
    ORDER BY "expire_on" DESC LIMIT 1;
Copy
Langage: Français