ALTER SNAPSHOT SET

Modifie les propriétés d’un ensemble d’instantanés. Il peut s’agir de l’une des opérations suivantes :

  • Effectuer une nouvelle sauvegarde qui devient partie de l’ensemble d’instantanés.

  • Supprimer une ancienne sauvegarde de l’ensemble d’instantanés.

  • Suspendre ou reprendre les sauvegardes et les suppressions planifiées des instantanés qui sont spécifiées par la politique d’instantanés.

  • Appliquer une politique d’instantanés à un ensemble d’instantanés qui ne possède pas déjà de politique.

  • Ajouter ou supprimer une conservation légale pour un instantané spécifique dans l’ensemble d’instantanés.

  • Spécifier ou supprimer un commentaire pour l’ensemble d’instantanés.

Voir aussi :

CREATE SNAPSHOT SET, DROP SNAPSHOT SET, SHOW SNAPSHOT SETS

Syntaxe

ALTER SNAPSHOT SET <name> ADD SNAPSHOT

ALTER SNAPSHOT SET <name> APPLY SNAPSHOT POLICY <policy_name>

ALTER SNAPSHOT SET <name> SUSPEND SNAPSHOT POLICY

ALTER SNAPSHOT SET <name> RESUME SNAPSHOT POLICY

ALTER SNAPSHOT SET <name> DELETE SNAPSHOT IDENTIFIER '<snapshot_id>'

ALTER SNAPSHOT SET <name> MODIFY SNAPSHOT IDENTIFIER '<snapshot_id>' { ADD | REMOVE } LEGAL HOLD

ALTER SNAPSHOT SET <name> SET COMMENT = '<string_literal>'

ALTER SNAPSHOT SET <name> UNSET COMMENT
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.

ADD SNAPSHOT

Créez manuellement un instantané dans l’ensemble. Si la politique d’instantanés n’inclut pas de planification pour effectuer de nouvelles sauvegardes, c’est ainsi que vous effectuez une nouvelle sauvegarde de la table, du schéma ou de la base de données qui est incluse dans l’ensemble d’instantanés. Vous pouvez également effectuer de nouvelles sauvegardes dans l’ensemble d’instantanés à tout moment, même si les sauvegardes se produisent régulièrement.

APPLY SNAPSHOT POLICY policy_name

Spécifie la politique d’instantanés à associer à l’ensemble d’instantanés.

Important

L’application d’une politique d’instantanés avec un verrou de conservation à un ensemble d’instantanés est irréversible. En raison des garanties strictes nécessaires à la conformité réglementaire, après avoir placé un verrou de conservation sur un ensemble d’instantanés, vous ne pouvez plus révoquer ce verrou. Le support Snowflake ne peut pas non plus révoquer un tel verrou de conservation. Réfléchissez bien avant de définir un verrou de conservation sur un ensemble d’instantanés avec une longue période d’expiration, afin d’éviter des frais de stockage inattendus pour les ensembles d’instantanés non supprimables, ainsi que pour les schémas et les bases de données qui les contiennent.

Si une organisation Snowflake est supprimée, l’organisation n’est plus un client Snowflake. Dans ce cas, Snowflake supprime tous les instantanés, y compris ceux avec des verrous de conservation. La suppression d’une organisation Snowflake nécessite l’intervention du support Snowflake. Il ne s’agit pas d’une opération qu’un administrateur peut effectuer par accident.

SUSPEND SNAPSHOT POLICY

Suspendez une politique d’instantanés dans l’ensemble d’instantanés. Pour plus d’informations, voir Suspendre une politique d’instantané sur un ensemble d’instantanés.

RESUME SNAPSHOT POLICY

Reprenez une politique d’instantanés suspendue dans l’ensemble. Pour plus d’informations, voir Reprendre une politique d’instantané sur un ensemble d’instantanés.

DELETE SNAPSHOT IDENTIFIER 'snapshot_id'

Supprimez un instantané dans l’ensemble d’instantanés défini par ID. L’ID de l’instantané est une valeur UUID au format renvoyé par la fonction UUID_STRING. Pour plus d’informations, voir Supprimer un instantané d’un ensemble d’instantanés.

ALTER SNAPSHOT SET name MODIFY SNAPSHOT IDENTIFIER 'snapshot_id' ADD | REMOVE LEGAL HOLD

Ajoute ou supprime une suspension légale d’un instantané spécifié dans l’ensemble d’instantanés. Pour plus d’informations sur les mises en attente légales pour les instantanés WORM, voir Conservation légale. Pour des exemples d’utilisation de cette clause, voir Ajouter et supprimer des saisies légales.

SET COMMENT = 'string_literal'

Associez un commentaire à l’ensemble d’instantanés.

