Time Travelの理解と使用¶

Time Travel SQL 拡張¶

Time Travelをサポートするために、次の SQL 拡張機能が実装されています。

• SELECT ステートメントおよび CREATE ... CLONE コマンドで指定できる AT | BEFORE 句（オブジェクト名の直後）。この句では、次のパラメーターのいずれかを使用して、アクセスする正確な履歴データを特定します。

  • TIMESTAMP

  • OFFSET （現在時刻との秒単位の時差）

  • STATEMENT （ステートメントの識別子。例：クエリ ID）

• テーブル、スキーマ、データベース用のUNDROP コマンド。

  

データ保持期間¶

Snowflake Time Travelの重要な要素は、データ保持期間です。

データの削除またはデータを含むオブジェクトの削除など、テーブル内のデータが変更されると、Snowflakeは更新前のデータの状態を保持します。データ保持期間は、この履歴データが保持される日数を指定するため、Time Travel操作（SELECT、CREATE ... CLONE、UNDROP）をデータに対して実行できます。

標準の保持期間は1日（24時間）であり、すべてのSnowflakeアカウントで自動的に有効になります。

• Snowflake Standard Editionの場合、アカウントおよびオブジェクトレベル（つまり、データベース、スキーマ、およびテーブル）で保持期間を0（またはデフォルトの1日に戻す）に設定できます。

• Snowflake Enterprise Edition（またはそれ以上）の場合：

  • 一時データベース、スキーマ、およびテーブルの場合、保持期間を0（またはデフォルトの1日に戻す）に設定できます。同じことが仮テーブルにも当てはまります。

  • 永続データベース、スキーマ、およびテーブルの場合、保持期間は0から90日までの任意の値に設定できます。

オブジェクトの保持期間が終了すると、履歴データは Snowflake Fail-safe に移動します。

• 履歴データはクエリに使用できなくなりました。

• 過去のオブジェクトはクローンできなくなりました。

• 削除された過去のオブジェクトは復元できなくなりました。

Time Travelのデータ保持期間を指定するには：

• ACCOUNTADMIN ロールを持つユーザーは、 DATA_RETENTION_TIME_IN_DAYS オブジェクトパラメーターを使用して、アカウントのデフォルトの保持期間を設定できます。

• データベース、スキーマ、および個々のテーブルを作成するときに、同じパラメータを使用してデフォルトを明示的に上書きできます。

• データベース、スキーマ、またはテーブルのデータ保持期間はいつでも変更できます。

• MIN_DATA_RETENTION_TIME_IN_DAYS アカウントパラメーターは、アカウントの最小保持期間を設定するための ACCOUNTADMIN ロールを持つユーザーが設定できます。このパラメーターは、 DATA_RETENTION_TIME_IN_DAYS パラメーター値を変更または置換しません。ただし、有効なデータ保持時間が変更される場合があります。このパラメーターがアカウントレベルで設定されている場合、オブジェクトの有効な最小データ保持期間は MAX （DATA_RETENTION_TIME_IN_DAYS、 MIN_DATA_RETENTION_TIME_IN_DAYS）によって決定されます。

ドロップされたコンテナとオブジェクト保持の継承¶

現在、データベースが削除されると、子スキーマまたはテーブルのデータ保持期間は、データベースの保持とは明示的に異なるように設定されている場合、尊重されません。子スキーマまたはテーブルは、データベースと同じ期間保持されます。

同様に、スキーマが削除されると、子テーブルのデータ保持期間は、スキーマの保持とは異なるように明示的に設定されている場合、尊重されません。子テーブルは、スキーマと同じ期間保持されます。

これらの子オブジェクト（スキーマまたはテーブル）のデータ保持期間を尊重するには、データベースまたはスキーマを削除する 前 に、明示的に削除します。

オブジェクトのドロップ¶

テーブル、スキーマ、またはデータベースがドロップされても、すぐに上書きされたり、システムから削除されたりすることはありません。代わりに、オブジェクトのデータ保持期間の間保持され、その間はオブジェクトを復元できます。ドロップされたオブジェクトを Fail-safe に移動すると、復元できなくなります。

テーブル、スキーマ、またはデータベースをドロップするには、次のコマンドを使用します。

• DROP TABLE

• DROP SCHEMA

• DROP DATABASE

ドロップされたオブジェクトのリスト¶

ドロップされたテーブル、スキーマ、およびデータベースは、 HISTORY キーワードを指定した以下のコマンドを使用してリストできます。

• SHOW TABLES

• SHOW SCHEMAS

• SHOW DATABASES

例:

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

SHOW SCHEMAS HISTORY IN mytestdb;

SHOW DATABASES HISTORY;

Copy

出力には、ドロップされたすべてのオブジェクトと、オブジェクトがドロップされた日時を表示する追加の DROPPED_ON 列が含まれます。オブジェクトが複数回ドロップされた場合、オブジェクトの各バージョンは出力に個別の行として含まれます。

オブジェクトの復元¶

システムからパージされていないドロップされたオブジェクト（つまり、オブジェクトは SHOW <オブジェクト型> HISTORY 出力に表示）は、次のコマンドを使用して復元できます。

• UNDROP TABLE

• UNDROP SCHEMA

• UNDROP DATABASE

UNDROP を呼び出すと、オブジェクトは DROP コマンドが実行される前の最新の状態に復元されます。

例:

UNDROP TABLE mytable;

UNDROP SCHEMA myschema;

UNDROP DATABASE mydatabase;

Copy

アクセス制御の要件と名前の解決¶

オブジェクトをドロップするのと同様に、ユーザーがオブジェクトを復元するには OWNERSHIP 権限が必要です。さらに、ユーザーには、ドロップされたオブジェクトが復元されるデータベースまたはスキーマのオブジェクトタイプに対する CREATE 権限が必要です。

テーブルとスキーマの復元は、完全修飾オブジェクト名が指定されている場合でも、現在のスキーマまたは現在のデータベースでのみサポートされます。

例: テーブルの複数回のドロップおよび復元¶

次の例では、 mytestdb.public スキーマには2つのテーブル loaddata1 と proddata1 が含まれています。 loaddata1 テーブルがドロップされて2回再作成され、テーブルの3つのバージョンが作成されます。

• 現在のバージョン

• 2番目（つまり、最新）のドロップされたバージョン

• 最初にドロップされたバージョン

次に、2つのドロップされたバージョンのテーブルを復元する方法の例を示します。

1. 最初に、同じ名前の現在のテーブルの名前が loaddata3 に変更されます。これにより、タイムスタンプに基づいて、ドロップされたテーブルの最新バージョンを復元できます。

2. 次に、最新のドロップされたバージョンのテーブルが復元されます。

3. ドロップされたテーブルの最初のバージョンを復元できるように、復元されたテーブルの名前は loaddata2 に変更されます。

4. 最後に、ドロップされたテーブルの最初のバージョンが復元されます。

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