ALTER SNAPSHOT SET — Deprecated¶

Syntaxe¶

ALTER SNAPSHOT SET <name> ADD SNAPSHOT

ALTER SNAPSHOT SET <name> APPLY SNAPSHOT POLICY <policy_name> [ FORCE ]

ALTER SNAPSHOT SET <name> SUSPEND SNAPSHOT [ { CREATION | EXPIRATION } ] POLICY

ALTER SNAPSHOT SET <name> RESUME SNAPSHOT [ { CREATION | EXPIRATION } ] 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

ALTER SNAPSHOT SET <name> SET TAG <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' ... ]

ALTER SNAPSHOT SET <name> UNSET TAG <tag_name> [ , <tag_name> ... ]

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 [ FORCE ]

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

L’option FORCE remplace une politique existante sur un ensemble d’instantanés. Vous ne pouvez utiliser cette option que si l’ancienne politique n’a pas de verrou de rétention.

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 [ { CREATION | EXPIRATION } ] POLICY

Suspendez une politique d’instantanés dans l’ensemble d’instantanés. Vous pouvez suspendre l’ensemble de la politique des instantanés ou seulement les opérations de création ou d’expiration. Lorsque vous spécifiez SUSPEND SNAPSHOT POLICY sans les mots clés CREATION ou EXPIRATION, Snowflake suspend les aspects de création et d’expiration de la politique. Pour plus d’informations, voir Suspendre une politique de sauvegarde sur un ensemble de sauvegardes.

RESUME SNAPSHOT [ { CREATION | EXPIRATION } ] POLICY

Reprenez une politique d’instantanés suspendue dans l’ensemble. Vous pouvez reprendre l’intégralité de la politique des instantanés ou seulement les opérations de création ou d’expiration. Lorsque vous spécifiez RESUME SNAPSHOT POLICY sans les mots-clés CREATION ou EXPIRATION, Snowflake reprend les aspects de création et d’expiration de la politique. Pour plus d’informations, voir Reprendre une politique de sauvegarde sur un ensemble de sauvegardes.

DELETE SNAPSHOT IDENTIFIER 'snapshot_id'

Delete a snapshot in the snapshot set by ID. The snapshot ID is a UUID value, in the format returned by the UUID_STRING function. Snowflake only allows deleting the oldest snapshot from the snapshot set. For more information, see Supprimer une sauvegarde d’un ensemble de sauvegardes.

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.

TAG tag_name = 'tag_value' [ , tag_name = 'tag_value' , ... ]

Spécifie le nom de la balise et la valeur de la chaîne de la balise.

La valeur de la balise est toujours une chaîne de caractères et le nombre maximum de caractères pour la valeur de la balise est 256.

Pour plus d’informations sur la spécification des balises dans une instruction, voir Tag quotas.

UNSET ...

Spécifie les propriétés et/ou les paramètres à désactiver pour l’ensemble d’instantanés, qui les réinitialise aux valeurs par défaut :

• property_name

• param_name

  • COMMENT

  • TAG tag_name [ , tag_name ... ]

Vous pouvez réinitialiser plusieurs propriétés/paramètres avec une seule instruction ALTER ; cependant, chaque propriété/paramètre doit être séparé(e) par une virgule. De plus, lorsque vous réinitialisez une propriété/un paramètre, vous ne spécifiez que le nom ; aucune valeur n’est requise.

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 :

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.

Exemples¶

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

ALTER SNAPSHOT SET t1_snapshots
  ADD SNAPSHOT;

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;

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

ALTER SNAPSHOT SET t1_snapshots
  SUSPEND SNAPSHOT POLICY;

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

ALTER SNAPSHOT SET t1_snapshots
  RESUME SNAPSHOT POLICY;

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;