スキーマ:: ACCOUNT_USAGE

TASK_HISTORY ビュー¶

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

列¶

列名	データ型	説明
NAME	VARCHAR	タスクの名前。
QUERY_TEXT	VARCHAR	SQL ステートメントのテキスト。
CONDITION_TEXT	VARCHAR	実行するかどうかを決定するときにタスクが評価する WHEN 条件のテキスト。
SCHEMA_NAME	VARCHAR	タスクを含むスキーマの名前。
TASK_SCHEMA_ID	NUMBER	タスクを含むスキーマの内部/システム生成識別子。
DATABASE_NAME	VARCHAR	タスクを含むデータベースの名前。
TASK_DATABASE_ID	NUMBER	タスクを含むデータベースの内部/システム生成識別子。
SCHEDULED_TIME	TIMESTAMP_LTZ	タスクが実行を開始する/スケジュールされた時刻です。絶対精度を確保するために最善を尽くしますが、スケジュールされた時間の前にタスクが実行されないことを保証するのみです。
COMPLETED_TIME	TIMESTAMP_LTZ	タスクが完了した時刻。
STATE	VARCHAR	完了したタスクのステータス: SUCCEEDED、 FAILED、 CANCELLED、または SKIPPED。ビューは SCHEDULED または EXECUTING タスクの実行を返さないことに注意してください。スケジュールされた状態または実行状態にある実行のタスク履歴の詳細を取得するには、Information Schemaの TASK_HISTORY テーブル関数をクエリします。タイムアウトしたタスクは、タスク履歴で常に `FAILED` の状態になります。
RETURN_VALUE	VARCHAR	タスクグラフ内の先行タスクに設定された値。戻り値は、先行タスクで SYSTEM$SET_RETURN_VALUE 関数を呼び出すことにより、明示的に設定されます。
QUERY_ID	VARCHAR	タスクによって実行された SQL ステートメントのID。ステートメントまたはストアドプロシージャの実行に関する追加の詳細は、 QUERY_HISTORY ビューと結合できます。
QUERY_START_TIME	TIMESTAMP_LTZ	タスク定義のクエリの実行が開始された時刻。このタイムスタンプは、 QUERY_HISTORY によって返されるクエリの開始時間と一致します。
ERROR_CODE	NUMBER	ステートメントがエラーを返した場合のエラーコード。
ERROR_MESSAGE	VARCHAR	ステートメントがエラーを返した場合のエラーメッセージ。
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	VARCHAR	タスクグラフ内にあるルートタスクの一意の識別子。この ID は、同じタスクの SHOW TASKS 出力にある ID 列の値と一致します。
SCHEDULED_FROM	VARCHAR	次のいずれか: `SCHEDULE`: CREATE TASK の SCHEDULE 句または AFTER 句で説明されているように、タスクは正常に実行されるようにスケジュールされました。 `EXECUTE TASK`: タスクは EXECUTE TASK を使用して実行するようにスケジュールされました。 `MANUAL RETRY`: タスクは EXECUTE TASK ... RETRY LAST を使用して実行するようにスケジュールされました。 `TRIGGER`: タスクの `WHEN` 句のストリームに新しいデータが含まれていたため、タスクが実行されました。タスクグラフにある子タスクの実行の場合、列はルートタスクの実行と同じ値を返します。
ATTEMPT_NUMBER	NUMBER	このタスクの実行を試行した回数を表す整数。初期値は1。
INSTANCE_ID	NUMBER	オブジェクトが属するインスタンスの内部/システム生成識別子。
CONFIG	VARCHAR	ルートタスクに設定されている場合はグラフレベルの構成を表示します。それ以外の場合は NULL を表示します。
QUERY_HASH	VARCHAR	正規化された SQL テキストに基づいて計算されたハッシュ値。
QUERY_HASH_VERSION	NUMBER	`QUERY_HASH` を計算するために使用されるロジックのバージョン。
QUERY_PARAMETERIZED_HASH	VARCHAR	パラメーター化されたクエリに基づいて計算されたハッシュ値。
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