スキーマ:

ACCOUNT_USAGE

COMPLETE_TASK_GRAPHS ビュー

このAccount Usageビューを使用して、完了した グラフ 実行(つまり、正常に実行された、失敗した、またはキャンセルされた実行)のステータスをクエリできます。グラフは現在、単一のスケジュールされたタスク または スケジュールされたルートタスクと1つ以上の子タスク(つまり、定義された先行タスクを持つタスク)で構成されるタスクの DAG として定義されています。この関数の目的上、 ルートタスク は、単一のスケジュールされたタスク、またはDAG内のルートタスクのいずれかを指します。

ビューは、 COMPLETE_TASK_GRAPHS の10、000行の制限を回避します。

列名

データ型

説明

ROOT_TASK_NAME

TEXT

ルートタスクの名前。

DATABASE_NAME

TEXT

グラフを含むデータベースの名前。

SCHEMA_NAME

TEXT

グラフを含むスキーマの名前。

STATE

TEXT

グラフ実行の状態:

  • SUCCEEDED: グラフ内のすべてのタスクが正常に実行されて完了するか、ルートタスク実行に成功し、1つ以上の子タスク実行がスキップされました。

  • FAILED: グラフ内の1つ以上のタスク実行に失敗したか、ルートタスク実行に成功し、1つ以上の子タスク実行に失敗しました。

  • CANCELLED: グラフ内の1つ以上のタスク実行がキャンセルされたか、ルートタスク実行に成功し、1つ以上の子タスク実行がキャンセルされました。

ルートタスク実行の状態が SKIPPED の場合、関数は実行の行を返さないことに注意してください。

FIRST_ERROR_TASK_NAME

TEXT

エラーを返したグラフにある最初のタスクの名前。エラーが発生したタスクがない場合は、 NULL を返します。

FIRST_ERROR_CODE

NUMBER

FIRST_ERROR_TASK_NAME で名前を付けられたタスクによって返されるエラーのエラーコード。エラーが発生したタスクがない場合は NULL を返します。

FIRST_ERROR_MESSAGE

TEXT

FIRST_ERROR_TASK_NAME で名前を付けられたタスクによって返されるエラーのエラーメッセージ。エラーが発生したタスクがない場合は NULL を返します。

SCHEDULED_TIME

TIMESTAMP_LTZ

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

QUERY_START_TIME

TIMESTAMP_LTZ

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

NEXT_SCHEDULED_TIME

TIMESTAMP_LTZ

Time when the standalone or root task (in a DAG of tasks) is next scheduled to start running, assuming the current run of the standalone task or DAG started at the SCHEDULED_TIME time completes in time.

COMPLETED_TIME

TIMESTAMP_LTZ

Time when the last task in the DAG was completed.

ROOT_TASK_ID

TEXT

Unique identifier for the root task in a DAG. This ID matches the ID column value in the SHOW TASKS output for the same task.

GRAPH_VERSION

NUMBER

Integer identifying the version of the DAG that was run, or is scheduled to be run.

RUN_ID

NUMBER

Time when the standalone or root task in a DAG is/was originally scheduled to start running. Format is epoch time (in milliseconds). The combination of the ROOT_TASK_ID and RUN_ID values identifies a specific run of a DAG. . Original scheduled time refers to rare instances when the system may reschedule the same task to run at a different time to retry it or rebalance the load. If that happens, RUN_ID shows the original scheduled run time and SCHEDULED_TIME shows the rescheduled run time.

使用上の注意

  • ビューの待機時間は最大45分です。

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

アカウントにある完了したタスクグラフ実行の最新10件の記録を取得します。

select root_task_name, state from snowflake.account_usage.complete_task_graphs
  limit 10;