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.

The FORCE option overwrites an existing policy on a snapshot set. You can only use this option if the old policy doesn’t have a retention lock.

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

Suspend a snapshot policy in the snapshot set. You can suspend the entire snapshot policy, or only creation or expiration operations. When you specify SUSPEND SNAPSHOT POLICY without the CREATION or EXPIRATION keywords, Snowflake suspends both the creation and expiration aspects of the policy. For more information, see Suspend a backup policy on a backup set.

RESUME SNAPSHOT [ { CREATION | EXPIRATION } ] POLICY

Resume a suspended snapshot policy in the set. You can resume the entire snapshot policy, or only creation or expiration operations. When you specify RESUME SNAPSHOT POLICY without the CREATION or EXPIRATION keywords, Snowflake resumes both the creation and expiration aspects of the policy. For more information, see Resume a backup policy on a backup set.

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 Delete a backup from a backup set.

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 Legal hold. Pour des exemples d’utilisation de cette clause, voir Add and remove legal holds.

SET COMMENT = 'string_literal'

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

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

Specifies the tag name and the tag string value.

The tag value is always a string, and the maximum number of characters for the tag value is 256.

For information about specifying tags in a statement, see Tag quotas.

UNSET ...

Specifies one (or more) properties and/or parameters to unset for the snapshot set, which resets them to the defaults:

• property_name

• param_name

  • COMMENT

  • TAG tag_name [ , tag_name ... ]

You can reset multiple properties/parameters with a single ALTER statement; however, each property/parameter must be separated by a comma. Also, when resetting a property/parameter, you only specify the name; no value is required.

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;