CREATE NOTIFICATION INTEGRATION (ausgehend zu einem Amazon SNS-Thema)

Erstellt eine neue Benachrichtigungsintegration im Konto oder ersetzt eine bestehende Integration für , die eine Meldung an ein Amazon-SNS-Thema sendet.

Bemerkung

Derzeit ist dieses Feature auf Snowflake-Konten beschränkt, die auf AWS gehostet werden.

Siehe auch:

ALTER NOTIFICATION INTEGRATION (ausgehend zu einem Amazon SNS-Thema) , DESCRIBE INTEGRATION , DROP INTEGRATION , SHOW INTEGRATIONS

Syntax

CREATE [ OR REPLACE ] NOTIFICATION INTEGRATION [ IF NOT EXISTS ] <name>
  ENABLED = { TRUE | FALSE }
  TYPE = QUEUE
  DIRECTION = OUTBOUND
  NOTIFICATION_PROVIDER = AWS_SNS
  AWS_SNS_TOPIC_ARN = '<topic_arn>'
  AWS_SNS_ROLE_ARN = '<iam_role_arn>'
  [ COMMENT = '<string_literal>' ]
Copy

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 = QUEUE

Gibt an, dass es sich hierbei um eine Integration zwischen Snowflake und einem Cloud-Nachrichtenwarteschlangen-Dienst eines Drittanbieters handelt.

DIRECTION = OUTBOUND

Gibt an, dass Snowflake die an den Cloudmessagingdienst gesendete Benachrichtigung erstellt.

NOTIFICATION_PROVIDER = AWS_SNS

Gibt Amazon Simple Notification Service (SNS) als Cloud-Meldungswarteschlangendienst eines Drittanbieters an.

AWS_SNS_TOPIC_ARN = 'topic_arn'

Amazon Resource Name (ARN) des Amazon SNS (SNS)-Themas, an das Benachrichtigungen gesendet werden.

AWS_SNS_ROLE_ARN = 'iam_role_arn'

ARN der IAM-Rolle, die die Berechtigung hat, Meldungen im SNS-Thema zu veröffentlichen.

Bemerkung

Beim AWS_SNS_ROLE_ARN-Wert wird zwischen Groß- und Kleinschreibung unterschieden. Verwenden Sie den genauen Wert, der in Ihrem AWS-Konto angegeben ist.

Optionale Parameter

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

  • Das Verwenden derselben ausgehenden Benachrichtigungsintegration für mehrere Pipes wird für Push-Benachrichtigungen unterstützt.

  • 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.

  • In den von den Cloudanbietern bereitgestellten Regionen für Regierungsbehörden ist das Senden und Empfangen von Ereignisbenachrichtigungen an oder aus anderen kommerziellen Regionen nicht zulässig. Weitere Informationen dazu finden Sie unter AWS GovCloud (US).

Beispiele

Siehe die folgenden Themen:

Sprache: Deutsch