카테고리:

Information Schema , 테이블 함수

NOTIFICATION_HISTORY

이 테이블 함수를 사용해 Snowflake를 통해 전송된 알림 기록을 쿼리할 수 있습니다. 이런 알림에는 다음과 같은 알림이 포함됩니다.

참고

이 함수는 처리된 알림(전송되었거나 실패한 알림)에 대한 정보만 반환합니다. 큐의 알림은 기록에 표시되지 않습니다.

구문

NOTIFICATION_HISTORY(
  [ START_TIME => <constant_expr> ]
  [, END_TIME => <constant_expr> ]
  [, INTEGRATION_NAME => '<string>' ]
  [, RESULT_LIMIT => <integer> ] )
)
Copy

인자

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

START_TIME=> constant_expr , . END_TIME=> constant_expr

알림이 발송되는 시간 범위(TIMESTAMP_LTZ 형식)입니다.

  • START_TIME 을 지정하지 않은 경우, 범위는 END_TIME 24시간 전에 시작됩니다.

  • END_TIME 가 지정되지 않은 경우, 기본값은 CURRENT_TIMESTAMP 입니다.

최대 시간 범위는 14일입니다.

INTEGRATION_NAME => 'string'

알림과 연결된 통합의 정규화된 이름입니다. 이 인자를 생략하면 이 함수가 모든 알림을 반환합니다.

기본값: 빈 문자열.

RESULT_LIMIT => integer

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

범위: 1 ~ 10000

기본값: 100.

출력

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

열 이름

데이터 타입

설명

CREATED

TIMESTAMP_LTZ

알림이 생성된 타임스탬프입니다.

PROCESSED

TIMESTAMP_LTZ

알림 전송을 마지막으로 시도한 때의 타임스탬프입니다.

MESSAGE_SOURCE

TEXT

알림을 생성한 오브젝트 또는 기능의 유형입니다. 유효한 값으로는 다음이 포함됩니다. . . TASK (작업에서의 알림) . SNOWPIPE (Snowpipe에서의 알림) . STORED_PROCEDURE (SYSTEM$SEND_EMAIL 저장 프로시저를 호출 하여 전송되는 이메일 알림)

INTEGRATION_NAME

TEXT

이 알림에 사용되는 통합 의 이름입니다.

MESSAGE

TEXT

메시지 페이로드입니다.

STATUS

TEXT

알림의 상태입니다. 유효한 값: SUCCESS 또는 FAILURE.

ERROR_MESSAGE

TEXT

알림이 실패한 경우 알림이 실패한 이유에 대한 세부 정보를 제공합니다.

사용법 노트

  • 통합에 대한 ACCOUNTADMIN 역할, 통합 소유자(즉, 통합에 대한 OWNERSHIP 권한이 있는 역할) 또는 USAGE 권한이 있는 역할에 대한 결과만 반환합니다.

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

지난 24시간 동안 생성된 가장 최근의 알림을 검색합니다.

select * from table(information_schema.notification_history())
Copy

MY_INTEGRATION 이라는 통합을 사용하여 지난 1시간 동안 생성되고 전송된 가장 최근의 알림을 검색합니다.

select * from table(information_schema.notification_history(
  START_TIME=>dateadd('hour',-1,current_timestamp()),
  END_TIME=>current_timestamp(),
  RESULT_LIMIT=>100,
  INTEGRATION_NAME=>'MY_INTEGRATION'));
Copy