スキーマ:: 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	タスクグラフ内の先行タスクに設定された値です。戻り値は、先行タスクで 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	実行済み、または実行予定のタスクグラフのバージョンを識別する整数。値の増分の増加は、タスクグラフ内のタスクに対する1つ以上の変更を表します。ルートタスクが（ CREATE OR REPLACE TASK を使用して）再作成された場合、バージョン番号は1から再開します。
RUN_ID	NUMBER	タスクグラフ内のスタンドアロンタスクまたはルートタスクが本来実行を開始するようにスケジュールされている、またはされていた時刻。形式はエポック時間（単位：ミリ秒）です。 . . 元のスケジュール時間とは、システムが同じタスクを再スケジュールして異なる時間に実行し、再試行またはロードのリバランスを行うまれなインスタンスを指します。その場合、RUN_IDは元のスケジュールされた実行時間を表示し、SCHEDULED_TIMEは再スケジュールされた実行時間を表示します。 . . RUN_ID は、再試行前に実行された現在のタスク/グラフの一意な識別子ではない可能性があります。RUN_ID の代わりとして、 GRAPH_RUN_GROUP_ID 列を使用することができます。
ROOT_TASK_ID	TEXT	タスクグラフ内にあるルートタスクの一意の識別子。この ID は、同じタスクの SHOW TASKS 出力にある ID 列の値と一致します。
SCHEDULED_FROM	TEXT	次のいずれか: `SCHEDULE`: CREATE TASK の SCHEDULE 句または AFTER 句で説明されているように、タスクは正常に実行されるようにスケジュールされました。 `EXECUTE TASK`: タスクは EXECUTE TASK を使用して実行するようにスケジュールされました。 `MANUAL RETRY`: タスクは EXECUTE TASK ... RETRY LAST を使用して実行するようにスケジュールされました。タスクグラフにある子タスクの実行の場合、列はルートタスクの実行と同じ値を返します。
ATTEMPT_NUMBER	NUMBER	このタスクの実行を試行した回数を表す整数。初期値は1。
INSTANCE_ID	NUMBER	オブジェクトが属するインスタンスの内部/システム生成識別子。
CONFIG	TEXT	ルートタスクに設定されている場合はグラフレベルの構成を表示します。それ以外の場合は NULL を表示します。
QUERY_HASH	TEXT	正規化された SQL テキストに基づいて計算されたハッシュ値。
QUERY_HASH_VERSION	NUMBER	`QUERY_HASH` を計算するために使用されるロジックのバージョン。
QUERY_PARAMETERIZED_HASH	TEXT	パラメーター化されたクエリに基づいて計算されたハッシュ値。
QUERY_PARAMETERIZED_HASH_VERSION	NUMBER	`QUERY_PARAMETERIZED_HASH` を計算するために使用されるロジックのバージョン。
GRAPH_RUN_GROUP_ID	NUMBER	グラフ実行の識別子。グラフ実行に複数のタスク実行がある場合、各タスク実行は同じ GRAPH_RUN_GROUP_ID を表示します。GRAPH_RUN_GROUP_ID、および ATTEMPT_NUMBER の組み合わせは、グラフの実行を一意に識別するために使用できます。
BACKFILL_INFO	OBJECT	今後の使用のために予約されています。すべての行に対して返される値は NULL です。

使用上の注意¶

ビューの遅延は最大45分です。
パフォーマンスを向上させるには、 COMPLETED_TIME または SCHEDULED_TIME 列でクエリをフィルターします。例セクション（このトピック内）をご参照ください。

例¶

実行された最新10件のタスク実行の記録を取得します。

SELECT query_text, completed_time
FROM snowflake.account_usage.task_history
ORDER BY completed_time DESC
LIMIT 10;

Copy

過去1時間に完了したタスク実行の記録を取得します。

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

Copy