SHOW BACKUP POLICIES¶

Listet alle Backup-Richtlinien in Ihrem Konto auf, für die Sie Zugriffsrechte haben.

Siehe auch:: CREATE BACKUP POLICY, ALTER BACKUP POLICY, DROP BACKUP POLICY

Syntax¶

SHOW BACKUP POLICIES
   [ LIKE '<pattern>' ]
   [ IN { ACCOUNT | DATABASE | DATABASE <db_name> | SCHEMA | SCHEMA <schema_name> }
     [ STARTS WITH '<name_string>' ]
     [ LIMIT <rows> ]
   ]

Copy

Parameter¶

LIKE 'pattern'

Filtert optional die Befehlsausgabe nach dem Objektnamen. Der Filter verwendet einen Musterabgleich ohne Berücksichtigung der Groß-/Kleinschreibung, aber mit Unterstützung von SQL-Platzhalterzeichen (% und _).

Die folgenden Muster geben beispielsweise die gleichen Ergebnisse zurück:

... LIKE '%testing%' ...

... LIKE '%TESTING%' ...

. Standard: Kein Wert (die Ausgabe wird nicht gefiltert).

[ IN ... ]

Gibt optional den Geltungsbereich des Befehls an. Geben Sie eine der folgenden Optionen an:

Wenn Sie das Schlüsselwort ACCOUNT angeben, ruft der Befehl Datensätze für alle Schemas in allen Datenbanken des aktuellen Kontos ab.

Wenn Sie das Schlüsselwort DATABASE angeben, dann gilt Folgendes:

Wenn Sie einen Wert für db_name angeben, ruft der Befehl Datensätze für alle Schemas der angegebenen Datenbank ab.
Wenn Sie keinen db_name angeben, dann:
- Wenn es eine aktuelle Datenbank gibt, ruft der Befehl Datensätze für alle Schemas in der aktuellen Datenbank ab.
- Wenn es keine aktuelle Datenbank gibt, ruft der Befehl Datensätze aller Datenbanken und Schemas im Konto ab.

Wenn Sie das Schlüsselwort SCHEMA angeben, dann gilt Folgendes:

Wenn Sie einen qualifizierten Schemanamen angeben (z. B. my_database.my_schema), ruft der Befehl Datensätze für die angegebene Datenbank und das angegebene Schema ab.
Wenn Sie einen nicht qualifizierten Wert für schema_name angeben, dann gilt Folgendes:
- Wenn es eine aktuelle Datenbank gibt, ruft der Befehl Datensätze für das angegebene Schema in der aktuellen Datenbank ab.
- Wenn keine aktuelle Datenbank vorhanden ist, zeigt der Befehl den Fehler SQL compilation error: Object does not exist, or operation cannot be performed an.
Wenn Sie keinen schema_name angeben, dann:
- Wenn es eine aktuelle Datenbank gibt, dann gilt Folgendes:
  - Wenn es ein aktuelles Schema gibt, dann ruft der Befehl Datensätze für das aktuelle Schema in der aktuellen Datenbank ab.
  - Wenn kein aktuelles Schema vorhanden ist, ruft der Befehl Datensätze für alle Schemas in der aktuellen Datenbank ab.
- Wenn es keine aktuelle Datenbank gibt, ruft der Befehl Datensätze für alle Datenbanken und alle Schemas im Konto ab.

STARTS WITH 'name_string'

Filtert die Befehlsausgabe optional anhand der Zeichen, die am Anfang des Objektnamens angezeigt werden. Die Zeichenfolge muss in einfache Anführungszeichen gesetzt werden, wobei zwischen Groß-/Kleinschreibung unterschieden wird.

Die folgenden Zeichenfolgen geben beispielsweise unterschiedliche Ergebnisse zurück:

... STARTS WITH 'B' ...

... STARTS WITH 'b' ...

. Standard: Kein Wert (die Ausgabe wird nicht gefiltert)

LIMIT rows

Schränkt optional die maximale Anzahl der zurückgegebenen Zeilen ein und ermöglicht gleichzeitig die „Paginierung“ der Ergebnisse. Die tatsächliche Anzahl der zurückgegebenen Zeilen kann geringer sein als das angegebene Limit. Beispielsweise ist die Anzahl der vorhandenen Objekte geringer als das angegebene Limit.

Standard: Kein Wert (die Ausgabe wird nicht begrenzt)

Nutzungshinweise¶

Der Befehl gibt maximal zehntausend Datensätze für den angegebenen Objekttyp zurück, entsprechend den Zugriffsrechten für die zur Ausführung des Befehls verwendete Rolle. Datensätze, die die Grenze von zehntausend Datensätzen überschreiten, werden nicht zurückgegeben, selbst wenn ein Filter angewendet wurde.

Um Ergebnisse anzuzeigen, für die mehr als zehntausend Datensätze existieren, fragen Sie die entsprechende Ansicht (sofern vorhanden) in Snowflake Information Schema ab.

Um festzustellen, ob eine Backup-Richtlinie mit Backup-Sets verbunden ist, verwenden Sie den Befehl SHOW BACKUP SETS.

Bemerkung

Die Backup-Richtlinie ist ein Objekt, das sich innerhalb eines bestimmten Schemas und einer bestimmten Datenbank befindet. Daher wird die Richtlinie repliziert, gelöscht oder nicht gelöscht usw., wenn diese Operationen für das Schema und die Datenbank durchgeführt werden, die sie enthalten. Wenn Sie die Backup-Richtlinie nicht löschen können, weil sie mit Backup-Sets verknüpft ist, dann können Sie auch das Schema oder die Datenbank, die die Richtlinie enthält, nicht löschen.

Ausgabe¶

Spalte	Beschreibung
`created_on`	Die Richtlinie für das Zeitstempel-Backup wurde erstellt.
`name`	Name der Backup-Richtlinie.
`database_name`	Name der Datenbank, die die Backup-Richtlinie enthält.
`schema_name`	Name des Schemas, das die Backup-Richtlinie enthält.
`owner`	Name der Rolle mit der OWNERSHIP-Berechtigung für die Backup-Richtlinie.
`comment`	Kommentar zur Backup-Richtlinie.
`schedule`	Zeitplan für die Erstellung von Backups.
`expire_after_days`	Anzahl der Tage nach der Erstellung des Backups, nach denen das Backup abläuft.
`has_retention_lock`	Gibt an, ob die Richtlinie eine Aufbewahrungssperre enthält. `Y` wenn die Richtlinie eine Aufbewahrungssperre hat; `N` andernfalls. Weitere Informationen dazu finden Sie unter Aufbewahrungssperre.
`owner`	Name der Rolle mit der OWNERSHIP-Berechtigung für das Backup-Set.
`owner_role_type`	Typ der Rolle mit der OWNERSHIP-Berechtigung für die Backup-Richtlinie.

Beispiele¶

Listen Sie alle Backup-Richtlinien auf, für die Sie im aktuellen Konto Berechtigungen haben:

SHOW BACKUP POLICIES IN ACCOUNT;

Copy