Verstehen und Verwenden von Time Travel¶

SQL-Erweiterungen für Time Travel¶

Zur Unterstützung von Time Travel wurden folgende SQL-Erweiterungen implementiert:

• AT | BEFORE-Klausel, die in SELECT-Anweisungen und CREATE…CLONE-Befehlen (unmittelbar nach dem Objektnamen) angegeben werden kann. Die Klausel verwendet einen der folgenden Parameter, um präzise die historischen Daten anzugeben, auf die Sie zugreifen möchten:

  • TIMESTAMP

  • OFFSET (Zeitdifferenz in Sekunden zur aktuellen Zeit)

  • STATEMENT (Bezeichner für Anweisung, z. B. Abfrage-ID)

• UNDROP-Befehl für Tabellen, Schemas und Datenbanken.

  

Datenaufbewahrungsfrist¶

Eine Schlüsselkomponente von Snowflake Time Travel ist die Datenaufbewahrungsfrist.

Wenn Daten in einer Tabelle geändert werden, einschließlich der Löschung der Daten oder des Objekts, das die Daten enthält, sichert Snowflake erst den Zustand der Daten, bevor die Aktualisierung durchgeführt wird. Die Datenaufbewahrungsfrist gibt die Anzahl der Tage an, für die diese historischen Daten aufbewahrt werden, sodass auf den Daten Time Travel-Operationen (SELECT, CREATE…CLONE, UNDROP) ausgeführt werden können.

Die Standardaufbewahrungsfrist beträgt 1 Tag (24 Stunden) und ist automatisch für alle Snowflake-Konten aktiviert:

• Für die Snowflake Standard Edition kann die Aufbewahrungsfrist auf Konto- und Objektebene (d. h. Datenbanken, Schemas und Tabellen) auf 0 festgelegt (oder auf den Standardwert von 1 zurückgesetzt) werden.

• Für Snowflake Enterprise Edition (und höher):

  • Für transiente Datenbanken, Schemas und Tabellen kann die Aufbewahrungsfrist auf 0 festgelegt (oder auf den Standardwert von 1 zurückgesetzt) werden. Gleiches gilt auch für temporäre Tabellen.

  • Für permanente Datenbanken, Schemas und Tabellen kann die Aufbewahrungsfrist auf einen beliebigen Wert zwischen 0 und 90 Tagen festgelegt werden.

Wenn die Aufbewahrungsfrist für ein Objekt endet, werden die historischen Daten in Snowflake Fail-safe verschoben:

• Historische Daten können nicht mehr abgefragt werden.

• Bereinigte Objekte können nicht mehr geklont werden.

• Vergangene Objekte, die fallengelassen wurden, können nicht mehr wiederhergestellt werden.

So legen Sie die Datenaufbewahrungsfrist für Time Travel fest:

• Der Objektparameter DATA_RETENTION_TIME_IN_DAYS kann von Benutzern mit der Rolle ACCOUNTADMIN verwendet werden, um die Standardaufbewahrungsfrist für Ihr Konto festzulegen.

• Der gleiche Parameter kann verwendet werden, um den Standard beim Erstellen einer Datenbank, eines Schemas und einer einzelnen Tabelle zu überschreiben.

• Die Datenaufbewahrungsfrist einer Datenbank, eines Schemas oder einer Tabelle kann jederzeit geändert werden.

• Der Kontoparameter MIN_DATA_RETENTION_TIME_IN_DAYS kann von Benutzern mit der Rolle ACCOUNTADMIN festgelegt werden, um die minimale Aufbewahrungsfrist für das Konto festzulegen. Dieser Parameter ändert oder ersetzt nicht den Wert des Parameters DATA_RETENTION_TIME_IN_DAYS. Allerdings kann sich die Änderung die effektive Datenaufbewahrungsdauer ändern. Wenn dieser Parameter auf Kontoebene eingestellt ist, wird die effektive minimale Datenaufbewahrungsfrist für ein Objekt durch MAX(DATA_RETENTION_TIME_IN_DAYS, MIN_DATA_RETENTION_TIME_IN_DAYS) bestimmt.

