- カテゴリ：
GET_JOB_HISTORY¶
指定された時間範囲内で実行された Snowpark Container Servicesジョブ のジョブ履歴を返します。この関数は、実行中および削除済みのジョブの両方を返します。
- こちらもご参照ください。
構文¶
SNOWFLAKE.SPCS.GET_JOB_HISTORY(
[ CREATED_TIME_START => <constant_expr> ],
[ CREATED_TIME_END => <constant_expr> ],
[ RESULT_LIMIT = <integer> ])
引数¶
CREATED_TIME_START => constant_exprTIMESTAMP_LTZ 形式の開始時間 --- 例: '2024-04-05 01:02:03' --- ジョブ履歴を取得するジョブが作成された時間範囲。データ、時刻、タイムスタンプデータを構築するために利用できる関数については、日付と時刻の関数 をご覧ください。
デフォルト：現在のタイムスタンプから14日。
CREATED_TIME_END => constant_exprTIMESTAMP_LTZ 形式の終了時間、ジョブ履歴を取得する時間範囲。
デフォルト：現在のタイムスタンプ。
RESULT_LIMIT => integer返す行の最大数。
一致する行の数が指定された制限を超える場合は、指定された制限まで、最新のタイムスタンプを持つジョブのみが返されます。
範囲:1～10000
デフォルト：100
出力¶
この関数は、次の列を返します。
列 |
データ型 |
説明 |
|---|---|---|
|
VARCHAR |
EXECUTE JOB SERVICE SQL ステートメントの ID。 |
|
NUMBER |
ジョブの内部/システム生成識別子。 |
|
VARCHAR |
ジョブの名前。 |
|
VARCHAR |
ジョブが作成されるデータベースの名前。 |
|
VARCHAR |
ジョブが作成されるスキーマの名前。 |
|
TIMESTAMP_LTZ |
ジョブが作成された時刻。 |
|
TIMESTAMP_LTZ |
ジョブが完了した時刻。 |
|
TIMESTAMP_LTZ |
ジョブが削除された時刻。 |
|
VARCHAR |
ジョブのステータス。 |
|
VARCHAR |
ジョブステータスに関する追加情報。 |
|
OBJECT |
ジョブインスタンスとコンテナを記述するキーと値のペア。 |
|
VARCHAR |
ジョブが実行されたコンピューティングプールの名前。 |
|
VARCHAR |
ジョブを所有するロール。 |
|
VARCHAR |
ジョブを所有するロールの型。ROLE または DATABASE_ROLE。 |
|
OBJECT |
ジョブの作成時に指定されたパラメーターを説明するキーと値のペア。 |
|
OBJECT |
管理オブジェクトを記述するキーと値のペア。ジョブがSnowflakeによって管理されていない場合は NULL。 |
アクセス制御の要件¶
PUBLIC ロールには、この関数を使用する権限があります。
誰でもこの関数を呼び出すことができますが、出力は現在のロールに依存します。出力には、現在のロールが所有するジョブのみが含まれます。
例¶
過去14日以内に現在のロールによって作成されたすべてのジョブのジョブ履歴を返します（デフォルト
CREATED_TIME_START値）。SELECT * FROM TABLE(SNOWFLAKE.SPCS.GET_JOB_HISTORY(());
次の出力例は、1つのジョブのみを示しています。
+--------------------------------------+-----+-------------+---------------+-------------+-------------------------------+-------------------------------+--------------+--------+-----------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------------------+-----------+-----------------+-----------------+-----------------+ | QUERY_ID | ID | NAME | DATABASE_NAME | SCHEMA_NAME | CREATED_TIME | COMPLETED_TIME | DELETED_TIME | STATUS | MESSAGE | INSTANCE_STATUSES | COMPUTE_POOL_NAME | OWNER | OWNER_ROLE_TYPE | PARAMETERS | MANAGING_OBJECT | |--------------------------------------+-----+-------------+---------------+-------------+-------------------------------+-------------------------------+--------------+--------+-----------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------------------+-----------+-----------------+-----------------+-----------------| | 01bd46d2-0004-be62-0000-ff07016490a6 | 131 | MY_TEST_JOB | TUTORIAL_DB | DATA_SCHEMA | 2025-06-25 17:50:00.728 -0700 | 2025-06-25 17:50:10.515 -0700 | NULL | DONE | Job completed successfully. | { | TUTORIAL_COMPUTE_POOL | TEST_ROLE | ROLE | { | NULL | | | | | | | | | | | | "failedInstances": 0, | | | | "ASYNC": true | | | | | | | | | | | | | "instances": [ | | | | } | | | | | | | | | | | | | { | | | | | | | | | | | | | | | | | "containers": [ | | | | | | | | | | | | | | | | | { | | | | | | | | | | | | | | | | | "containerName": "main", | | | | | | | | | | | | | | | | | "image": "org-account.registry.snowflakecomputing.com/tutorial_db/data_schema/tutorial_repository/my_job_image:latest", | | | | | | | | | | | | | | | | | "imageSha256": "sha256:ff07f19f233cfe76a889e39d9d7098d528312acc789f1c0cf929556a56c61a9a", | | | | | | | | | | | | | | | | | "lastExitCode": 0, | | | | | | | | | | | | | | | | | "message": "Completed successfully", | | | | | | | | | | | | | | | | | "restartCount": 0, | | | | | | | | | | | | | | | | | "startTime": "", | | | | | | | | | | | | | | | | | "status": "DONE" | | | | | | | | | | | | | | | | | } | | | | | | | | | | | | | | | | | ], | | | | | | | | | | | | | | | | | "instanceId": "0" | | | | | | | | | | | | | | | | | } | | | | | | | | | | | | | | | | | ], | | | | | | | | | | | | | | | | | "pendingInstances": 0, | | | | | | | | | | | | | | | | | "runningInstances": 0, | | | | | | | | | | | | | | | | | "succeededInstances": 1, | | | | | | | | | | | | | | | | | "totalInstances": 1 | | | | | | | | | | | | | | | | | } | | | | | | +--------------------------------------+-----+-------------+---------------+-------------+-------------------------------+-------------------------------+--------------+--------+-----------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------------------+-----------+-----------------+-----------------+-----------------+
過去3日以内に実行された、現在のロールが所有する最大10件のジョブのジョブ履歴を返します。
SELECT * FROM TABLE(snowflake.spcs.get_job_history( result_limit => 10, created_time_start => dateadd('day', -3, current_timestamp()) ));
今日を含まない、3日前から1日前に実行された最大10個のジョブを取得します。
SELECT * FROM TABLE(SNOWFLAKE.SPCS.GET_JOB_HISTORY( RESULT_LIMIT => 10, CREATED_TIME_START => DATEADD('day', -3, CURRENT_TIMESTAMP()), CREATED_TIME_END => DATEADD('day', -1, CURRENT_TIMESTAMP())));