SHOW BACKUP POLICIES

Répertorie toutes les politiques de sauvegarde de votre compte pour lesquelles vous avez des privilèges d’accès.

Voir aussi :

CREATE BACKUP POLICY, ALTER BACKUP POLICY, DROP BACKUP POLICY

Syntaxe

SHOW BACKUP POLICIES
   [ LIKE '<pattern>' ]
   [ IN { ACCOUNT | DATABASE | DATABASE <db_name> | SCHEMA | SCHEMA <schema_name> }
     [ STARTS WITH '<name_string>' ]
     [ LIMIT <rows> ]
   ]
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 ... ]

Spécifie de manière facultative la portée de la commande. Spécifie l’un des éléments suivants :

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.

STARTS WITH 'name_string'

(Facultatif) Filtre la sortie de commande en fonction des caractères qui apparaissent au début du nom de l’objet. La chaîne doit être encadrée de guillemets simples et est sensible à la casse.

Par exemple, les chaînes suivantes renvoient des résultats différents :

... STARTS WITH 'B' ...
... STARTS WITH 'b' ...

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

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)

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.

Pour déterminer si une politique de sauvegarde est associée à des ensembles de sauvegardes, utilisez la commande SHOW BACKUP SETS.

Note

La politique de sauvegarde est un objet qui se trouve dans un schéma et une base de données spécifiques. Par conséquent, la politique est répliquée, supprimée ou non, et ainsi de suite, lorsque ces opérations sont effectuées sur le schéma et la base de données qui la contiennent. Si vous ne pouvez pas supprimer la politique de sauvegarde parce qu’elle est associée à des ensembles de sauvegardes, vous ne pouvez pas non plus supprimer le schéma ou la base de données contenant la politique.

Sortie

Colonne

Description

created_on

Horodatage de création de la politique de sauvegarde.

name

Nom de la politique de sauvegarde.

database_name

Nom de la base de données contenant la politique de sauvegarde.

schema_name

Nom du schéma contenant la politique de sauvegarde.

owner

Nom du rôle disposant du privilège OWNERSHIP sur la politique de sauvegarde.

comment

Commentaire pour la politique de sauvegarde.

schedule

Planification de la création de la sauvegarde.

expire_after_days

Nombre de jours entre la création de la sauvegarde et son expiration.

has_retention_lock

Indique si la politique inclut un verrouillage de conservation.

Y si la politique possède un verrou de rétention ; N sinon.

Pour plus d’informations, voir. Verrouillage de conservation.

owner

Nom du rôle disposant du privilège OWNERSHIP sur l’ensemble de sauvegardes.

owner_role_type

Type de rôle disposant du privilège OWNERSHIP sur la politique de sauvegarde.

Exemples

Répertoriez toutes les politiques de sauvegarde pour lesquelles vous avez des privilèges dans le compte actuel :

SHOW BACKUP POLICIES IN ACCOUNT;
Copy