Senden von E-Mail-Benachrichtigungen

So senden Sie eine E-Mail-Benachrichtigung:

  1. Stellen Sie sicher, dass die vorgesehenen Empfänger ihre E-Mail-Adressen verifizieren.

  2. Erstellen Sie eine Benachrichtigungsintegration.

  3. Rufen Sie eine gespeicherte Prozedur auf, um die Benachrichtigung zu senden.

E-Mail-Adressen der E-Mail-Benachrichtigungsempfänger verifizieren

Sie können E-Mail-Benachrichtigungen nur an Snowflake-Benutzer innerhalb desselben Kontos senden. Diese Benutzer müssen ihre E-Mail-Adressen über eine der folgenden Schnittstellen verifizieren:

Integration für E-Mail-Benachrichtigungen erstellen

Um E-Mail-Benachrichtigungen zu versenden, verwenden Sie eine E-Mail-Benachrichtigungsintegration, die Sie mit dem Befehl CREATE NOTIFICATION INTEGRATION erstellen.

Bemerkung

Sie müssen eine Rolle verwenden, die über die globale Berechtigung CREATE INTEGRATION verfügt, um diesen Befehl ausführen zu können.

Um beispielsweise eine E-Mail-Benachrichtigungsintegration mit dem Namen my_email_int erstellen, führen Sie die folgende Anweisung aus:

CREATE NOTIFICATION INTEGRATION my_email_int
  TYPE=EMAIL
  ENABLED=TRUE;
Copy

Schränken Sie die Liste der E-Mail-Adressen ein, die Benachrichtigungen erhalten können

Wenn Sie die Liste der E-Mail-Adressen, die über diese Integration Benachrichtigungen erhalten können, einschränken möchten, setzen Sie ALLOWED_RECIPIENTS auf die Liste dieser E-Mail-Adressen. Wenn Sie ALLOWED_RECIPIENTS nicht einstellen, kann die Integration genutzt werden, um Benachrichtigungen an jeden Benutzer des Kontos zu senden, vorausgesetzt, der Benutzer hat eine verifizierte E-Mail-Adresse.

Bemerkung

Stellen Sie für jede E-Mail-Adresse in ALLOWED_RECIPIENTS sicher, dass sie verifiziert ist. Wenn Sie eine E-Mail-Adresse angeben, die nicht verifiziert wurde, schlägt der Befehl CREATE NOTIFICATION INTEGRATION mit einem Fehler fehl.

Um die Benachrichtigungsintegration beispielsweise so einzuschränken, sodass E-Mail-Nachrichten nur an first.last@example.com und first2.last2@example.com gesendet werden, setzen Sie ALLOWED_RECIPIENTS auf die Liste dieser Adressen:

CREATE NOTIFICATION INTEGRATION my_email_int
  TYPE=EMAIL
  ENABLED=TRUE
  ALLOWED_RECIPIENTS=('first.last@example.com','first2.last2@example.com');
Copy

Weitere Informationen zur Syntax dieses Befehls finden Sie unter CREATE NOTIFICATION INTEGRATION (E-Mail).

Geben Sie eine Standard-Empfängerliste und eine Standard-Betreffzeile an

Wenn Sie die gespeicherte Prozedur SYSTEM$SEND_SNOWFLAKE_NOTIFICATION verwenden, um E-Mail-Benachrichtigungen zu versenden, können Sie die Benachrichtigungsintegration mit einer Standardliste von E-Mail-Adressen und einer Standard-Betreffzeile konfigurieren, die verwendet werden sollen. Sie können die Standardliste und die Standard-Betreffzeile überschreiben, wenn Sie die gespeicherte Prozedur aufrufen.

  • Um eine Standardliste von E-Mail-Adressen festzulegen, legen Sie die Eigenschaft DEFAULT_RECIPIENTS der Benachrichtigungsintegration fest.

  • Um eine Standard-Betreffzeile festzulegen, legen Sie die Eigenschaft DEFAULT_SUBJECT der Benachrichtigungsintegration fest.

Angenommen, Sie möchten eine E-Mail-Benachrichtigungsintegration für den folgenden Zweck einrichten:

  • Sie senden E-Mail-Benachrichtigungen meist an person_a@example.com und person_b@example.com, aber Sie möchten auch die Möglichkeit haben, die Benachrichtigungen an die validierten E-Mail-Adressen aller Benutzer in Ihrem Konto zu senden.

  • Sie möchten, dass die meisten Nachrichten die Betreffzeile „Dienststatus“ verwenden, aber Sie möchten für bestimmte Nachrichten eine andere Betreffzeile verwenden können.

Um eine E-Mail-Benachrichtigung für diesen Zweck zu erstellen, führen Sie den folgenden Befehl aus:

CREATE NOTIFICATION INTEGRATION my_email_int
  TYPE=EMAIL
  ENABLED=TRUE
  DEFAULT_RECIPIENTS = ('person_a@example.com','person_b@example.com')
  DEFAULT_SUBJECT = 'Service status';
Copy

Beim Senden der Benachrichtigung können Sie die Liste der Standardempfänger und die Standard-Betreffzeile überschreiben. Siehe Überschreiben Sie die Standardwerte in der E-Mail-Benachrichtigungsintegration.

Die Benachrichtigung per E-Mail senden

Sie können eine der folgenden gespeicherten Prozeduren aufrufen, um eine E-Mail-Benachrichtigung zu versenden: