SYSTEM$SEND_SNOWFLAKE_NOTIFICATION¶

이메일 주소, 웹후크 또는 클라우드 서비스(Amazon SNS, Google Cloud PubSub 또는 Azure Event Grid)에서 제공한 큐로 알림 메시지를 보냅니다.

참고 항목:: SYSTEM$SEND_SNOWFLAKE_NOTIFICATION을 사용하여 알림 보내기

구문¶

SYSTEM$SEND_SNOWFLAKE_NOTIFICATION(
  <message>,
  <integration_configuration> )

SYSTEM$SEND_SNOWFLAKE_NOTIFICATION(
  ( <message>, [ <message>, ... ] ),
  <integration_configuration> )

SYSTEM$SEND_SNOWFLAKE_NOTIFICATION(
  <message>,
  ( <integration_configuration> [ , <integration_configuration> , ... ] ) )

SYSTEM$SEND_SNOWFLAKE_NOTIFICATION(
  ( <message> [ , <message> , ... ] ),
  ( <integration_configuration> [ , <integration_configuration> , ... ] ) )

인자¶

message

메시지의 유형과 내용을 지정하는 JSON 형식의 문자열입니다. 문자열은 다음 형식이어야 합니다.

{ "<content_type>": "<message_contents>" }

여기서

"content_type" 은 다음 중 하나입니다.
- 일반 텍스트 메시지의 경우 "text/plain".
- HTML 메시지의 경우 "text/html".
- JSON 메시지의 경우 "application/json".
"<message_contents>" 는 메시지의 내용입니다.

예:

{ "text/html": "<p>A message</p>" }

이 문자열을 구성하려면 다음 함수 중 하나를 호출하면 됩니다.

HTML 이메일 메시지를 보내려면 TEXT_HTML 함수를 호출합니다.
일반 텍스트 이메일 메시지를 보내려면 TEXT_PLAIN 함수를 호출합니다.
JSON 메시지를 큐로 보내려면 APPLICATION_JSON 함수를 호출합니다.

integration_configuration

알림 통합 또는 알림을 보내는 데 사용할 이메일 구성을 지정하는 JSON 형식의 문자열입니다. 문자열은 다음 형식 중 하나여야 합니다.

{ "<integration_name>": {} }

{ "<integration_name>": { <options> } }

여기서

"integration_name" 은 알림 통합의 이름입니다.

options 는 쉼표로 구분된 속성 목록(JSON 형식)으로, 통합에서 기본값을 재정의하는 값을 지정합니다. 다음 속성을 지정할 수 있습니다.


속성 이름	설명
`subject`	이메일 알림의 제목입니다. 예: { "subject" : "Service status update" } 제목은 256자를 초과할 수 없습니다. 이 속성을 설정하지 않으면 통합의 기본 제목 라인이 사용됩니다. 통합에 기본 제목 라인이 지정되지 않은 경우 `"Snowflake Email Notification"` 이 사용됩니다.
`toAddress`	이메일 알림의 “받는 사람:” 라인에 포함할 수신자의 이메일 주소 목록입니다. 이 목록의 형식을 JSON 배열로 지정합니다. 예: { "toAddress" : ["person_1@example.com", "person_2@example.com"] } 이 속성을 설정하지 않으면 저장 프로시저는 이메일 알림 통합 의 DEFAULT_RECIPIENTS 속성에 있는 이메일 주소 목록을 사용합니다.
`ccAddress`	이메일 알림의 “참조:” 라인에 포함할 수신자의 이메일 주소 목록입니다. 이 목록의 형식을 JSON 배열로 지정합니다. 예: { "ccAddress" : ["person_to_cc1@example.com", "person_to_cc2@example.com"] }
`bccAddress`	이메일 알림의 “숨은 참조:” 라인에 포함할 수신자의 이메일 주소 목록입니다. 이 목록의 형식을 JSON 배열로 지정합니다. 예: { "bccAddress" : ["person_to_bcc1@example.com", "person_to_bcc2@example.com"] }

예:

{ "my_queue_int": {} }

{ "my_email_int": { "subject" : "Different subject" } }

{ "my_email_int": { "subject" : "Different subject" }, { "toAddress": ["person_a@example.com"] }

통합 구성을 위한 JSON 형식의 문자열을 구성하려면 다음 함수 중 하나를 호출합니다.

큐로 알림을 보내거나 이메일 알림을 보내면서 이메일 알림 통합에 지정된 기본값을 사용하려면 INTEGRATION 함수를 호출합니다.
이메일 알림을 보내는 중이고 이메일 알림 통합에 지정된 기본값을 재정의하려면 EMAIL_INTEGRATION_CONFIG 함수를 호출합니다.

( message [ , message , ... ] )

메시지 유형과 내용을 각각 지정하는 JSON 형식의 문자열로 구성된 ARRAY입니다. 여러 형식으로 메시지를 보내려면 이 인자를 지정합니다.

각 메시지는 위에서 설명한 형식 을 사용해야 합니다.

ARRAY를 구성하려면 ARRAY_CONSTRUCT 함수를 호출합니다.

참고

ARRAY에는 동일한 메시지 콘텐츠 유형에 대해 두 개 이상의 오브젝트를 포함할 수 없습니다

( integration_configuration [ , integration_configuration , ... ] )

각각 사용할 알림 통합 및 구성을 지정하는 JSON 형식의 문자열로 구성된 ARRAY입니다. 여러 알림 통합 또는 이메일 구성을 사용하여 메시지를 보내려면 이 인자를 지정합니다.

각 통합 구성은 위에서 설명한 형식 을 사용해야 합니다.

ARRAY를 구성하려면 ARRAY_CONSTRUCT 함수를 호출합니다.

참고

ARRAY에는 동일한 알림 통합에 대해 두 개 이상의 오브젝트가 포함될 수 없습니다.

반환¶

저장 프로시저가 성공적으로 실행되면 “큐에 포함된 알림” 문자열이 반환됩니다.

사용법 노트¶

이메일 알림의 경우 알림 통합에서 DEFAULT_RECIPIENTS 속성이 설정되어 있지 않고 SYSTEM$SEND_SNOWFLAKE_NOTIFICATION 호출에서 toAddress: 속성을 설정하지 않으면 호출이 실패합니다.
웹후크 알림의 경우 SANITIZE_WEBHOOK_CONTENT 를 호출하여 메시지를 정리한 후 메시지를 SYSTEM$SEND_SNOWFLAKE_NOTIFICATION에 전달합니다.

예¶

SYSTEM$SEND_SNOWFLAKE_NOTIFICATION을 사용하여 알림 보내기 섹션을 참조하십시오.