ALTER BACKUP POLICY

Modifie les propriétés d’une politique de sauvegarde. Les modifications suivantes sont prises en charge :

  • Renommer la politique.

  • Ajouter ou mettre à jour le commentaire pour la politique.

  • Modifier les paramètres de planification et d’expiration de la politique. La planification détermine la fréquence à laquelle Snowflake effectue automatiquement une sauvegarde et ajoute la sauvegarde résultante à l’ensemble de sauvegardes gouverné par la politique. La période d’expiration détermine la durée de conservation de chaque sauvegarde avant que Snowflake ne la supprime automatiquement de l’ensemble de sauvegardes associé.

  • Désactivez les propriétés de la politique afin qu’elles reviennent à leurs valeurs par défaut.

Voir aussi :

CREATE BACKUP POLICY, DROP BACKUP POLICY, SHOW BACKUP POLICIES

Syntaxe

ALTER BACKUP POLICY <name> RENAME TO <new_name>

ALTER BACKUP POLICY <name> SET
  [ COMMENT = '<string_literal>' ]
  [ SCHEDULE = '{ <num> MINUTE | <num> HOUR | USING CRON <expr> <time_zone> }' ]
  [ EXPIRE_AFTER_DAYS = <days_integer> ]

ALTER BACKUP POLICY <name> UNSET { COMMENT | SCHEDULE | EXPIRE_AFTER_DAYS }

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

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

Paramètres

name

Spécifie l’identificateur pour la politique de sauvegarde.

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.

RENAME TO new_name

Spécifie le nouvel identificateur de la politique de sauvegarde ; doit être unique pour votre compte.

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

SET...

Spécifie une ou plusieurs propriétés à définir pour la politique d’instantané (séparées par des espaces, des virgules ou de nouvelles lignes) :

COMMENT = 'string_literal'

Spécifie un commentaire pour la politique de sauvegarde.

SCHEDULE = '{ num MINUTE | num HOUR | USING CRON expr time_zone }'

Spécifie la planification de création des sauvegardes d’un objet.

Note

La planification minimale des sauvegardes est de 60 minutes ou 1 heure.

Chaque politique doit inclure une clause SCHEDULE, une clauseEXPIRE_AFTER_DAYS, ou les deux.

  • USING CRON expr time_zone

    Spécifie une expression cron et un fuseau horaire pour le moment où une sauvegarde d’un objet est créée. Prend en charge un sous-ensemble de la syntaxe standard de l’utilitaire cron.

    Pour obtenir une liste des fuseaux horaires, voir la liste des fuseaux horaires de la base de données tz (dans Wikipédia).

    L’expression cron comprend les champs suivants :

    # __________ minute (0-59)
# | ________ hour (0-23)
# | | ______ day of month (1-31, or L)
# | | | ____ month (1-12, JAN-DEC)
# | | | | __ day of week (0-6, SUN-SAT, or L)
# | | | | |
# | | | | |
  * * * * *

    Les caractères spéciaux suivants sont acceptés :

    *

    Caractère générique. Spécifie toute occurrence du champ.

    L

    Signifie « dernier ». Lorsqu’il est utilisé dans le champ du jour de la semaine, il vous permet de spécifier des constructions telles que « le dernier vendredi » (« 5L ») d’un mois donné. Dans le champ du mois, il spécifie le dernier jour du mois.

    /n

    Indique l’instance n d’une unité de temps donnée. Chaque quanta de temps est calculé indépendamment. Par exemple, si 4/3 est spécifié dans le champ du mois, la sauvegarde est planifiée pour avril, juillet et octobre (c’est-à-dire tous les 3 mois, à partir du 4e mois de l’année). Le même calendrier est maintenu les années suivantes. Autrement dit, la sauvegarde n’est pas prévue en janvier (3 mois après l’exécution d’octobre).

    Note

    • L’expression cron est actuellement évaluée par rapport au fuseau horaire spécifié. La modification de la valeur du paramètre TIMEZONE pour le compte (ou la définition de la valeur au niveau de l’utilisateur ou de la session) ne modifie pas le fuseau horaire de la sauvegarde.

    • L’expression cron définit toutes les heures d’exécution valides de la sauvegarde. Snowflake tente de créer une sauvegarde en fonction de cette planification ; toutefois, tout moment d’exécution valide est ignoré si une exécution précédente n’a pas été terminée avant le début du moment d’exécution valide suivant.

    • Lorsqu’un jour de mois et un jour de semaine spécifiques sont inclus dans l’expression cron, la sauvegarde est planifiée les jours satisfaisant le jour du mois ou le jour de la semaine. Par exemple, SCHEDULE = 'USING CRON 0 0 10-20 * TUE,THU UTC' planifie une sauvegarde à 0AM (minuit) entre le 10e et le 20e jour du mois, ainsi que le mardi ou le jeudi en dehors de ces dates.

  • num MINUTE ou num MINUTES

    Spécifie un intervalle (en minutes) de temps d’attente entre les sauvegardes. Accepte uniquement les entiers positifs.

    Prend également en charge la syntaxe num M.

  • num HOUR ou num HOURS

    Spécifie un intervalle (en heures) de temps d’attente entre les sauvegardes. Accepte uniquement les entiers positifs.

    Prend également en charge la syntaxe num H.

