카테고리:

Information Schema , 테이블 함수

SERVERLESS_ALERT_HISTORY

이 테이블 함수는 서버리스 경고 사용 기록을 쿼리하는 데 사용됩니다. 이 함수에서 반환되는 정보에는 경고 이름과 각 경고 실행에 사용된 크레딧이 포함됩니다.

구문

SERVERLESS_ALERT_HISTORY(
  [ DATE_RANGE_START => <constant_expr> ]
  [ , DATE_RANGE_END => <constant_expr> ]
  [ , ALERT_NAME => '<string>' ] )
Copy

인자

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

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분입니다.

ALERT_NAME => string

사용 기록을 검색할 경고의 이름입니다. 지정된 경고에 대한 사용 데이터만 반환됩니다.

경고 이름은 작은따옴표로 묶어야 합니다. 또한, 경고 이름에 공백, 대/소문자 혼합 문자 또는 특수 문자가 포함된 경우, 이름을 작은따옴표 안에 큰따옴표로 묶어야 합니다(예: '"My Alert"' vs 'myalert').

사용법 노트

  • 테이블 함수는 ACCOUNTADMIN 역할에 대한 결과 또는 MONITOR USAGE 전역 권한이 명시적으로 부여된 역할에 대한 결과만 반환합니다.

    참고

    MONITOR USAGE 권한이 있는 역할은 오브젝트별 크레딧 사용량을 볼 수 있지만, 오브젝트 이름은 볼 수 없습니다.

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

  • 기록은 1시간 단위로 표시됩니다.

출력

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

열 이름

데이터 타입

설명

START_TIME

TIMESTAMP_LTZ

지정된 시간 범위의 시작입니다.

END_TIME

TIMESTAMP_LTZ

지정된 시간 범위의 끝입니다.

ALERT_NAME

TEXT

경고의 이름입니다.

CREDITS_USED

TEXT

START_TIME 및 END_TIME 기간 동안 서버리스 경고 사용에 대해 청구된 크레딧 수입니다.

예

계정에 대한 1시간 범위의 사용 기록을 검색합니다.

SELECT *
  FROM TABLE(INFORMATION_SCHEMA.SERVERLESS_ALERT_HISTORY(
    DATE_RANGE_START=>'2024-10-08 19:00:00.000 -0700',
    DATE_RANGE_END=>'2024-10-08 20:00:00.000 -0700'));
Copy

샘플 출력:

+-------------------------------+-------------------------------+------------+--------------+
| START_TIME                    | END_TIME                      | ALERT_NAME | CREDITS_USED |
|-------------------------------+-------------------------------+------------+--------------|
| 2024-10-08 04:16:22.000 -0700 | 2024-10-08 05:16:22.000 -0700 | A1         |  0.000286714 |
| 2024-10-08 05:16:22.000 -0700 | 2024-10-08 06:16:22.000 -0700 | A1         |  0.007001568 |
+-------------------------------+-------------------------------+------------+--------------+

계정에 대한 지난 12시간 동안의 기록을 검색합니다.

SELECT *
  FROM TABLE(INFORMATION_SCHEMA.SERVERLESS_ALERT_HISTORY(
    DATE_RANGE_START=>DATEADD(H, -12, CURRENT_TIMESTAMP)));
Copy

계정에 대한 지난주의 기록을 검색합니다.

SELECT *
  FROM TABLE(INFORMATION_SCHEMA.SERVERLESS_ALERT_HISTORY(
    DATE_RANGE_START=>DATEADD(D, -7, CURRENT_DATE),
    DATE_RANGE_END=>CURRENT_DATE));
Copy

계정에서 지정된 경고에 대한 지난주 사용 기록을 검색합니다.

SELECT *
  FROM TABLE(INFORMATION_SCHEMA.SERVERLESS_ALERT_HISTORY(
    DATE_RANGE_START=>DATEADD(D, -7, CURRENT_DATE),
    DATE_RANGE_END=>CURRENT_DATE,
    ALERT_NAME=>'my_database.my_schema.my_alert'));
Copy
언어: 한국어