Gelöschte Container und Vererbung der Aufbewahrungsfristen von Objekten¶

Derzeit wird bei der Löschung einer Datenbank die Datenaufbewahrungsfrist von untergeordneten Schemas oder Tabellen nicht berücksichtigt, falls deren Frist anders als die Aufbewahrungsfrist der Datenbank ist. Die untergeordneten Schemas oder Tabellen werden so lange aufbewahrt wie die Datenbank.

Gleichermaßen wird bei der Löschung eines Schemas die Datenaufbewahrungsfrist von untergeordneten Tabellen nicht berücksichtigt, falls deren Frist anders als die Aufbewahrungsfrist des Schemas ist. Die untergeordneten Tabellen werden so lange aufbewahrt wie das Schema.

Damit die Datenaufbewahrungsfrist für diese untergeordneten Objekte (Schemas oder Tabellen) berücksichtigt wird, müssen Sie diese Objekte explizit löschen, bevor Sie die Datenbank oder das Schema löschen.

Löschen von Objekten¶

Wenn eine Tabelle, ein Schema oder eine Datenbank gelöscht wird, wird sie nicht sofort überschrieben oder aus dem System entfernt. Stattdessen wird das Objekt gemäß seiner Datenaufbewahrungsfrist aufbewahrt und kann in dieser Zeit wiederhergestellt werden. Sobald gelöschte Objekte in Fail-safe verschoben wurden, können Sie diese nicht mehr wiederherstellen.

Um eine Tabelle, ein Schema oder eine Datenbank zu löschen, verwenden Sie die folgenden Befehle:

• DROP TABLE

• DROP SCHEMA

• DROP DATABASE

Auflisten von gelöschten Objekten¶

Gelöschte Tabellen, Schemas und Datenbanken können mithilfe der folgenden Befehlen und mit dem spezifizierten Schlüsselwort HISTORY aufgelistet werden:

• SHOW TABLES

• SHOW SCHEMAS

• SHOW DATABASES

Beispiel:

SHOW TABLES HISTORY LIKE 'load%' IN mytestdb.myschema;

SHOW SCHEMAS HISTORY IN mytestdb;

SHOW DATABASES HISTORY;

Copy

Die Ausgabe enthält alle gelöschten Objekte und eine zusätzliche Spalte DROPPED_ON, die das Datum und die Uhrzeit enthält, zu der das Objekt gelöscht wurde. Wenn ein Objekt mehr als einmal gelöscht wurde, wird jede Version des Objekts als separate Zeile in die Ausgabe aufgenommen.

Wiederherstellen von Objekten¶

Ein gelöschtes Objekt, das nicht im System bereinigt wurde (d. h. das Objekt wird in der Ausgabe SHOW <Objekttyp> HISTORY angezeigt), kann mit den folgenden Befehlen wiederhergestellt werden:

• UNDROP TABLE

• UNDROP SCHEMA

• UNDROP DATABASE

Durch Aufrufen von UNDROP wird das Objekt in dem letzten Zustand vor Ausführung des DROP-Befehls wiederhergestellt.

Beispiel:

UNDROP TABLE mytable;

UNDROP SCHEMA myschema;

UNDROP DATABASE mydatabase;

Copy

Zugriffssteuerungsanforderungen und Namensauflösung¶

Ähnlich wie beim Löschen eines Objekts muss ein Benutzer OWNERSHIP-Berechtigungen für ein Objekt haben, um es wiederherstellen zu können. Darüber hinaus muss der Benutzer CREATE-Berechtigungen für den Objekttyp der Datenbank oder des Schemas haben, in dem das gelöschte Objekt wiederhergestellt werden soll.

Die Wiederherstellung von Tabellen und Schemas wird nur im aktuellen Schema oder in der aktuellen Datenbank unterstützt, auch wenn ein vollqualifizierter Objektname angegeben ist.

Beispiel: Mehrfaches Löschen und Wiederherstellen einer Tabelle¶

