スキーマ:

ACCOUNT_USAGE

TASK_HISTORY ビュー

このAccount Usageビューでは、過去365日(1年)の タスク の使用履歴を取得できます。ビューには、履歴のタスクの実行1回ごとに1行が表示されます。

列名

データ型

説明

NAME

TEXT

タスクの名前。

QUERY_TEXT

TEXT

SQL ステートメントのテキスト。

CONDITION_TEXT

TEXT

実行するかどうかを決定するときにタスクが評価する WHEN 条件のテキスト。

SCHEMA_NAME

TEXT

タスクを含むスキーマの名前。

TASK_SCHEMA_ID

NUMBER

タスクを含むスキーマの内部/システム生成識別子。

DATABASE_NAME

TEXT

タスクを含むデータベースの名前。

TASK_DATABASE_ID

NUMBER

タスクを含むデータベースの内部/システム生成識別子。

SCHEDULED_TIME

TIMESTAMP_LTZ

タスクが実行を開始する/スケジュールされた時刻です。絶対精度を確保するために最善を尽くしますが、スケジュールされた時間の にタスクが実行されないことを保証するのみです。

COMPLETED_TIME

TIMESTAMP_LTZ

タスクが完了した時刻。

STATE

TEXT

完了したタスクのステータス: SUCCEEDED、 FAILED、 CANCELLED、または SKIPPED。ビューは SCHEDULED または EXECUTING タスクの実行を 返さない ことに注意してください。スケジュールされた状態または実行状態にある実行のタスク履歴の詳細を取得するには、Information Schemaの TASK_HISTORY テーブル関数をクエリします。

RETURN_VALUE

TEXT

タスクの DAG 内の先行タスクに設定された値です。戻り値は、先行タスクで SYSTEM$SET_RETURN_VALUE 関数を呼び出すことにより、明示的に設定されます。

QUERY_ID

TEXT

タスクによって実行された SQL ステートメントのID。ステートメントまたはストアドプロシージャの実行に関する追加の詳細は、 QUERY_HISTORY ビューと結合できます。

QUERY_START_TIME

TIMESTAMP_LTZ

タスク定義のクエリの実行が開始された時刻。このタイムスタンプは、 QUERY_HISTORY によって返されるクエリの開始時間と一致します。

ERROR_CODE

NUMBER

ステートメントがエラーを返した場合のエラーコード。

ERROR_MESSAGE

TEXT

ステートメントがエラーを返した場合のエラーメッセージ。

GRAPH_VERSION

NUMBER

実行された、または実行予定のDAGのバージョンを識別する整数。値の増分の増加は、DAG内のタスクに対する1つ以上の変更を表します。ルートタスクが( CREATE OR REPLACE TASK を使用して)再作成された場合、バージョン番号は1から再開します。

RUN_ID

NUMBER

DAG内のスタンドアロンタスクまたはルートタスクが本来実行を開始するようにスケジュールされている、またはされていた時間。形式はエポック時間(単位:ミリ秒)です。 . . 元の スケジュール時間とは、システムが同じタスクを再スケジュールして異なる時間に実行し、再試行またはロードのリバランスを行うまれなインスタンスを指します。その場合、RUN_IDは元のスケジュールされた実行時間を表示し、SCHEDULED_TIMEは再スケジュールされた実行時間を表示します。 . . RUN_ID は、再試行前に実行された現在のタスク/グラフの一意な識別子ではない可能性があります。RUN_ID の代わりとして、 GRAPH_RUN_GROUP_ID 列を使用することができます。

ROOT_TASK_ID

TEXT

DAG内のルートタスクの一意の識別子。この ID は、同じタスクの SHOW TASKS 出力にある ID 列の値と一致します。

SCHEDULED_FROM

TEXT

タスク実行を求めたメカニズム: SCHEDULE は、タスク実行がタスク定義のスケジュールによって開始されたことを示します。EXECUTE TASK タスクの実行が、 EXECUTE TASK ステートメントの実行によって開始されたことを示します。DAGにある子タスクの実行の場合、列はルートタスクの実行と同じ値を返します。

ATTEMPT_NUMBER

NUMBER

このタスクの実行を試行した回数を表す整数。初期値は1。

INSTANCE_ID

NUMBER

オブジェクトが属するインスタンスの内部/システム生成識別子。

CONFIG

TEXT

ルートタスクに設定されている場合はグラフレベルの構成を表示します。それ以外の場合は NULL を表示します。

QUERY_HASH

TEXT

正規化された SQL テキストに基づいて計算された ハッシュ値1

QUERY_HASH_VERSION

NUMBER

QUERY_HASH を計算するために使用される ロジックのバージョン1

QUERY_PARAMETERIZED_HASH

TEXT

パラメーター化されたクエリに基づいて計算された ハッシュ値1

QUERY_PARAMETERIZED_HASH_VERSION

NUMBER

QUERY_PARAMETERIZED_HASH を計算するために使用される ロジックのバージョン1

GRAPH_RUN_GROUP_ID

NUMBER

グラフ実行の識別子。グラフ実行に複数のタスク実行がある場合、各タスク実行は同じ GRAPH_RUN_GROUP_ID を表示します。GRAPH_RUN_GROUP_ID、および ATTEMPT_NUMBER の組み合わせは、グラフの実行を一意に識別するために使用できます。

BACKFILL_INFO

OBJECT

Reserved for future use. The returned value for all rows is NULL.

1(1,2,3,4)

この列は、 2023_06動作変更バンドルが有効になっている 場合にのみ表示されます。この列は、 クエリハッシュ 機能の一部です。

使用上の注意

  • ビューの遅延は最大45分です。

  • パフォーマンスを向上させるには、 COMPLETED_TIME または SCHEDULED_TIME 列でクエリをフィルターします。 セクション(このトピック内)をご参照ください。

実行された最新10件のタスク実行のレコードを取得します。

SELECT query_text, completed_time
FROM snowflake.account_usage.task_history
LIMIT 10;
Copy

過去1時間に完了したタスク実行のレコードを取得します。

SELECT query_text, completed_time
FROM snowflake.account_usage.task_history
WHERE COMPLETED_TIME > DATEADD(hours, -1, CURRENT_TIMESTAMP());
Copy