SYSTEM$SEND_SNOWFLAKE_NOTIFICATION¶

Syntax¶

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

Argumente¶

message

JSON-formatierte Zeichenfolge, die den Typ und den Inhalt der Nachricht angibt. Die Zeichenfolge muss das folgende Format haben:

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

Copy

Wobei:

• "content_type" ist eine der folgenden Optionen:

  • "text/plain" für reine Textnachrichten.

  • "text/html" für HTML-Nachrichten.

  • "application/json" für JSON-Nachrichten.

• "<message_contents>" ist der Inhalt der Nachricht.

Beispiel:

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

Copy

Um diese Zeichenfolge zu erstellen, können Sie eine der folgenden Funktionen aufrufen:

• Um eine E-Mail-Nachricht an HTML zu senden, rufen Sie die Funktion TEXT_HTML auf.

• Um eine E-Mail-Nachricht im Klartext zu senden, rufen Sie die Funktion TEXT_PLAIN auf.

• Um eine JSON-Nachricht an eine Warteschlange zu senden, rufen Sie die Funktion APPLICATION_JSON auf.

integration_configuration

JSON-formatierte Zeichenfolge, die die Benachrichtigungsintegration oder die E-Mail-Konfiguration angibt, die für das Senden der Benachrichtigung verwendet werden soll. Die Zeichenfolge muss eines der folgenden Formate haben:

{ "<integration_name>": {} }

Copy

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

Copy

Wobei:

• "integration_name" ist der Name der Benachrichtigungsintegration.

• options ist eine durch Kommas getrennte Liste von Eigenschaften (im JSON-Format), die Werte angeben, die die Standardwerte der Integration überschreiben. Sie können die folgenden Eigenschaften angeben:

  Name der Eigenschaft	Beschreibung
  subject	Betreffzeile der E-Mail-Benachrichtigung. Beispiel: { "subject" : "Service status update" } Copy Der Betreff darf maximal 256 Zeichen lang sein. Wenn Sie diese Eigenschaft nicht festlegen, wird die Standard-Betreffzeile aus der Integration verwendet. Wenn in der Integration keine Standard-Betreffzeile angegeben ist, wird "Snowflake Email Notification" verwendet.
  toAddress	Liste der E-Mail-Adressen der Empfänger, die in die „An:“-Zeile der E-Mail-Benachrichtigung aufgenommen werden sollen. Formatieren Sie diese Liste als JSON-Array. Beispiel: { "toAddress" : ["person_1@example.com", "person_2@example.com"] } Copy Wenn Sie diese Eigenschaft nicht festlegen, verwendet die gespeicherte Prozedur die Liste der E-Mail-Adressen aus der Eigenschaft DEFAULT_RECIPIENTS der E-Mail-Benachrichtigungsintegration.
  ccAddress	Liste der E-Mail-Adressen der Empfänger, die in die „Cc:“-Zeile der E-Mail-Benachrichtigung aufgenommen werden sollen. Formatieren Sie diese Liste als JSON-Array. Beispiel: { "ccAddress" : ["person_to_cc1@example.com", "person_to_cc2@example.com"] } Copy
  bccAddress	Liste der E-Mail-Adressen der Empfänger, die in die „Bcc:“-Zeile der E-Mail-Benachrichtigung aufgenommen werden sollen. Formatieren Sie diese Liste als JSON-Array. Beispiel: { "bccAddress" : ["person_to_bcc1@example.com", "person_to_bcc2@example.com"] } Copy

  Beispiel:

  { "my_queue_int": {} }
  

  Copy

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

  Copy

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

  Copy

Um die JSON-formatierten Zeichenfolgen für die Integrationskonfiguration zu erstellen, rufen Sie eine der folgenden Funktionen auf:

• Wenn Sie die Benachrichtigung an eine Warteschlange senden oder wenn Sie eine E-Mail-Benachrichtigung senden und die in der E-Mail-Benachrichtigungsintegration angegebenen Standardwerte verwenden möchten, rufen Sie die Funktion INTEGRATION auf.

• Wenn Sie eine E-Mail-Benachrichtigung versenden und die in der E-Mail-Benachrichtigungsintegration festgelegten Standardwerte überschreiben möchten, rufen Sie die Funktion EMAIL_INTEGRATION_CONFIG auf.

( message [ , message , ... ] )

ARRAY von JSON-formatierten Zeichenfolgen, die jeweils einen Nachrichtentyp und einen Inhalt angeben. Geben Sie dieses Argument an, wenn Sie eine Nachricht in mehreren Formaten versenden möchten.

Jede Nachricht sollte das oben beschriebene Format verwenden.

Um das ARRAY zu erstellen, rufen Sie die Funktion ARRAY_CONSTRUCT auf.

Bemerkung

Das ARRAY kann nicht mehr als ein Objekt für denselben Inhaltstyp einer Nachricht enthalten.

( integration_configuration [ , integration_configuration , ... ] )

ARRAY von JSON-formatierten Zeichenfolgen, von denen jede eine zu verwendende Benachrichtigungsintegration und -konfiguration angibt. Geben Sie dieses Argument an, wenn Sie mehrere Benachrichtigungsintegrationen oder E-Mail-Konfigurationen für den Versand einer Nachricht verwenden möchten.

Jede Integrationskonfiguration sollte das oben beschriebene Format verwenden.

Um das ARRAY zu erstellen, rufen Sie die Funktion ARRAY_CONSTRUCT auf.

Bemerkung

Das ARRAY kann nicht mehr als ein Objekt für dieselbe Benachrichtigungsintegration enthalten.

Rückgabewerte¶

Wenn die gespeicherte Prozedur erfolgreich ausgeführt wird, gibt sie die Zeichenfolge „Enqueued notifications“ zurück.

Nutzungshinweise¶

• Wenn für E-Mail-Benachrichtigungen die Eigenschaft DEFAULT_RECIPIENTS in der Benachrichtigungsintegration nicht festgelegt ist und Sie die Eigenschaft toAddress: im SYSTEM$SEND_SNOWFLAKE_NOTIFICATION-Aufruf nicht festlegen, schlägt der Aufruf fehl.

• Für Webhook-Benachrichtigungen rufen Sie SANITIZE_WEBHOOK_CONTENT auf, um die Meldung zu bereinigen, bevor Sie sie an SYSTEM$SEND_SNOWFLAKE_NOTIFICATION weitergeben..

Beispiele¶

Siehe Verwenden von SYSTEM$SEND_SNOWFLAKE_NOTIFICATION zum Versenden von Benachrichtigungen.