SYSTEM$SEND_SNOWFLAKE_NOTIFICATION¶

Sintaxe¶

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

Argumentos¶

message

Cadeia de caracteres com formatação JSON que especifica o tipo e o conteúdo da mensagem. A cadeia de caracteres deve estar no seguinte formato:

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

Copy

Onde:

• "content_type" é um dos seguintes:

  • "text/plain" para mensagens de texto simples.

  • "text/html" para mensagens HTML.

  • "application/json" para mensagens JSON.

• "<message_contents>" é o conteúdo da mensagem.

Por exemplo:

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

Copy

Para construir esta cadeia de caracteres, você pode chamar uma das seguintes funções:

• Para enviar uma mensagem HTML de e-mail, chame a função TEXT_HTML.

• Para enviar uma mensagem de e-mail em texto simples, chame a função TEXT_PLAIN.

• Para enviar uma mensagem JSON para uma fila, chame a função APPLICATION_JSON.

integration_configuration

A cadeia de caracteres com formatação JSON que especifica a integração de notificação ou a configuração de e-mail a ser usada para enviar a notificação. A cadeia de caracteres deve ter um dos seguintes formatos:

{ "<integration_name>": {} }

Copy

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

Copy

Onde:

• "integration_name" é o nome da integração de notificação.

• options é uma lista de propriedades delimitada por vírgulas (em formato JSON) que especificam valores que substituem os padrões na integração. Você pode especificar as seguintes propriedades:

  Nome da propriedade	Descrição
  subject	Linha de assunto da notificação por e-mail. Por exemplo: { "subject" : "Service status update" } Copy O assunto não pode exceder 256 caracteres. Se você não definir essa propriedade, a linha de assunto padrão da integração será usada. Se a integração não especificar uma linha de assunto padrão, "Snowflake Email Notification" será usado.
  toAddress	Lista de endereços de e-mail dos destinatários a serem incluídos na linha “To:” da notificação por e-mail. Formate esta lista como uma matriz JSON. Por exemplo: { "toAddress" : ["person_1@example.com", "person_2@example.com"] } Copy Se você não definir esta propriedade, o procedimento armazenado usará a lista de endereços de e-mail da propriedade DEFAULT_RECIPIENTS da integração de notificação por e-mail.
  ccAddress	Lista de endereços de e-mail dos destinatários a serem incluídos na linha “Cc:” da notificação por e-mail. Formate esta lista como uma matriz JSON. Por exemplo: { "ccAddress" : ["person_to_cc1@example.com", "person_to_cc2@example.com"] } Copy
  bccAddress	Lista de endereços de e-mail dos destinatários a serem incluídos na linha “Bcc:” da notificação por e-mail. Formate esta lista como uma matriz JSON. Por exemplo: { "bccAddress" : ["person_to_bcc1@example.com", "person_to_bcc2@example.com"] } Copy

  Por exemplo:

  { "my_queue_int": {} }
  

  Copy

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

  Copy

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

  Copy

Para criar cadeias de caracteres com formatação JSON para a configuração de integração, chame uma das seguintes funções:

• Se você estiver enviando a notificação para uma fila ou se estiver enviando uma notificação por e-mail e quiser usar os valores padrão especificados na integração de notificação por e-mail, chame a função INTEGRATION.

• Se você estiver enviando uma notificação por e-mail e quiser substituir os valores padrão especificados na integração de notificação por e-mail, chame a função EMAIL_INTEGRATION_CONFIG.

( message [ , message , ... ] )

ARRAY de cadeias de caracteres com formatação JSON, cada uma das quais especifica um tipo de mensagem e conteúdo. Especifique este argumento se quiser enviar uma mensagem em vários formatos.

Cada mensagem deve usar o formato descrito acima.

Para criar a ARRAY, chame a função ARRAY_CONSTRUCT.

Nota

A ARRAY não pode conter mais de um objeto para o mesmo tipo de conteúdo de mensagem.

( integration_configuration [ , integration_configuration , ... ] )

ARRAY de cadeias de caracteres com formatação JSON, cada uma das quais especifica uma integração e configuração de notificação a ser usada. Especifique este argumento se quiser usar várias integrações de notificação ou configurações de e-mail para enviar uma mensagem.

Cada configuração de integração deve usar o formato descrito acima.

Para criar a ARRAY, chame a função ARRAY_CONSTRUCT.

Nota

A ARRAY não pode conter mais de um objeto para a mesma integração de notificação.

Retornos¶

Se o procedimento armazenado for executado com sucesso, ele retornará a cadeia de caracteres “Notificações enfileiradas”.

Notas de uso¶

• Para notificações por e-mail, se a propriedade DEFAULT_RECIPIENTS não estiver definida na integração de notificação e você não definir a propriedade toAddress: na chamada SYSTEM$SEND_SNOWFLAKE_NOTIFICATION, a chamada falhará.

• Para notificações de webhook, chame SANITIZE_WEBHOOK_CONTENT para higienizar a mensagem antes de passar a mensagem para SYSTEM$SEND_SNOWFLAKE_NOTIFICATION.

Exemplos¶

Consulte Uso de SYSTEM$SEND_SNOWFLAKE_NOTIFICATION para enviar notificações.