DROP SNAPSHOT

Note

Cette opération n’est actuellement pas couverte par le niveau de service défini dans Politique de support et accord de niveau de service de Snowflake.

Supprime un instantané d’un volume de stockage en bloc. Un instantané correspond à des données persistantes que le client paie. DROP SNAPSHOT demande à Snowflake de supprimer ces données. Les données ne sont plus utilisables en tant qu’instantané et le client ne les paie plus.

Voir aussi :

CREATE SNAPSHOT , ALTER SNAPSHOT, DESCRIBE SNAPSHOT, SHOW SNAPSHOTS

Syntaxe

DROP SNAPSHOT [ IF EXISTS ] <name>;
Copy

Paramètres

name

Spécifie l’identificateur de l’instantané à supprimer.

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

Objet

Remarques

OWNERSHIP

Instantané

OWNERSHIP is a special privilege on an object that is automatically granted to the role that created the object, but can also be transferred using the GRANT OWNERSHIP command to a different role by the owning role (or any role with the MANAGE GRANTS privilege).

Le privilège USAGE relatif à la base de données et au schéma parents est exigé pour effectuer des opérations sur tout objet d’un schéma. Notez qu’un rôle doté d’un privilège quelconque sur un schéma permet à ce rôle de résoudre le schéma. Par exemple, un rôle doté du privilège CREATE sur un schéma peut créer des objets sur ce schéma sans également avoir le privilège USAGE attribué sur ce schéma.

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

  • Lorsque la clause IF EXISTS est spécifiée et que l’objet cible n’existe pas, la commande se termine correctement, sans renvoyer d’erreur.

  • Dropping a snapshot does not immediately remove it from the system. A version of the dropped snapshot is retained in Time Travel for the number of days specified by the DATA_RETENTION_TIME_IN_DAYS parameter for the parent schema, database, or account:

    • Within the Time Travel retention period, a dropped snapshot can be restored using the UNDROP SNAPSHOT command.

    • After the Time Travel retention period, it is permanently removed; it must be recreated.

    For more information, see Période de conservation des données.

  • To immediately drop a snapshot without retention, set DATA_RETENTION_TIME_IN_DAYS to 0 at the schema level where the snapshot resides. This setting also effects the retention period for other objects within that schema.

Exemples

L’exemple suivant supprime l’instantané nommé example_snapshot :

DROP SNAPSHOT example_snapshot;
Copy
+----------------------------------------+
| status                                 |
|----------------------------------------|
| EXAMPLE_SNAPSHOT successfully dropped. |
+----------------------------------------+
Langage: Français