- 카테고리:
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~10,000
기본값: 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.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())));