- スキーマ:
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内のスタンドアロンタスクまたはルートタスクが本来実行を開始するようにスケジュールされている、またはされていた時間。形式はエポック時間(単位:ミリ秒)です。ROOT_TASK_ID値とRUN_ID値の組み合わせは、DAGの特定の実行を識別します。 . 元の スケジュール時間とは、システムが同じタスクを再スケジュールして異なる時間に実行し、再試行またはロードのリバランスを行うまれなインスタンスを指します。その場合、 RUN_ID は元のスケジュールされた実行時間を示し、 SCHEDULED_TIME は再スケジュールされた実行時間を示します。 |
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 |
|
QUERY_HASH_VERSION |
NUMBER |
|
QUERY_PARAMETERIZED_HASH |
TEXT |
|
QUERY_PARAMETERIZED_HASH_VERSION |
NUMBER |
|
使用上の注意¶
ビューの遅延は最大45分です。
パフォーマンスを向上させるには、 COMPLETED_TIME または SCHEDULED_TIME 列でクエリをフィルターします。 例 セクション(このトピック内)をご参照ください。
例¶
実行された最新10件のタスク実行のレコードを取得します。
SELECT query_text, completed_time FROM snowflake.account_usage.task_history LIMIT 10;
過去1時間に完了したタスク実行のレコードを取得します。
SELECT query_text, completed_time FROM snowflake.account_usage.task_history WHERE COMPLETED_TIME > DATEADD(hours, -1, CURRENT_TIMESTAMP());