カテゴリ：

Information Schema、 テーブル関数

DBT_PROJECT_EXECUTION_HISTORY

Snowflakeでのdbtプロジェクト の実行履歴を返します。

この関数を呼び出して、現在の時刻から7日以内の過去のdbtプロジェクト実行からメタデータと結果を取得します。オプションで、結果をフィルタリングする値を指定します。

この関数を以下のシステム関数と組み合わせて使用し、プログラムでdbtのアーティファクトとログにアクセスします。

詳細については、 プログラムでdbtのアーティファクトとログにアクセスする をご参照ください。

こちらもご参照ください。

CREATE DBT PROJECT、 EXECUTE DBT PROJECT

構文

DBT_PROJECT_EXECUTION_HISTORY (
  [ OBJECT_NAME => '<name>' ]
  [ , OBJECT_TYPE = { WORKSPACE | DBT PROJECT }]
  [ , START_TIME_RANGE_START => <start_time> ]
  [ , START_TIME_RANGE_END => <end_time>  ]
  [ , RESULT_LIMIT = <integer> ]
  [ , COMMAND = <dbt_command> ]
  [ , USER_NAME = <user_name> ]
  [ , DATABASE = <db_name> ]
  [ , SCHEMA = <schema_name> ]
)
Copy

引数

OBJECT_NAME = <name>

実行が属するワークスペースまたはdbtプロジェクトの名前。

また、識別子はアルファベット文字で始まる必要があり、識別子文字列全体が二重引用符で囲まれていない限り、スペースや特殊文字を含めることはできません（例: "My object"）。二重引用符で囲まれた識別子も大文字と小文字が区別されます。

詳細については、 識別子の要件 をご参照ください。

OBJECT_TYPE = { WORKSPACE | DBT PROJECT }

実行が属するオブジェクトのタイプで、WORKSPACE またはDBT PROJECT。

START_TIME_RANGE_START | START_TIME_RANGE_END = timestamp

dbtプロジェクト実行の範囲をフィルターするためのタイムスタンプ。

RESULT_LIMIT = integer

関数によって返される行の最大数を指定する1から10,000までの整数。

デフォルト：100

COMMAND = dbt_command

dbtプロジェクトの実行に使用される dbt コマンド を指定します。

USER_NAME = user_name

dbtプロジェクトオブジェクトの実行を開始したユーザーの名前。

DATABASE = db_name

指定されたデータベースの記録のみを返します。

SCHEMA = schema_name

指定されたスキーマの記録のみを返します。

出力

この関数は、次の列を返します。

これらの列を表示するには、 MONITOR 権限を持つロールを使用する必要があります。

列名

データ型

説明

QUERY_ID

TEXT

クエリの ID。

QUERY_START_TIME

TIMESTAMP_LTZ

クエリの開始時刻。

QUERY_END_TIME

TIMESTAMP_LTZ

クエリの終了時刻。

USER_NAME

TEXT

dbtプロジェクトを作成したユーザー。

OBJECT_NAME

TEXT

実行が属しているワークスペースまたはdbtプロジェクトの名前。

OBJECT_TYPE

TEXT

WORKSPACE または DBT PROJECT などのオブジェクトの型。

DATABASE_NAME

TEXT

オブジェクトのデータベース。

SCHEMA_NAME

TEXT

オブジェクトのスキーマ。

COMMAND

TEXT

オブジェクトに対して実行されたコマンド。

ARGS

TEXT

オブジェクトの実行で使用された引数。

ERROR_CODE

NUMBER

該当する場合は、実行のエラーコード。

ERROR_MESSAGE

TEXT

該当する場合は、実行が失敗した理由を示すエラーメッセージ。

WAREHOUSE

TEXT

オブジェクトに使用されるウェアハウス。

STATE

TEXT

HANDLED_ERROR または SUCCESS などの実行の状態。

アクセス制御の要件

このテーブル関数には、以下の権限があるワークスペースおよびdbtプロジェクトからの実行のみが含まれます。

  • ワークスペースに対する OWNERSHIP または USAGE 権限

  • dbtプロジェクトに対する OWNERSHIP、USAGE または MONITOR 権限

使用上の注意

  • 正確なdbtプロジェクト名を使用します（引用符付きで作成された場合は、大文字と小文字が区別されます）。一致する行がない（dbtプロジェクト名が正しくないか、まだ実行がない）場合、Inputs may not be null. エラーが生じる可能性があります。

例

For examples of using the DBT_PROJECT_EXECUTION_HISTORY テーブル関数の使用例については、 プログラムでdbtのアーティファクトとログにアクセスする をご参照ください。

言語: 日本語