스키마:

ACCOUNT_USAGE

TASK_HISTORY 뷰

이 Account Usage 뷰에서는 지난 365일(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

실행되었거나 실행되도록 예약된 작업 그래프의 버전을 식별하는 정수입니다. 값이 증가할 때마다 이는 작업 그래프의 작업에 대한 하나 이상의 수정 사항을 나타냅니다. 루트 작업이 다시 만들어지면(CREATE OR REPLACE TASK 사용) 버전 번호가 1부터 다시 시작됩니다.

RUN_ID

NUMBER

작업 그래프의 독립 실행형 또는 루트 작업이 실행을 시작하도록 원래 예약된 시간입니다. 형식은 Epoch 시간(밀리초)입니다. . . 원래 예약된 시간은 시스템이 재시도 또는 로딩 균형 재조정 목적으로 동일 작업을 다른 시간에 실행하도록 다시 예약할 수 있는 드문 경우를 나타냅니다. 이 경우, 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