TASK_HISTORY¶

구문¶

TASK_HISTORY(
      [ SCHEDULED_TIME_RANGE_START => <constant_expr> ]
      [, SCHEDULED_TIME_RANGE_END => <constant_expr> ]
      [, RESULT_LIMIT => <integer> ]
      [, TASK_NAME => '<string>' ]
      [, ERROR_ONLY => { TRUE | FALSE } ]
      [, ROOT_TASK_ID => '<string>'] )

인자¶

모든 인자는 선택 사항입니다.

SCHEDULED_TIME_RANGE_START => constant_expr , . SCHEDULED_TIME_RANGE_END => constant_expr

작업 실행이 예약된, 지난 7일 이내의 시간 범위(TIMESTAMP_LTZ 형식)입니다. 시간 범위가 지난 7일 이내에 속하지 않는 경우, 오류가 반환됩니다.

• SCHEDULED_TIME_RANGE_END 가 지정되지 않은 경우, 함수는 이미 완료되었거나, 현재 실행 중이거나, 미래의 예약된 작업을 반환합니다.

• SCHEDULED_TIME_RANGE_END 가 CURRENT_TIMESTAMP 인 경우, 함수는 이미 완료되었거나, 현재 실행 중인 작업을 반환합니다. 현재 시간 직전에 실행된 작업은 여전히 예약된 것으로 식별될 수 있습니다.

• 이미 완료되었거나 현재 실행 중인 작업만 쿼리하려면 WHERE query_id IS NOT NULL 을 필터로서 포함하십시오. TASK_HISTORY 출력의 QUERY_ID 열은 작업 실행이 시작된 경우에만 채워집니다.

참고

시작 또는 종료 시간을 지정하지 않는 경우, 지정된 RESULT_LIMIT 값까지를 범위로 하여 가장 최근 작업이 반환됩니다.

RESULT_LIMIT => integer

함수가 반환하는 최대 행 수를 지정하는 숫자입니다.

일치하는 행의 수가 이 제한보다 큰 경우, 지정된 제한까지를 범위로 하여 타임스탬프가 가장 최근인 작업 실행이 반환됩니다.

범위: 1 ~ 10000

기본값: 100.

TASK_NAME => string

작업을 지정하는, 대/소문자를 구분하지 않는 문자열입니다. 정규화되지 않은 작업 이름만 지원됩니다. 지정된 작업의 실행만 반환됩니다. 여러 작업의 이름이 같은 경우, 이 함수는 이러한 작업 각각에 대한 기록을 반환합니다.

ERROR_ONLY => TRUE | FALSE

TRUE로 설정 시, 이 함수는 실패하거나 취소된 작업 실행만 반환합니다.

ROOT_TASK_ID =>string

작업 그래프의 루트 작업에 대한 고유 식별자입니다. 이 ID는 동일한 작업에 대한 SHOW TASKS 출력의 ID 열 값과 일치합니다. 작업 그래프의 일부인 루트 작업 및 하위 작업의 기록을 표시하려면 ROOT_TASK_ID를 지정하십시오.

사용법 노트¶

• 이 함수는 ACCOUNTADMIN 역할, 작업 소유자 또는 전역 MONITOR EXECUTION 권한이 있는 역할에 대한 결과만 반환합니다. 역할에 MONITOR EXECUTION 권한이 있는 데다, 작업을 저장하는 데이터베이스 및 스키마에 대한 USAGE 권한도 있는 경우를 제외하고, 출력의 DATABASE_NAME 및 SCHEMA_NAME 값은 NULL입니다.

• 이 함수는 RESULT_LIMIT 인자 값에 설정된 최대 10,000개의 행을 반환합니다. 기본값은 100 입니다. 이 제한을 피하려면 TASK_HISTORY 뷰 (Account Usage)를 사용하십시오.

• TASK_HISTORY 함수를 쿼리할 때 작업 이름, 시간 범위, 결과 제한 인자가 먼저 적용되고, 지정된 경우 각각 WHERE 및 LIMIT 절이 뒤따릅니다. 또한, TASK_HISTORY 함수는 SCHEDULED_TIME의 내림차순으로 기록을 반환합니다. SUCCEEDED, FAILED 또는 CANCELLED 상태의 작업은 일반적으로 더 일찍 예약되므로 일반적으로 나중에 검색 결과에 반환됩니다.