Pour éviter toute ambiguïté, un intervalle de base est défini dans les circonstances suivantes :

  • Lorsque l’objet est créé (à l’aide de CREATE BACKUP SET … WITH BACKUP POLICY).

  • Lorsqu’un intervalle différent est défini (avec ALTER BACKUP SET … APPLY BACKUP POLICY or ALTER BACKUP POLICY … SET SCHEDULE).

L’intervalle de base démarre le compteur d’intervalle à partir de l’heure actuelle. Par exemple, si une valeur INTERVAL de 10 MINUTES est définie et que la sauvegarde planifiée est activée à 9 h 03 AM, les sauvegardes suivantes sont créées à 9 h 13 AM, 9 h 23 AM, et ainsi de suite. Notez que nous faisons de notre mieux pour assurer une précision absolue, mais nous garantissons uniquement qu’une sauvegarde ne s’exécute pas avant l’intervalle défini. Autrement dit, dans cet exemple, la sauvegarde pourrait s’exécuter pour la première fois à 9 h 14 AM, mais ne s’exécutera certainement pas à 9 h 12 AM.

EXPIRE_AFTER_DAYS = days_integer

Spécifie le nombre de jours jusqu’à l’expiration de la sauvegarde. Snowflake supprime automatiquement les sauvegardes ayant expiré. Si ce paramètre n’est pas spécifié, les sauvegardes restent dans l’ensemble de sauvegardes jusqu’à ce qu’elles soient supprimées manuellement de l’ensemble.

  • Valeur minimale : 1

  • Valeur maximale : 3653 (environ 10 ans) si vous ne spécifiez pas la clause SCHEDULE.

Note

Si la politique possède un verrou de conservation, vous pouvez augmenter la valeur EXPIRE_AFTER_DAYS, mais vous ne pouvez pas réduire cette valeur.

Chaque politique doit inclure une clause SCHEDULE, une clauseEXPIRE_AFTER_DAYS, ou les deux.

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...

Annulez l’une des propriétés suivantes pour la politique de sauvegarde. La propriété revient à sa valeur par défaut.

  • COMMENT

  • TAG tag_name [ , tag_name ... ]

  • SCHEDULE

  • EXPIRE_AFTER_DAYS

Note

Vous pouvez annuler la définition de la propriété SCHEDULE, ou de la propriété EXPIRE_AFTER_DAYS, mais pas les deux. Par exemple, vous pouvez conserver la propriété EXPIRE_AFTER_DAYS lorsque vous n’avez pas l’intention de créer de nouvelles sauvegardes, mais que vous souhaitez que les sauvegardes existantes expirent au bout d’un certain temps.

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

Remarques

OWNERSHIP

Le rôle utilisé pour modifier une politique de sauvegarde doit avoir le privilège OWNERSHIP sur la politique de sauvegarde.

APPLY BACKUP RETENTION LOCK

Le rôle utilisé pour modifier une politique de sauvegarde avec un verrou de conservation doit avoir ce privilège sur le compte.

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

Rename the backup policy hourly_backup_policy to daily_backup_policy:

ALTER BACKUP POLICY hourly_backup_policy
  RENAME TO daily_backup_policy;
Copy

Ajouter un commentaire à la politique de sauvegarde hourly_backup_policy :

ALTER BACKUP POLICY hourly_backup_policy
  SET COMMENT = 'hourly backup expires in 90 days';
Copy

Modifier le calendrier pour la politique de sauvegarde every_two_hours :

ALTER BACKUP POLICY every_two_hours SET SCHEDULE = '120 MINUTE';
Copy

Rétablir la propriété EXPIRE_AFTER_DAYS à sa valeur par défaut :

ALTER BACKUP POLICY sample_backup_policy UNSET EXPIRE_AFTER_DAYS;
Copy
Langage: Français