スキーマ:: 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 <table> ステートメント）のロード履歴メタデータが削除されます。
テーブルオブジェクトの名前を変更すると、コピー履歴の対応する TABLE_NAME エントリが更新されます。
パイプオブジェクトを削除または再作成しても、パイプのロード履歴メタデータは削除されません。
ビューには、セッションの現在のロールにアクセス権限が付与されているオブジェクトのみが表示されます。
コピー履歴の複製後、 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