• 실제로, 계정에서 실행 중인 작업이 많은 경우, 함수가 반환한 결과에는 완료된 작업이 예상보다 적거나 예약된 작업만 포함될 수 있습니다. 이미 실행된 작업의 기록을 쿼리하려면 SCHEDULED_TIME_RANGE_START => constant_expr 및 SCHEDULED_TIME_RANGE_END => constant_expr 인자 조합을 사용하십시오.

• Information Schema 테이블 함수를 호출할 때 세션에는 사용 중인 INFORMATION_SCHEMA 스키마가 있거나 또는 함수 이름이 정규화되어야 합니다. 자세한 내용은 Snowflake Information Schema 섹션을 참조하십시오.

• 이 함수는 지난 7일 동안 실행된 모든 실행 또는 향후 8일 이내의 예약된 다음 실행을 반환할 수 있습니다.

• 클라우드 서비스 오류 중에 실행되는 작업은 이 함수의 결과에 중복 항목으로 나타날 수 있습니다. 클라우드 서비스 오류가 발생하는 동안 Snowflake가 작업을 다시 실행하는 바람에 해당 작업은 작업 SCHEDULED_TIME이 서로 다른 두 개의 UUID를 가지게 될 수 있습니다. TASK_HISTORY 뷰 는 재실행 작업의 마지막 UUID만 표시합니다.

• 작업 그래프 실행의 모든 작업은 동일한 작업 기록 출력을 표시합니다.

출력¶

이 함수는 다음 열을 반환합니다.

예¶

계정에서 가장 최근에 실행된 100개의 작업(완료됨, 여전히 실행 중 또는 미래에 예약됨)을 다음과 같이 검색합니다. 함수가 반환하는 최대 행 수는 기본적으로 100개로 제한됩니다.

SELECT *
  FROM TABLE(INFORMATION_SCHEMA.TASK_HISTORY())
  ORDER BY SCHEDULED_TIME;

Copy

지난 7일 내에, 지정된 30분 시간 블록 내에서 계정의 작업에 대한 실행 기록을 다음과 같이 검색합니다.

SELECT *
  FROM TABLE(INFORMATION_SCHEMA.TASK_HISTORY(
    SCHEDULED_TIME_RANGE_START=>TO_TIMESTAMP_LTZ('2018-11-9 12:00:00.000 -0700'),
    SCHEDULED_TIME_RANGE_END=>TO_TIMESTAMP_LTZ('2018-11-9 12:30:00.000 -0700')));

Copy

지난 1시간 내에 예약된 지정된 작업(완료됨, 여전히 실행 중 또는 미래에 예약됨)의 가장 최근 실행 10개를 다음과 같이 검색합니다.

SELECT *
  FROM TABLE(INFORMATION_SCHEMA.TASK_HISTORY(
    SCHEDULED_TIME_RANGE_START=>DATEADD('hour',-1,current_timestamp()),
    RESULT_LIMIT => 10,
    TASK_NAME=>'mytask'));

Copy

참고

완료되었거나 여전히 실행 중인 작업만 검색하려면 WHERE query_id IS NOT NULL 을 사용하여 쿼리를 필터링하십시오. 이 필터는 RESULT_LIMIT 가 반환된 결과를 이미 줄인 후에 적용되므로, 작업 1개가 예약되었지만 아직 시작되지 않은 경우 쿼리가 작업을 9개 반환할 수 있습니다.

지정된 루트 작업의 작업 그래프에서 모든 작업의 실행 기록을 검색합니다.

SELECT *
  FROM TABLE(INFORMATION_SCHEMA.TASK_HISTORY(ROOT_TASK_ID=>'d4b89013-c942-465c-bcb8-e7037a932b04'));

Copy

가장 최근에 쿼리된 루트 작업의 작업 그래프에서 모든 작업의 실행 기록을 검색합니다.

DESC TASK my_task
SET task_id=(SELECT "id" FROM TABLE(RESULT_SCAN(LAST_QUERY_ID())));
SELECT *
  FROM TABLE(INFORMATION_SCHEMA.TASK_HISTORY(ROOT_TASK_ID=>$task_id));

Copy