CREATE NOTIFICATION INTEGRATION (E-Mail)¶
Erstellt eine neue Benachrichtigungsintegration im Konto oder ersetzt eine vorhandene Integration für das Senden von E-Mail-Benachrichtigungen.
- Siehe auch:
ALTER NOTIFICATION INTEGRATION (E-Mail) , DESCRIBE INTEGRATION , DROP INTEGRATION , SHOW INTEGRATIONS
Syntax¶
CREATE [ OR REPLACE ] NOTIFICATION INTEGRATION [ IF NOT EXISTS ] <name>
TYPE = EMAIL
ENABLED = { TRUE | FALSE }
[ ALLOWED_RECIPIENTS = ( '<email_address>' [ , ... '<email_address>' ] ) ]
[ DEFAULT_RECIPIENTS = ( '<email_address>' [ , ... '<email_address>' ] ) ]
[ DEFAULT_SUBJECT = '<subject_line>' ]
[ COMMENT = '<string_literal>' ]
Erforderliche Parameter¶
name
Zeichenfolge, die den Bezeichner (d. h. den Namen) für die Integration angibt. Muss in Ihrem Konto eindeutig sein.
Darüber hinaus muss der Bezeichner mit einem Buchstaben beginnen und darf keine Leer- oder Sonderzeichen enthalten, es sei denn, die gesamte Bezeichnerzeichenfolge wird in doppelte Anführungszeichen gesetzt (z. B.
"My object"
). Bei Bezeichnern, die in doppelte Anführungszeichen eingeschlossen sind, ist auch die Groß-/Kleinschreibung zu beachten.Weitere Informationen dazu finden Sie unter Anforderungen an Bezeichner.
ENABLED = { TRUE | FALSE }
Gibt an, ob die Integrationsoperation gestartet oder angehalten werden soll.
TRUE
aktiviert die Integration.FALSE
deaktiviert die Integration für Wartungszwecke. Eine Integration zwischen Snowflake und einem Drittanbieterdienst funktioniert nicht.
TYPE = EMAIL
Gibt an, dass die Integration eine Weboberfläche zwischen Snowflake und einem E-Mail-Dienst eines Drittanbieters schafft.
Optionale Parameter¶
ALLOWED_RECIPIENTS = ( 'email_address' [ , ... 'email_address' ] )
(bei
TYPE = EMAIL
) Eine durch Kommas getrennte Liste von in Anführungszeichen geschriebenen E-Mail-Adressen, die E-Mail-Benachrichtigungen von dieser Integration erhalten können.Dabei müssen die E-Mail-Adressen von Benutzern des aktuellen Kontos angegeben werden. Diese Benutzer müssen ihre E-Mail-Adressen verifizieren.
Die maximale Anzahl von E-Mail-Adressen, die Sie angeben können, ist 50.
Wenn Sie diesen Parameter weglassen, können Sie E-Mail-Benachrichtigungen an jede verifizierte E-Mail-Adresse des aktuellen Kontos senden.
DEFAULT_RECIPIENTS = ( 'email_address' [ , ... 'email_address' ] )
Legt die Liste der Standardempfänger für Nachrichten fest, die mit dieser Integration versendet werden. Verwenden Sie eine durch Komma getrennte Liste von angegebenen E-Mail-Adressen, um die Standardempfänger festzulegen.
Dabei müssen die E-Mail-Adressen von Benutzern des aktuellen Kontos angegeben werden. Diese Benutzer müssen ihre E-Mail-Adressen verifizieren.
Um die Standardempfänger für eine bestimmte Nachricht zu überschreiben, verwenden Sie die Hilfsfunktion EMAIL_INTEGRATION_CONFIG beim Aufrufen der gespeicherten Prozedur SYSTEM$SEND_SNOWFLAKE_NOTIFICATION.
DEFAULT_SUBJECT = 'subject_line'
Legt die Standard-Betreffzeile für Nachrichten fest, die mit dieser Integration versendet werden.
Der Betreff darf maximal 256 Zeichen lang sein.
Standard: „Snowflake E-Mail-Benachrichtigung“
Um die Standard-Betreffzeile für eine bestimmte Nachricht zu überschreiben, verwenden Sie die Hilfsfunktion EMAIL_INTEGRATION_CONFIG beim Aufrufen der gespeicherten Prozedur SYSTEM$SEND_SNOWFLAKE_NOTIFICATION.
COMMENT = 'string_literal'
Zeichenfolge (Literal), die einen Kommentar zur Integration enthält.
Standard: Kein Wert
Anforderungen an die Zugriffssteuerung¶
Eine Rolle, die zur Ausführung dieses SQL-Befehls verwendet wird, muss mindestens die folgenden Berechtigungen haben:
Berechtigung |
Objekt |
Anmerkungen |
---|---|---|
CREATE INTEGRATION |
Konto |
Only the ACCOUNTADMIN role has this privilege by default. The privilege can be granted to additional roles as needed. |
Eine Anleitung zum Erstellen einer kundenspezifischen Rolle mit einer bestimmten Gruppe von Berechtigungen finden Sie unter Erstellen von kundenspezifischen Rollen.
Allgemeine Informationen zu Rollen und Berechtigungen zur Durchführung von SQL-Aktionen auf sicherungsfähigen Objekten finden Sie unter Übersicht zur Zugriffssteuerung.
Nutzungshinweise¶
Metadaten:
Achtung
Kunden müssen sicherstellen, dass bei der Nutzung des Snowflake-Dienstes keine personenbezogenen Daten (außer für ein Objekt „Benutzer“), sensible Daten, exportkontrollierte Daten oder andere regulierte Daten als Metadaten eingegeben werden. Weitere Informationen dazu finden Sie unter Metadatenfelder in Snowflake.
CREATE OR REPLACE <Objekt>-Anweisungen sind atomar. Das heißt, wenn ein Objekt ersetzt wird, erfolgt das Löschen des alten Objekts und das Erstellen des neuen Objekts in einer einzigen Transaktion.