スキーマ:

ACCOUNT_USAGE

COPY_HISTORY ビュー

このAccount Usageビューを使用して、過去365日（1年）のSnowflakeデータロード履歴をクエリできます。ビューには、 Snowpipe を使用した COPY INTO <テーブル> ステートメントと連続データロードの両方のロードアクティビティが表示されます。ビューは、 LOAD_HISTORY ビュー の1万行の制限を回避します。

また、 Snowsight でデータロードの詳細を表示することもできます。 コピー履歴を使用してデータロードのアクティビティをモニターする をご参照ください。

列

列名

データ型

説明

FILE_NAME

TEXT

ソースファイルの名前とファイルへの相対パス。

STAGE_LOCATION

TEXT

ソースファイルが配置されているステージの名前。

LAST_LOAD_TIME

TIMESTAMP_LTZ

ファイルのロードが終了した日時。

ROW_COUNT

NUMBER

ソースファイルからロードされた行の数。

ROW_PARSED

NUMBER

ソースファイルから解析された行数（STATUS が Load in progress の場合は NULL）。

FILE_SIZE

NUMBER

ロードされたソースファイルのサイズ。

FIRST_ERROR_MESSAGE

TEXT

ソースファイルの最初のエラー。

FIRST_ERROR_LINE_NUMBER

NUMBER

最初のエラーの行番号。

FIRST_ERROR_CHARACTER_POS

NUMBER

最初のエラー文字の位置。

FIRST_ERROR_COLUMN_NAME

TEXT

最初のエラーの列名。

ERROR_COUNT

NUMBER

ソースファイル内のエラー行の数。

ERROR_LIMIT

NUMBER

エラーの数がこの制限に達した場合、中止します。

STATUS

TEXT

ステータス: Loaded、 Load failed、 Partially loaded、または Load skipped。

TABLE_ID

NUMBER

ターゲットテーブルの内部/システム生成識別子。

TABLE_NAME

TEXT

ターゲットテーブルの名前。TABLE_NAME

TABLE_SCHEMA_ID

NUMBER

Snowflakeが生成するテーブルのスキーマの内部識別子。

TABLE_SCHEMA_NAME

TEXT

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

TABLE_CATALOG_ID

NUMBER

テーブルのデータベースの内部/システム生成識別子。

TABLE_CATALOG_NAME

TEXT

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

PIPE_CATALOG_NAME

TEXT

パイプが存在するデータベースの名前。

PIPE_SCHEMA_NAME

TEXT

パイプが存在するスキーマの名前。

PIPE_NAME

TEXT

ロードパラメーターを定義するパイプの名前。 COPY ステートメントのロードの場合は NULL 。

PIPE_RECEIVED_TIME

TIMESTAMP_LTZ

パイプ経由でロードされたファイルの INSERT リクエストが受信された日時。 COPY ステートメントロードの場合は、 NULL 。

FIRST_COMMIT_TIME

TIMESTAMP_LTZ

ファイルの最初のチャンクがコミットされた日時。Snowpipeは、個別にコミットされた複数のチャンクでファイルをロードする場合があります。

使用上の注意

  • 多くの場合、ビューの遅延は最大120分（2時間）です。あるテーブルのコピー履歴の遅延は、次の条件の両方が真である場合、最大2日になることがあります。

    • COPY_HISTORY で最後に更新されてから、特定のテーブルに追加されたステートメントが32 DML 未満。

    • COPY_HISTORY で最後に更新されてから、特定のテーブルに追加された行が100行未満。

  • ビューには、エラーの有無にかかわらず完了するまで実行された COPY INTO コマンドのみが含まれます。

  • テーブルオブジェクトをドロップまたは再作成すると、テーブルへの一括データロード（COPY INTO <テーブル> ステートメント）の履歴データがドロップされます。

  • パイプオブジェクトをドロップまたは再作成すると、パイプを使用したSnowpipeデータロードの履歴データがドロップされます。

  • ビューには、セッションの現在のロールにアクセス権限が付与されているオブジェクトのみが表示されます。

  • コピー履歴の複製後、 COPY_HISTORY Account Usageビューには、ターゲットテーブルの最新の切り捨て操作後にのみ履歴が表示されます。これは、完全なコピー履歴を表示する複製なしのビューとは異なります。

例

実行された最新の COPY INTO コマンド10のレコードを取得します。

select file_name, error_count, status, last_load_time from snowflake.account_usage.copy_history
  order by last_load_time desc
  limit 10;
Copy
言語: 日本語