Im folgenden Beispiel enthält das Schema mytestdb.public die beiden Tabellen loaddata1 und proddata1. Die Tabelle loaddata1 wird zweimal gelöscht und neu erstellt, wodurch drei Versionen der Tabelle erstellt werden:

• Aktuelle Version

• Zweite (d. h. aktuelle) gelöschte Version

• Erste gelöschte Version

Das Beispiel veranschaulicht dann, wie die beiden gelöschten Versionen der Tabelle wiederhergestellt werden können:

1. Zunächst wird die aktuelle Tabelle mit dem gleichen Namen umbenannt in loaddata3. Dies ermöglicht das Wiederherstellen der neuesten Version der gelöschten Tabelle anhand des Zeitstempels.

2. Anschließend wird die zuletzt gelöschte Version der Tabelle wiederhergestellt.

3. Die wiederhergestellte Tabelle wird in loaddata2 umbenannt, um die Wiederherstellung der ersten Version der gelöschten Tabelle zu ermöglichen.

4. Schließlich wird die erste Version der gelöschten Tabelle wiederhergestellt.

SHOW TABLES HISTORY;

+---------------------------------+-----------+---------------+-------------+-------+---------+------------+------+-------+--------+----------------+---------------------------------+
| created_on                      | name      | database_name | schema_name | kind  | comment | cluster_by | rows | bytes | owner  | retention_time | dropped_on                      |
|---------------------------------+-----------+---------------+-------------+-------+---------+------------+------+-------+--------+----------------+---------------------------------|
| Tue, 17 Mar 2016 17:41:55 -0700 | LOADDATA1 | MYTESTDB      | PUBLIC      | TABLE |         |            | 48   | 16248 | PUBLIC | 1              | [NULL]                          |
| Tue, 17 Mar 2016 17:51:30 -0700 | PRODDATA1 | MYTESTDB      | PUBLIC      | TABLE |         |            | 12   | 4096  | PUBLIC | 1              | [NULL]                          |
+---------------------------------+-----------+---------------+-------------+-------+---------+------------+------+-------+--------+----------------+---------------------------------+

DROP TABLE loaddata1;

SHOW TABLES HISTORY;

+---------------------------------+-----------+---------------+-------------+-------+---------+------------+------+-------+--------+----------------+---------------------------------+
| created_on                      | name      | database_name | schema_name | kind  | comment | cluster_by | rows | bytes | owner  | retention_time | dropped_on                      |
|---------------------------------+-----------+---------------+-------------+-------+---------+------------+------+-------+--------+----------------+---------------------------------|
| Tue, 17 Mar 2016 17:51:30 -0700 | PRODDATA1 | MYTESTDB      | PUBLIC      | TABLE |         |            | 12   | 4096  | PUBLIC | 1              | [NULL]                          |
| Tue, 17 Mar 2016 17:41:55 -0700 | LOADDATA1 | MYTESTDB      | PUBLIC      | TABLE |         |            | 48   | 16248 | PUBLIC | 1              | Fri, 13 May 2016 19:04:46 -0700 |
+---------------------------------+-----------+---------------+-------------+-------+---------+------------+------+-------+--------+----------------+---------------------------------+

CREATE TABLE loaddata1 (c1 number);
INSERT INTO loaddata1 VALUES (1111), (2222), (3333), (4444);

DROP TABLE loaddata1;

CREATE TABLE loaddata1 (c1 varchar);

SHOW TABLES HISTORY;

