ALTER BACKUP POLICY¶

Syntax¶

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

Parameter¶

name

Gibt den Bezeichner für die Backup-Richtlinie an.

Wenn der Bezeichner Leerzeichen oder Sonderzeichen enthält, muss die gesamte Zeichenfolge in doppelte Anführungszeichen gesetzt werden. Bei Bezeichnern, die in doppelte Anführungszeichen eingeschlossen sind, ist auch die Groß- und Kleinschreibung zu beachten.

Weitere Informationen dazu finden Sie unter Anforderungen an Bezeichner.

RENAME TO new_name

Gibt den neuen Bezeichner für die Backup-Richtlinie an. Dieser muss für Ihr Konto eindeutig sein.

Weitere Informationen dazu finden Sie unter Anforderungen an Bezeichner.

SET...

Gibt eine oder mehrere Eigenschaften an, die für die Backup-Richtlinie festgelegt werden sollen (getrennt durch Leerzeichen, Kommas oder Neue-Zeile-Zeichen):

COMMENT = 'string_literal'

Gibt einen Kommentar für die Backup-Richtlinie an.

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

Gibt den Zeitplan für das Erstellen von Backups eines Objekts an.

Bemerkung

Der Mindestzeitplan für Backups beträgt 60 Minuten, d. h. 1 Stunde.

Jede Richtlinie muss eine SCHEDULE-Klausel, eine EXPIRE_AFTER_DAYS-Klausel oder beides enthalten.

• USING CRON expr time_zone

  Gibt einen Cron-Ausdruck und eine Zeitzone für den Zeitpunkt an, zu dem ein Backup eines Objekts erstellt wird. Unterstützt eine Teilmenge der Standardsyntax des Cron-Dienstprogramms.

  Eine Liste der Zeitzonen finden Sie unter List of tz database time zones (Liste der Zeitzonen aus der IANA-Zeitzonen-Datenbank) (Wikipedia).

  Der Cron-Ausdruck besteht aus folgenden Feldern:

  # __________ 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)
  # | | | | |
  # | | | | |
    * * * * *
  

  Folgende Sonderzeichen werden unterstützt:

  *

  Platzhalter. Gibt jedes vorkommende Feld an.

  L

  Steht für „last“ (letzte). Bei Verwendung im Wochentag-Feld können Sie Konstrukte wie „den letzten Freitag“ („5L“) eines bestimmten Monats angeben. Im Feld Tag des Monats wird der letzte Tag des Monats angegeben.

  /n

  Gibt die n-te Instanz einer bestimmten Zeiteinheit an. Jeder Zeitanteil wird unabhängig berechnet. Wenn beispielsweise im Monatsfeld 4/3 angegeben ist, ist das Backup für April, Juli und Oktober geplant (d. h. alle 3 Monate, beginnend ab dem 4. Monat des Jahres). In den Folgejahren wird derselbe Zeitplan beibehalten. Das heißt, das Backup ist nicht für eine Ausführung im Januar (3 Monate nach der Oktober-Ausführung) geplant.

  Bemerkung

  • Der Cron-Ausdruck wird derzeit nur für die angegebene Zeitzone ausgewertet. Das Ändern des TIMEZONE-Parameterwerts für das Konto (oder das Festlegen des Werts auf Benutzer- oder Sitzungsebene) führt nicht zur Änderung der Zeitzone des Backups.

  • Der Cron-Ausdruck definiert alle gültigen Ausführungszeiten für das Backup. Snowflake versucht, ein Backup auf der Grundlage dieses Zeitplans zu erstellen. Eine gültige Laufzeit wird jedoch übersprungen, wenn ein vorheriger Lauf nicht vor dem Start der nächsten gültigen Laufzeit abgeschlossen wurde.

  • Wenn sowohl ein bestimmter Tag des Monats als auch ein bestimmter Wochentag im Cron-Ausdruck enthalten sind, wird das Backup an Tagen geplant, die entweder dem Tag des Monats oder dem Wochentag entsprechen. Beispielsweise plant SCHEDULE = 'USING CRON 0 0 10-20 * TUE,THU UTC' ein Backup um 0AM (0:00 Uhr) an jedem 10. bis 20. Tag des Monats und auch an jedem Dienstag oder Donnerstag außerhalb dieser Tage.

• num MINUTE oder num MINUTES

  Gibt ein Intervall (in Minuten) der Wartezeit zwischen den Backups an. Akzeptiert nur positive ganze Zahlen.

  Unterstützt auch die Syntax num M.

