ALTER BACKUP SET¶

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

Effectuer une nouvelle sauvegarde qui devient partie de l’ensemble de sauvegardes.
Suppression d’une ancienne sauvegarde de l’ensemble de sauvegardes.
Suspendre ou reprendre les sauvegardes et les suppressions planifiées des sauvegardes qui sont spécifiées par la politique de sauvegarde.
Application d’une politique de sauvegarde à un ensemble de sauvegardes qui ne possède pas déjà de politique.
Ajout ou suppression d’une conservation légale pour une sauvegarde spécifique dans l’ensemble de sauvegardes.
Renaming the backup set.
Spécifier ou supprimer un commentaire pour l’ensemble de sauvegardes.

Voir aussi :: CREATE BACKUP SET, DROP BACKUP SET, SHOW BACKUP SETS

Syntaxe¶

ALTER BACKUP SET <name> ADD BACKUP

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

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

ALTER BACKUP SET <name> RESUME BACKUP [ { CREATION | EXPIRATION } ] POLICY

ALTER BACKUP SET <name> DELETE BACKUP IDENTIFIER '<backup_id>'

ALTER BACKUP SET <name> MODIFY BACKUP IDENTIFIER '<backup_id>' { ADD | REMOVE } LEGAL HOLD

ALTER BACKUP SET <name> RENAME TO <new_name>

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

ALTER BACKUP SET <name> UNSET COMMENT

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

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

Copy

Paramètres¶

name

Spécifie l’identificateur de l’ensemble de sauvegardes.

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 BACKUP

Créez manuellement une sauvegarde dans l’ensemble. Si la politique de sauvegarde 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 de sauvegardes. Vous pouvez également effectuer de nouvelles sauvegardes dans l’ensemble de sauvegardes à tout moment, même si les sauvegardes se produisent régulièrement.

APPLY BACKUP POLICY policy_name [ FORCE ]

Spécifie la politique de sauvegarde à associer à l’ensemble de sauvegardes.

L’option FORCE remplace une politique existante sur un ensemble de sauvegardes. Vous ne pouvez utiliser cette option que si l’ancienne politique n’a pas de verrou de conservation.

Important

L’application d’une politique de sauvegarde avec un verrou de conservation à un ensemble de sauvegardes 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 de sauvegardes, 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 de sauvegardes avec une longue période d’expiration, afin d’éviter des frais de stockage inattendus pour les ensembles de sauvegardes 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 toutes les sauvegardes, y compris celles 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 BACKUP [ { CREATION | EXPIRATION } ] POLICY

Suspendre une politique de sauvegarde dans l’ensemble de sauvegardes. Vous pouvez suspendre l’ensemble de la politique de sauvegarde ou seulement les opérations de création ou d’expiration. Lorsque vous spécifiez SUSPEND BACKUP 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 BACKUP [ { CREATION | EXPIRATION } ] POLICY

Réactiver une politique de sauvegarde suspendue dans l’ensemble. Vous pouvez réactiver l’ensemble de la politique de sauvegarde ou seulement les opérations de création ou d’expiration. Lorsque vous spécifiez RESUME BACKUP POLICY sans les mots-clés CREATION ou EXPIRATION, Snowflake réactive 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 BACKUP IDENTIFIER 'backup_id'

Supprimer une sauvegarde dans l’ensemble de sauvegardes défini par l’ID. L’ID de la sauvegarde est une valeur UUID au format renvoyé par la fonction UUID_STRING. Snowflake ne permet de supprimer que la sauvegarde la plus ancienne de l’ensemble de sauvegardes. Pour plus d’informations, voir Supprimer une sauvegarde d’un ensemble de sauvegardes.

MODIFY BACKUP IDENTIFIER 'backup_id' { ADD | REMOVE } LEGAL HOLD

Ajoute ou supprime une suspension légale d’une sauvegarde spécifiée dans l’ensemble de sauvegardes. Pour plus d’informations sur les suspensions légales pour les sauvegardes WORM, voir Conservation légale. Pour des exemples d’utilisation de cette clause, voir Ajouter et supprimer des saisies légales.

RENAME TO new_name

Specifies a new identifier for the backup set; must be unique for your account.

Pour plus d’informations, voir Exigences relatives à l’identificateur.

SET COMMENT = 'string_literal'

Associer un commentaire à l’ensemble de sauvegardes.

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 de sauvegardes, 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 :

Privilège	Description
OWNERSHIP	Le rôle utilisé pour modifier un ensemble de sauvegarde doit disposer du privilège OWNERSHIP sur l’ensemble de sauvegardes.
APPLY BACKUP RETENTION LOCK	Si la politique de sauvegardes appliquée à un ensemble de sauvegardes 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’une sauvegarde. 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 de sauvegarde peut utiliser la commande ALTER BACKUP SET avec la clause APPLY BACKUP POLICY pour ajouter la politique de sauvegarde à un ensemble de sauvegardes 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 de sauvegarde est associée à un verrou de conservation et qu’il existe des sauvegardes non expirées dans l’ensemble de sauvegardes, vous ne pouvez pas supprimer l’ensemble de sauvegardes. Dans ce cas, vous devez attendre que toutes les sauvegardes 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 verrou de conservation et une longue période d’expiration dans une politique de sauvegarde.

Exemples¶

Ajouter manuellement une sauvegarde à l’ensemble de sauvegardes t1_backups :

ALTER BACKUP SET t1_backups
  ADD BACKUP;

Copy

Mettre à jour la politique de sauvegarde pour l’ensemble de sauvegardes t1_backups :

ALTER BACKUP SET t1_backups
  APPLY BACKUP POLICY daily_backup_policy;

Copy

Suspendre une politique de sauvegarde sur l’ensemble de sauvegardes t1_backup :

ALTER BACKUP SET t1_backups
  SUSPEND BACKUP POLICY;

Copy

Réactiver une politique de sauvegarde sur l’ensemble de sauvegardes t1_backups :

ALTER BACKUP SET t1_backups
  RESUME BACKUP POLICY;

Copy

Rename the backup set t1_backups to table1_backups:

ALTER BACKUP SET t1_backups
  RENAME TO table1_backups;

Copy

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

USE ROLE my_legal_hold_role; -- use a role that has the APPLY LEGAL HOLD privilege
SHOW BACKUPS IN BACKUP SET my_db_backup_set
  ->> SELECT "created_on", "backup_id" FROM $1 WHERE "is_under_legal_hold" = 'N';
ALTER BACKUP SET my_db_backup_set
  MODIFY BACKUP 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 BACKUPS IN BACKUP SET my_db_backup_set
  ->> SELECT "created_on", "backup_id" FROM $1 WHERE "is_under_legal_hold" = 'Y';
ALTER BACKUP SET my_db_backup_set
  MODIFY BACKUP IDENTIFIER '790d1ee4-88b2-451f-9ccc-eacd1e93a134'
  REMOVE LEGAL HOLD;

Copy