+---------------------------------+-----------+---------------+-------------+-------+---------+------------+------+-------+--------+----------------+---------------------------------+
| created_on                      | name      | database_name | schema_name | kind  | comment | cluster_by | rows | bytes | owner  | retention_time | dropped_on                      |
|---------------------------------+-----------+---------------+-------------+-------+---------+------------+------+-------+--------+----------------+---------------------------------|
| Fri, 13 May 2016 19:06:01 -0700 | LOADDATA1 | MYTESTDB      | PUBLIC      | TABLE |         |            | 0    | 0     | PUBLIC | 1              | [NULL]                          |
| Tue, 17 Mar 2016 17:51:30 -0700 | PRODDATA1 | MYTESTDB      | PUBLIC      | TABLE |         |            | 12   | 4096  | PUBLIC | 1              | [NULL]                          |
| Fri, 13 May 2016 19:05:32 -0700 | LOADDATA1 | MYTESTDB      | PUBLIC      | TABLE |         |            | 4    | 4096  | PUBLIC | 1              | Fri, 13 May 2016 19:05:51 -0700 |
| Tue, 17 Mar 2016 17:41:55 -0700 | LOADDATA1 | MYTESTDB      | PUBLIC      | TABLE |         |            | 48   | 16248 | PUBLIC | 1              | Fri, 13 May 2016 19:04:46 -0700 |
+---------------------------------+-----------+---------------+-------------+-------+---------+------------+------+-------+--------+----------------+---------------------------------+

ALTER TABLE loaddata1 RENAME TO loaddata3;

UNDROP TABLE loaddata1;

SHOW TABLES HISTORY;

+---------------------------------+-----------+---------------+-------------+-------+---------+------------+------+-------+--------+----------------+---------------------------------+
| created_on                      | name      | database_name | schema_name | kind  | comment | cluster_by | rows | bytes | owner  | retention_time | dropped_on                      |
|---------------------------------+-----------+---------------+-------------+-------+---------+------------+------+-------+--------+----------------+---------------------------------|
| Fri, 13 May 2016 19:05:32 -0700 | LOADDATA1 | MYTESTDB      | PUBLIC      | TABLE |         |            | 4    | 4096  | PUBLIC | 1              | [NULL]                          |
| Fri, 13 May 2016 19:06:01 -0700 | LOADDATA3 | MYTESTDB      | PUBLIC      | TABLE |         |            | 0    | 0     | PUBLIC | 1              | [NULL]                          |
| Tue, 17 Mar 2016 17:51:30 -0700 | PRODDATA1 | MYTESTDB      | PUBLIC      | TABLE |         |            | 12   | 4096  | PUBLIC | 1              | [NULL]                          |
| Tue, 17 Mar 2016 17:41:55 -0700 | LOADDATA1 | MYTESTDB      | PUBLIC      | TABLE |         |            | 48   | 16248 | PUBLIC | 1              | Fri, 13 May 2016 19:04:46 -0700 |
+---------------------------------+-----------+---------------+-------------+-------+---------+------------+------+-------+--------+----------------+---------------------------------+

ALTER TABLE loaddata1 RENAME TO loaddata2;

UNDROP TABLE loaddata1;

+---------------------------------+-----------+---------------+-------------+-------+---------+------------+------+-------+--------+----------------+---------------------------------+
| created_on                      | name      | database_name | schema_name | kind  | comment | cluster_by | rows | bytes | owner  | retention_time | dropped_on                      |
|---------------------------------+-----------+---------------+-------------+-------+---------+------------+------+-------+--------+----------------+---------------------------------|
| Tue, 17 Mar 2016 17:41:55 -0700 | LOADDATA1 | MYTESTDB      | PUBLIC      | TABLE |         |            | 48   | 16248 | PUBLIC | 1              | [NULL]                          |
| Fri, 13 May 2016 19:05:32 -0700 | LOADDATA2 | MYTESTDB      | PUBLIC      | TABLE |         |            | 4    | 4096  | PUBLIC | 1              | [NULL]                          |
| Fri, 13 May 2016 19:06:01 -0700 | LOADDATA3 | MYTESTDB      | PUBLIC      | TABLE |         |            | 0    | 0     | PUBLIC | 1              | [NULL]                          |
| Tue, 17 Mar 2016 17:51:30 -0700 | PRODDATA1 | MYTESTDB      | PUBLIC      | TABLE |         |            | 12   | 4096  | PUBLIC | 1              | [NULL]                          |
+---------------------------------+-----------+---------------+-------------+-------+---------+------------+------+-------+--------+----------------+---------------------------------+

Copy