SHOW SNAPSHOT SETS¶

Répertorie tous les ensembles d’instantanés pour lesquels vous avez des privilèges d’accès. La portée de cette commande peut être votre compte entier, ou une base de données ou un schéma spécifié.

Voir aussi :: CREATE SNAPSHOT SET, ALTER SNAPSHOT SET, DROP SNAPSHOT SET

Syntaxe¶

SHOW SNAPSHOT SETS
   [ LIKE '<pattern>' ]
   [ IN { ACCOUNT | DATABASE | DATABASE <db_name> | SCHEMA | SCHEMA <schema_name> } ]

Copy

Paramètres¶

LIKE 'pattern'

(Facultatif) Filtre la sortie de commande par nom d’objet. Le filtre utilise une concordance de motif insensible à la casse avec prise en charge des caractères génériques SQL (% et _).

Par exemple, les motifs suivants donnent les mêmes résultats :

... LIKE '%testing%' ...

... LIKE '%TESTING%' ...

. Par défaut : aucune valeur (aucun filtrage n’est appliqué à la sortie).

[ IN { ACCOUNT | DATABASE | DATABASE db_name | SCHEMA | SCHEMA schema_name } ]

Si vous spécifiez le mot clé ACCOUNT, la commande récupère les enregistrements de tous les schémas de toutes les bases de données du compte courant.

Si vous spécifiez le mot clé DATABASE, alors :

Si vous spécifiez un db_name, la commande récupère les enregistrements de tous les schémas de la base de données spécifiée.
Si vous ne spécifiez pas de db_name, alors :
- S’il existe une base de données actuelle, la commande récupère les enregistrements de tous les schémas de la base de données actuelle.
- S’il n’y a pas de base de données actuelle, la commande récupère les enregistrements de toutes les bases de données et de tous les schémas du compte.

Si vous spécifiez le mot clé SCHEMA, alors :

Si vous spécifiez un nom de schéma qualifié (par exemple, my_database.my_schema), la commande récupère les enregistrements de la base de données et du schéma spécifiés.
Si vous spécifiez un schema_name non qualifié, alors :
- S’il existe une base de données actuelle, la commande récupère les enregistrements du schéma spécifié dans la base de données actuelle.
- S’il n’y a pas de base de données actuelle, la commande affiche l’erreur SQL compilation error: Object does not exist, or operation cannot be performed.
Si vous ne spécifiez pas de schema_name, alors :
- S’il existe une base de données actuelle, alors :
  - S’il existe un schéma actuel, la commande récupère les enregistrements pour le schéma actuel dans la base de données actuelle.
  - S’il n’y a pas de schéma actuel, la commande récupère les enregistrements de tous les schémas de la base de données actuelle.
- S’il n’y a pas de base de données actuelle, la commande récupère les enregistrements de toutes les bases de données et de tous les schémas du compte.

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`	Horodatage de création de l’ensemble d’instantanés.
`name`	Nom de l’ensemble d’instantanés.
`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.
`object_kind`	Type de l’objet pris en compte par l’ensemble d’instantanés.
`object_name`	Nom de l’objet pris en compte par l’ensemble d’instantanés.
`object_database_name`	Nom de la base de données qui contient l’objet pris en compte par cet ensemble d’instantanés.
`object_schema_name`	Nom du schéma contenant l’objet pris en compte par cet ensemble d’instantanés.
`snapshot_policy_name`	Nom de la politique d’instantané associée à cet ensemble d’instantanés.
`snapshot_policy_database_name`	Nom de la base de données qui contient la politique d’instantané.
`snapshot_policy_schema_name`	Nom du schéma contenant la politique d’instantané.
`comment`	Commentaire pour l’ensemble d’instantanés.
`owner`	Nom du rôle avec le privilège OWNERSHIP sur l’ensemble d’instantanés.
`owner_role_type`	Type de rôle avec le privilège OWNERSHIP sur l’ensemble d’instantanés.

Exemples¶

Répertoriez tous les ensembles d’instantanés pour lesquels vous avez des privilèges dans le compte actuel :

SHOW SNAPSHOT SETS IN ACCOUNT;

Copy

Répertoriez les ensembles d’instantanés qui incluent T1 dans le nom :

SHOW SNAPSHOT SETS LIKE '%T1%';

Copy