スキーマ:

ACCOUNT_USAGE

SNOWPIPE_STREAMING_FILE_MIGRATION_HISTORY ビュー

このAccount Usageビューにより、 Snowpipe Streaming を使用して過去365日間（1年間）以内にSnowflakeテーブルに移行されたデータの履歴をクエリできます。このビューには、移行された行数とバイト数、およびSnowflakeアカウント全般で請求のあった、移行のために使用したクレジットが表示されます。

列

列名

データ型

説明

START_TIME

TIMESTAMP_LTZ

データ移行の開始時間（ローカルタイムゾーン）の範囲。

END_TIME

TIMESTAMP_LTZ

データ移行の終了時間（ローカルタイムゾーン）の範囲。

CREDITS_USED

FLOAT

START_TIME から END_TIME の時間帯にSnowpipe Streamingデータの移行に対して請求されたクレジットの数。

NUM_BYTES_MIGRATED

NUMBER

START_TIME および END_TIME ウィンドウの間に移行されたバイト数。

NUM_ROWS_MIGRATED

NUMBER

START_TIME からEND_TIME の時間帯に再クラスター化され、移行された行の数。

TABLE_ID

NUMBER

Snowpipe Streaming Clientがデータをロードするターゲットテーブルの内部/システム生成識別子。

TABLE_NAME

VARCHAR

Snowpipe Streaming Clientがデータをロードするターゲットテーブルの名前。

SCHEMA_ID

NUMBER

ターゲットテーブルが属するスキーマの内部/システム生成識別子。

SCHEMA_NAME

VARCHAR

ターゲットテーブルが属するスキーマの名前。

DATABASE_ID

NUMBER

ターゲットテーブルが属するデータベースの内部/システム生成識別子。

DATABASE_NAME

VARCHAR

ターゲットテーブルが属するデータベースの名前。

使用上の注意

  • ビューの待機時間は最大12時間です。

  • ファイルの移行は、クラスタリングまたはその他の DML 操作によって先に実行される場合があることに注意してください。移行は常に行われるとは限らないため、移行履歴は12時間経過しても空白になります。

  • NUM_BYTES_MIGRATED および NUM_ROWS_MIGRATED 列は、移行処理中に処理されたバイト数と行数のみを表示します。クラスタリングやその他の DML 操作により、一部の行やバイトが移行プロセスの外で処理されるため、これらの数はSnowpipe Streamingがテーブルに挿入した実際の行数やバイト数と一致しない場合があります。

    たとえば、Snowpipe Streamingが100万行を挿入し、テーブルには100万行がありますが、移行履歴ビューの NUM_ROWS_MIGRATED 列には80万行しか表示されません。これは、他の20万行が移行プロセスの外で処理されるためです。

例

過去365日以内にSnowpipe Streamingを使用してSnowflakeテーブルに移行されたデータの履歴をクエリします。

SELECT * FROM SNOWFLAKE.ACCOUNT_USAGE.SNOWPIPE_STREAMING_FILE_MIGRATION_HISTORY;

クエリは次の結果を返します。

+-------------------------------+-------------------------------+--------------+--------------------+------------------+----------+-----------------+------------+--------------+---------------+--------------+
| START_TIME                    | END_TIME                      | CREDITS_USED | NUM_BYTES_MIGRATED | NUM_ROWS_MIGRATED| TABLE_ID |      TABLE_NAME | SCHEMA_ID  |  SCHEMA_NAME |   DATABASE_ID | DATABASE_NAME|
|-------------------------------+-------------------------------+--------------+--------------------+------------------+----------+----------------------------------------------------------------------------|
|2023-02-08 19:00:00.000 +0000  |2023-02-08 20:00:00.000 +0000  | 0.0000325    |                 0  |                0 |  16849926| STREAMING_TABLE |   101351   |   SNOW       |  3166         |STREAMING     |
|2023-02-07 19:00:00.000 +0000  |2023-02-07 20:00:00.000 +0000  | 0.000096761  |             7,850  |               39 |  16849926| STREAMING_TABLE |   101351   |   SNOW       |  3166         |STREAMING     |
+-------------------------------+-------------------------------+--------------+--------------------+------------------+----------+-----------------+------------+--------------+---------------|--------------+