NOTIFICATION_HISTORY 테이블 함수: 출력에 대한 변경 사항

주의

이 동작 변경 사항은 2024_04 번들에 있습니다.

번들의 현재 상태는 번들 기록 섹션을 참조하십시오.

NOTIFICATION_HISTORY 함수는 다음에 대한 정보를 제공하도록 변경됩니다.

  • 아직 처리되지 않은 알림.

  • 처음에는 실패했지만 다시 보내기 위해 시도 중인 알림 전송 시도.

다음 섹션에서는 이러한 변경 사항이 함수 출력에 어떤 영향을 미치는지 설명합니다.

반환되는 행 수 변경 사항

함수에서 반환되는 행의 수가 변경됩니다.

변경 전:

이 함수는 처리된 각 알림(전송된 알림 또는 실패한 알림)에 대한 행을 반환합니다.

알림을 보내려고 여러 번 시도한 경우, 함수는 마지막 시도에 대한 행을 반환합니다.

변경 후:

이 함수는 알림을 보내려고 시도할 때마다 행을 반환합니다. STATUS 열의 값은 시도 상태를 나타냅니다.

  • 시도가 실패했지만 다시 시도할 수 있는 경우 값은 RETRIABLE_FAILURE 입니다.

  • 시도가 실패하여 재시도할 수 없는 경우 값은 FAILURE 입니다.

  • 시도가 성공하면 값은 SUCCESS 입니다.

또한, 이 함수는 아직 처리되지 않은 각 알림(큐에 있는 알림)에 대한 행을 반환합니다.

출력의 새 열

이 동작 변경 번들이 활성화되면 NOTIFICATION_HISTORY 함수의 출력에 다음과 같은 새 열이 포함됩니다.

열 이름

데이터 타입

설명

ID

VARCHAR

알림 전송 요청의 고유 ID입니다.

Snowflake가 알림 전송에 실패하고 다시 알림을 보내려고 시도하면 함수는 각 시도에 대해 행을 반환합니다. ATTEMPT에 대한 각 행은 ID 열에는 동일한 값을 갖지만 BB 열에는 다른 값을 갖습니다.

ATTEMPT

INTEGER

알림 전송을 시도한 횟수입니다.

MESSAGE_SOURCE_INFO

OBJECT

알림의 출처에 대한 정보가 포함된 오브젝트입니다. 이 오브젝트의 필드는 소스의 유형에 따라 달라집니다.

  • 작업에 대한 오류 알림 의 경우 오브젝트에는 다음 필드가 포함됩니다.

    • name: 작업의 이름입니다.

    • graph_run_group_id: 그래프 실행의 식별자입니다.

    • attempt_number: 이 작업을 실행하려는 시도 횟수를 나타내는 정수입니다.

  • Snowpipe에 대한 오류 알림 의 경우 오브젝트에는 파이프의 이름을 지정하는 pipe_name 필드가 포함되어 있습니다.

  • SYSTEM$SEND_EMAIL 저장 프로시저를 호출하여 전송된 알림의 경우 오브젝트에는 저장 프로시저를 호출한 문의 ID를 지정하는 query_id 필드가 포함됩니다.

MESSAGE 열 사용 중단

MESSAGE 열은 더 이상 사용되지 않으며 향후 제거될 예정입니다.

참조: 1593