• num HOUR oder num HOURS

  Gibt das Warteintervall (in Stunden) zwischen zwei Backups an. Akzeptiert nur positive ganze Zahlen.

  Unterstützt auch die Syntax num H.

Um Mehrdeutigkeiten zu vermeiden, wird in den folgenden Fällen eine Basisintervallzeit festgelegt:

• Wenn das Objekt erstellt wird (mit CREATE BACKUP SET … WITH BACKUP POLICY).

• Wenn ein anderes Intervall eingerichtet wird (mit ALTER BACKUP SET … APPLY BACKUP POLICY oder ALTER BACKUP POLICY … SET SCHEDULE).

Die Basisintervallzeit startet den Intervallzähler ab der aktuellen Uhrzeit. Wenn beispielsweise ein INTERVAL-Wert von 10 MINUTES festgelegt ist und das geplante Backup um 9:03 Uhr AM aktiviert ist, dann werden die nächsten Backups um 9:13 Uhr AM, 9:23 AM und so weiter erstellt. Beachten Sie, dass wir uns nach besten Kräften bemühen, absolute Präzision sicherzustellen. Dennoch garantieren wir aber nur, dass Backups nicht vor ihrem festgelegten Intervall ausgeführt werden (im aktuellen Beispiel könnte es also sein, dass das Backup erst um 9:14 Uhr ausgeführt wird, aber definitiv nicht um 9:12 Uhr).

EXPIRE_AFTER_DAYS = days_integer

Gibt die Anzahl der Tage bis zum Ablaufen des Backups an. Snowflake löscht automatisch abgelaufene Backups. Wenn dieser Parameter nicht angegeben wird, verbleiben die Backups im Backup-Set, bis sie manuell aus dem Satz gelöscht werden.

• Mindestwert: 1

• Höchstwert: 3653 (etwa 10 Jahre), wenn Sie keine SCHEDULE-Klausel angeben.

Bemerkung

Wenn die Richtlinie über eine Aufbewahrungssperre verfügt, können Sie den EXPIRE_AFTER_DAYS-Wert erhöhen, aber nicht verringern.

Jede Richtlinie muss eine SCHEDULE-Klausel, eine EXPIRE_AFTER_DAYS-Klausel oder beides enthalten.

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

Gibt den Namen des Tags und den Wert der Tag-Zeichenfolge an.

Der Tag-Wert ist immer eine Zeichenfolge, die maximale 256 Zeichen lang sein kann.

Weitere Informationen zur Angabe von Tags in einer Anweisung finden Sie unter Tag quotas.

UNSET...

Deaktivieren Sie eine der folgenden Eigenschaften für die Backup-Richtlinie. Die Eigenschaft wird auf ihren Standardwert zurückgesetzt.

• COMMENT

• TAG tag_name [ , tag_name ... ]

• SCHEDULE

• EXPIRE_AFTER_DAYS

Bemerkung

Sie können die SCHEDULE-Eigenschaft oder die EXPIRE_AFTER_DAYS-Eigenschaft deaktivieren, aber nicht beide. Sie könnten zum Beispiel die EXPIRE_AFTER_DAYS-Eigenschaft beibehalten, wenn Sie keine neuen Backups erstellen möchten, aber vorhandene Backups nach einer bestimmten Zeit ablaufen sollen.

Anforderungen an die Zugriffssteuerung¶

Eine Rolle, die zur Ausführung dieser Operation verwendet wird, muss mindestens die folgenden Berechtigungen haben:

Eine Anleitung zum Erstellen einer kundenspezifischen Rolle mit einer bestimmten Gruppe von Berechtigungen finden Sie unter Erstellen von kundenspezifischen Rollen.

Allgemeine Informationen zu Rollen und Berechtigungen zur Durchführung von SQL-Aktionen auf sicherungsfähigen Objekten finden Sie unter Übersicht zur Zugriffssteuerung.

Nutzungshinweise¶

Metadaten:

Beispiele¶

Fügen Sie der Backup-Richtlinie hourly_backup_policy einen Kommentar hinzu:

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

Änderung des Zeitplans für die Backup-Richtlinie every_two_hours:

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

Zurücksetzen der EXPIRE_AFTER_DAYS-Eigenschaft auf den Standardwert:

ALTER BACKUP POLICY sample_backup_policy UNSET EXPIRE_AFTER_DAYS;