SERVERLESS_TASK_HISTORY

이 테이블 함수는 서버리스 태스크 사용 기록을 조회하는 데 사용돼요. 함수가 반환하는 정보에는 태스크 이름과 각 태스크 실행에 소비된 크레딧(credits)이 포함돼요.

출처: Snowflake SERVERLESS_TASK_HISTORY 함수 문서

본문

참고: 이 함수는 일반적으로 더 완전한 데이터 세트를 제공하고 더 긴 날짜 범위를 지원하는 ACCOUNT_USAGE.SERVERLESS_TASK_HISTORY 뷰를 위해 더 이상 사용되지 않아요(deprecated).

구문 (Syntax)

SERVERLESS_TASK_HISTORY(
      [ DATE_RANGE_START =>  ]
      [ , DATE_RANGE_END =>  ]
      [ , TASK_NAME => '' ] )

인자 (Arguments)

모든 인자는 선택 사항이에요.

DATE_RANGE_START => constant_expr, DATE_RANGE_END => constant_expr — 사용 창의 날짜/시간 범위:
- 종료 날짜가 지정되지 않으면, 범위의 끝으로 CURRENT_DATE가 사용돼요.
- 시작 날짜가 지정되지 않으면, 범위는 DATE_RANGE_END의 시작 10분 전부터 시작돼요 (즉, 기본값은 이전 10분의 사용 기록을 보여주는 것). 예를 들어 DATE_RANGE_END가 CURRENT_DATE면 기본 DATE_RANGE_START는 전날 오후 11:50이에요.
TASK_NAME => string — 사용 기록을 검색할 태스크의 이름이에요. 지정된 태스크에 대한 사용 데이터만 반환돼요. 태스크 이름은 단일 따옴표로 묶어야 해요. 또한 태스크 이름에 공백, 대소문자 혼용, 특수 문자가 포함되면 이름은 단일 따옴표 안에서 이중 따옴표로 묶어야 해요 (예: '"My Task"' vs 'mytask').

사용 노트 (Usage Notes)

ACCOUNTADMIN 역할 또는 MONITOR USAGE 전역 권한이 명시적으로 부여된 역할에 대해서만 결과를 반환해요.
- 참고: MONITOR USAGE 권한이 있는 역할은 객체별 크레딧 사용량은 볼 수 있지만 객체 이름은 볼 수 없어요.
Information Schema 테이블 함수를 호출할 때, 세션에 INFORMATION_SCHEMA 스키마가 사용 중이거나 함수 이름이 정규화(fully-qualified)돼 있어야 해요. 자세한 내용은 Snowflake Information Schema 문서를 참고해요.
기록은 1시간 단위로 표시돼요.

출력 (Output)

이 함수는 다음 컬럼을 반환해요:

컬럼 이름	데이터 타입	설명
START_TIME	TIMESTAMP_LTZ	지정된 시간 범위의 시작
END_TIME	TIMESTAMP_LTZ	지정된 시간 범위의 끝
TASK_NAME	TEXT	태스크 이름
CREDITS_USED	TEXT	START_TIME과 END_TIME 창 동안 서버리스 태스크 사용에 청구된 크레딧 수

예제 (Examples)

계정의 한 시간 범위에 대한 사용 기록 검색:

select *
  from table(information_schema.serverless_task_history(
    date_range_start=>'2021-10-08 19:00:00.000',
    date_range_end=>'2021-10-08 20:00:00.000'));

샘플 출력:

+-------------------------------+-------------------------------+-----------+--------------+
| START_TIME                    | END_TIME                      | TASK_NAME | CREDITS_USED |
|-------------------------------+-------------------------------+-----------+--------------|
| 2021-10-08 04:16:22.000 -0700 | 2021-10-08 05:16:22.000 -0700 | T1        |  0.000286714 |
| 2021-10-08 05:16:22.000 -0700 | 2021-10-08 06:16:22.000 -0700 | T1        |  0.007001568 |
+-------------------------------+-------------------------------+-----------+--------------+

계정의 지난 12시간에 대한 기록 검색:

select *
  from table(information_schema.serverless_task_history(
    date_range_start=>dateadd(H, -12, current_timestamp)));

계정의 지난 한 주에 대한 기록 검색:

select *
  from table(information_schema.serverless_task_history(
    date_range_start=>dateadd(D, -7, current_date),
    date_range_end=>current_date));

계정의 지정된 태스크에 대한 지난 한 주간의 사용 기록 검색:

select *
  from table(information_schema.serverless_task_history(
    date_range_start=>dateadd(D, -7, current_date),
    date_range_end=>current_date,
    task_name=>'mydb.myschema.mytask'));

더 알아보기

Snowflake ACCOUNT_USAGE.SERVERLESS_TASK_HISTORY 뷰 — 더 완전한 데이터를 제공하는 뷰