スキーマ：

ORGANIZATION_USAGE

COPY_HISTORY ビュー

重要

この表示は組織アカウントでのみ利用可能です。詳細については、 組織アカウントのプレミアムビュー をご参照ください。

ビューには、 Snowpipe を使用した COPY INTO <テーブル> ステートメントと連続データロードの両方のロードアクティビティが表示されます。ビューは、 LOAD_HISTORY ビュー の1万行の制限を回避します。

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

列

組織レベルの列

列名

データ型

説明

ORGANIZATION_NAME

VARCHAR

組織の名前。

ACCOUNT_LOCATOR

VARCHAR

システムが生成したアカウントの識別子。

ACCOUNT_NAME

VARCHAR

ユーザー定義のアカウント識別子。

追加列

列名

データ型

説明

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は、個別にコミットされた複数のチャンクでファイルをロードする場合があります。

使用上の注意

  • ほとんどの場合、ビューの待機時間は最大24時間です。あるテーブルのコピー履歴の遅延は、次の条件の両方が真である場合、最大2日になることがあります。

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

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

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

  • テーブルオブジェクトを削除または再作成すると、テーブルへの一括データロードにおける重複排除のため（COPY INTO <table> ステートメント）のロード履歴メタデータが削除されます。

  • テーブルオブジェクトの名前を変更すると、コピー履歴の対応する TABLE_NAME エントリが更新されます。

  • パイプオブジェクトを削除または再作成しても、パイプのロード履歴メタデータは削除されません。

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

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

例

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

SELECT account_name, file_name, error_count, status, last_load_time
  FROM snowflake.organization_usage.copy-history
  ORDER BY last_load_time desc
  LIMIT 10;
Copy
言語: 日本語