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 } ] )

인자¶

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

SCHEDULED_TIME_RANGE_START => constant_expr , . SCHEDULED_TIME_RANGE_END => constant_expr

작업 실행이 예약된, 지난 7일 이내의 시간 범위(TIMESTAMP_LTZ 형식)입니다.

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

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

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

참고

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

시간 범위가 지난 7일 이내에 속하지 않는 경우, 오류가 반환됩니다.

RESULT_LIMIT => integer

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

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

범위: 1 ~ 10000

기본값: 100.

TASK_NAME => string

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

ERROR_ONLY => TRUE | FALSE

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

사용법 노트¶

• ACCOUNTADMIN 역할, 작업 소유자(즉, 작업에 대한 OWNERSHIP 권한이 있는 역할) 또는 전역 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 상태)은 더 일찍 예약되는 경향이 있으므로, 일반적으로 검색 결과의 순서대로 나중에 반환됩니다.

  실제로, 계정에서 실행 중인 작업이 많은 경우, 함수가 반환한 결과에는 완료된 작업이 예상보다 적거나 예약된 작업만 포함될 수 있습니다. 특히 RESULT_LIMIT 값이 상대적으로 낮은 경우 더욱 그렇습니다. 이미 실행된 작업의 기록을 쿼리하려면 Snowflake는 SCHEDULED_TIME_RANGE_START => constant_expr 및/또는 SCHEDULED_TIME_RANGE_END => constant_expr 인자 조합을 사용할 것을 권장합니다.

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

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

출력¶

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

1(1,2,3,4)

이 열은 2023_06 동작 변경 번들이 활성화된 경우에만 존재합니다. 이 열은 쿼리 해시 기능의 일부입니다.

예¶

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

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개 반환할 수 있습니다.