スキーマ:

ACCOUNT_USAGE

TASK_HISTORY ビュー

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

列名

データ型

説明

QUERY_ID

TEXT

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

NAME

TEXT

タスクの名前。

DATABASE_NAME

TEXT

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

SCHEMA_NAME

TEXT

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

QUERY_TEXT

TEXT

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

CONDITION_TEXT

TEXT

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

STATE

TEXT

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

ERROR_CODE

NUMBER

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

ERROR_MESSAGE

TEXT

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

SCHEDULED_TIME

TIMESTAMP_LTZ

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

QUERY_START_TIME

TIMESTAMP_LTZ

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

COMPLETED_TIME

TIMESTAMP_LTZ

タスクが完了した時刻。

ROOT_TASK_ID

TEXT

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

GRAPH_VERSION

NUMBER

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

RUN_ID

NUMBER

タスクのツリー内のスタンドアロンタスクまたはルートタスクが本来実行を開始するようにスケジュールされている、またはされていた時間。形式はエポック時間(単位:ミリ秒)です。 ROOT_TASK_ID 値と RUN_ID 値の組み合わせは、タスクツリーの特定の実行を識別します。 . 元の スケジュール時間とは、システムが同じタスクを再スケジュールして異なる時間に実行し、再試行またはロードのリバランスを行うまれなインスタンスを指します。その場合、 RUN_ID は元のスケジュールされた実行時間を示し、 SCHEDULED_TIME は再スケジュールされた実行時間を示します。

RETURN_VALUE

TEXT

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

使用上の注意

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

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

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

SELECT * FROM snowflake.account_usage.task_history
  LIMIT 10;

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

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