- 类别：
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_expr创建作业以检索作业历史记录的时间范围的开始时间，格式为 TIMESTAMP_LTZ，例如“2024-04-05 01:02:03”。有关构造日期、时间和时间戳数据的可用函数，请参阅 日期和时间函数。
默认值：自当前时间戳起 14 天。
CREATED_TIME_END => constant_expr检索作业历史记录的时间范围的结束时间，格式为 TIMESTAMP_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(());
以下示例输出仅显示一个作业：
+--------------------------------------+-----+-------------+---------------+-------------+-------------------------------+-------------------------------+--------------+--------+-----------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------------------+-----------+-----------------+-----------------+-----------------+ | 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.cn/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 | | | | | | | | | | | | | | | | | } | | | | | | +--------------------------------------+-----+-------------+---------------+-------------+-------------------------------+-------------------------------+--------------+--------+-----------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------------------+-----------+-----------------+-----------------+-----------------+
返回由当前角色负责且在最近三天内运行的最多 10 个作业的作业历史记录。
SELECT * FROM TABLE(snowflake.spcs.get_job_history( result_limit => 10, created_time_start => dateadd('day', -3, current_timestamp()) ));
检索在三天前和一天前（不包括今天）之间运行的最多 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())));