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> , ... ] ) )
Copy

인자

message

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

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

여기서

  • "content_type" 은 다음 중 하나입니다.

    • 일반 텍스트 메시지의 경우 "text/plain".

    • HTML 메시지의 경우 "text/html".

    • JSON 메시지의 경우 "application/json".

  • "<message_contents>" 는 메시지의 내용입니다.

예:

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

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

  • HTML 이메일 메시지를 보내려면 TEXT_HTML 함수를 호출합니다.

  • 일반 텍스트 이메일 메시지를 보내려면 TEXT_PLAIN 함수를 호출합니다.

  • JSON 메시지를 큐로 보내려면 APPLICATION_JSON 함수를 호출합니다.

integration_configuration

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

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

여기서

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

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

    속성 이름

    설명

    subject

    이메일 알림의 제목입니다. 예:

    { "subject" : "Service status update" }
    Copy

    제목은 256자를 초과할 수 없습니다.

    이 속성을 설정하지 않으면 통합의 기본 제목 라인이 사용됩니다.

    통합에 기본 제목 라인이 지정되지 않은 경우 "Snowflake Email Notification" 이 사용됩니다.

    toAddress

    이메일 알림의 “받는 사람:” 라인에 포함할 수신자의 이메일 주소 목록입니다.

    이 목록의 형식을 JSON 배열로 지정합니다. 예:

    { "toAddress" : ["person_1@example.com", "person_2@example.com"] }
    Copy

    이 속성을 설정하지 않으면 저장 프로시저는 이메일 알림 통합 의 DEFAULT_RECIPIENTS 속성에 있는 이메일 주소 목록을 사용합니다.

    ccAddress

    이메일 알림의 “참조:” 라인에 포함할 수신자의 이메일 주소 목록입니다.

    이 목록의 형식을 JSON 배열로 지정합니다. 예:

    { "ccAddress" : ["person_to_cc1@example.com", "person_to_cc2@example.com"] }
    Copy

    bccAddress

    이메일 알림의 “숨은 참조:” 라인에 포함할 수신자의 이메일 주소 목록입니다.

    이 목록의 형식을 JSON 배열로 지정합니다. 예:

    { "bccAddress" : ["person_to_bcc1@example.com", "person_to_bcc2@example.com"] }
    Copy

    예:

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

통합 구성을 위한 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을 사용하여 알림 보내기 섹션을 참조하십시오.

언어: 한국어