動的テーブルをクローンする¶

動的テーブルを新しい動的テーブルにクローンする¶

クローンされた動的テーブルは、直接クローンされた場合でも、クローンされたデータベースやスキーマの一部としてクローンされた場合でも、デフォルトで一時停止されます。

DYNAMIC_TABLE_GRAPH_HISTORY では、これは SCHEDULING_STATE 列に CLONED_AUTO_SUSPENDED として表示されます。下流の動的テーブルも一時停止され、 UPSTREAM_CLONED_AUTO_SUSPENDED として表示されます。詳細については、 自動動的テーブル一時停止 をご参照ください。

-- Clone a dynamic table to a new dynamic table
CREATE [ OR REPLACE ] [ TRANSIENT ] DYNAMIC TABLE <name>
  CLONE <source_dynamic_table>
        [ { AT | BEFORE } ( { TIMESTAMP => <timestamp> | OFFSET => <time_difference> | STATEMENT => <id> } ) ]
  [
    COPY GRANTS
    TARGET_LAG = { '<num> { seconds | minutes | hours | days }' | DOWNSTREAM }
    WAREHOUSE = <warehouse_name>
  ]

過去の特定の時点で存在していた動的テーブルをクローンすることもできます。

CREATE DYNAMIC TABLE my_cloned_dynamic_table CLONE my_dynamic_table AT (TIMESTAMP => TO_TIMESTAMP_TZ('04/05/2013 01:02:03', 'mm/dd/yyyy hh24:mi:ss'));

詳細については、 Time Travelを使用したクローニング（データベース、スキーマ、テーブル、動的テーブル、、イベントテーブル、ストリームのみ） をご参照ください。

動的テーブルを新しいテーブルにクローンする¶

クローンテーブルは、ソースの動的テーブルと同じ列定義とデータを継承しますが、動的テーブル固有のプロパティはありません。行アクセス、マスキングポリシー、タグ、クラスタリングキー、コメントを保持します。

-- Clone a dynamic table to a new table
CREATE [ OR REPLACE ] TABLE [ IF NOT EXISTS ] <name>
CLONE <source_dynamic_table_name>
  [ { AT | BEFORE } ( { TIMESTAMP => <timestamp> | OFFSET => <time_difference> | STATEMENT => <id> } ) ]

動的テーブルを通常のテーブルにクローンする場合は、次の例外を除いて 通常のテーブルのクローニング と同じ考慮事項に従います。

• 通常のテーブルとしてクローンされるためには、ソースの動的テーブルが 初期化済み である必要があります。

• 動的 Apache Iceberg™ テーブルをクローンすることはできません。

動的テーブルのクローニングパイプラインのベストプラクティス¶

パイプラインの再初期化を避けるために、同じcloneコマンドで動的テーブルパイプラインのすべての要素をクローンします。パイプラインのすべての要素（基本テーブル、表示、動的テーブルなど）を同じスキーマまたはデータベースに統合することでこれを行うことができます。