UNSET COMMENT

Supprimez le commentaire de l’ensemble d’instantanés.

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

Description

OWNERSHIP

Le rôle utilisé pour modifier un ensemble d’instantanés doit avoir le privilège OWNERSHIP sur l’ensemble d’instantanés.

APPLY SNAPSHOT.RETENTION.LOCK

Si la politique d’instantanés appliquée à un ensemble d’instantanés comprend un verrou de conservation, le rôle utilisé pour appliquer la politique doit disposer de ce privilège sur le compte.

APPLY LEGAL HOLD

Ce privilège de compte permet d’ajouter ou de supprimer une suspension légale d’un instantané. Ce privilège n’est nécessaire que pour les causes ADD LEGAL HOLD et REMOVE LEGAL HOLD. Par défaut, le rôle ACCOUNTADMIN dispose de ce privilège.

APPLY

Seul un utilisateur disposant de ce privilège sur la politique d’instantanés peut utiliser la commande ALTER SNAPSHOT SET avec la clause APPLY SNAPSHOT POLICY pour ajouter la politique d’instantanés à un ensemble d’instantanés qui existe déjà.

Ces privilèges sont requis sur le rôle principal actuellement actif, et non sur un rôle secondaire.

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

  • Concernant les métadonnées :

    Attention

    Les clients doivent s’assurer qu’aucune donnée personnelle (autre que pour un objet utilisateur), donnée sensible, donnée à exportation contrôlée ou autre donnée réglementée n’est saisie comme métadonnée lors de l’utilisation du service Snowflake. Pour plus d’informations, voir Champs de métadonnées dans Snowflake.

Important

Si la politique d’instantanés est associée à un verrouillage de conservation et qu’il existe des instantanés non expirés dans l’ensemble d’instantanés, vous ne pouvez pas supprimer l’ensemble d’instantanés. Dans ce cas, vous devez attendre que tous les instantanés de l’ensemble expirent. Cette restriction s’applique même aux rôles privilégiés tels que ACCOUNTADMIN, et à l’assistance Snowflake. C’est pourquoi vous devez être prudent lorsque vous spécifiez le verrouillage de conservation et une longue période d’expiration dans une politique d’instantané.

Exemples

Ajouter manuellement un instantané à l’ensemble d’instantanés t1_snapshots :

ALTER SNAPSHOT SET t1_snapshots
  ADD SNAPSHOT;
Copy

Mettre à jour la politique d’instantanés pour l’ensemble d’instantanés t1_snapshots :

ALTER SNAPSHOT SET t1_snapshots
  APPLY SNAPSHOT POLICY daily_snapshot_policy;
Copy

Suspendre une politique d’instantanés sur l’ensemble d’instantanés t1_snapshot :

ALTER SNAPSHOT SET t1_snapshots
  SUSPEND SNAPSHOT POLICY;
Copy

Reprendre une politique d’instantanés sur l’ensemble d’instantanés t1_snapshots :

ALTER SNAPSHOT SET t1_snapshots
  RESUME SNAPSHOT POLICY;
Copy

Pour trouver l’identificateur d’instantané à utiliser avec les clauses ADD LEGAL HOLD et REMOVE LEGAL HOLD, vous utilisez généralement la commande SHOW SNAPSHOTS pour répertorier les instantanés éligibles avec leur heure de création. L’exemple suivant montre comment vous pouvez répertorier les instantanés appropriés, ajouter une conservation légale à un instantané spécifique et supprimer ultérieurement cette conservation légale. Remplacez votre propre nom de rôle, le nom d’ensemble d’instantanés et l’identificateur d’instantané.

USE ROLE my_legal_hold_role; -- use a role that has the APPLY LEGAL HOLD privilege
SHOW SNAPSHOTS IN SNAPSHOT SET my_db_snapshot_set
  ->> SELECT "created_on", "snapshot_id" FROM $1 WHERE "is_under_legal_hold" = 'N';
ALTER SNAPSHOT SET my_db_snapshot_set
  MODIFY SNAPSHOT IDENTIFIER '790d1ee4-88b2-451f-9ccc-eacd1e93a134'
  ADD LEGAL HOLD;

USE ROLE my_legal_hold_role; -- use a role that has the APPLY LEGAL HOLD privilege
SHOW SNAPSHOTS IN SNAPSHOT SET my_db_snapshot_set
  ->> SELECT "created_on", "snapshot_id" FROM $1 WHERE "is_under_legal_hold" = 'Y';
ALTER SNAPSHOT SET my_db_snapshot_set
  MODIFY SNAPSHOT IDENTIFIER '790d1ee4-88b2-451f-9ccc-eacd1e93a134'
  REMOVE LEGAL HOLD;
Copy
Langage: Français