CREATE NOTIFICATION INTEGRATION (eingehend von einem Azure Event Grid-Thema)

Erstellt eine neue Benachrichtigungsintegration im Konto oder ersetzt eine bestehende Integration für den Empfang von Meldungen aus einem Azure Event Grid-Thema.

Siehe auch:

ALTER NOTIFICATION INTEGRATION (eingehend von einem Azure Event Grid-Thema) , DESCRIBE INTEGRATION , DROP INTEGRATION , SHOW INTEGRATIONS

Syntax

CREATE [ OR REPLACE ] NOTIFICATION INTEGRATION [ IF NOT EXISTS ] <name>
  ENABLED = { TRUE | FALSE }
  TYPE = QUEUE
  NOTIFICATION_PROVIDER = AZURE_STORAGE_QUEUE
  AZURE_STORAGE_QUEUE_PRIMARY_URI = '<queue_url>'
  AZURE_TENANT_ID = '<ad_directory_id>';
  [ 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.

NOTIFICATION_PROVIDER = AZURE_STORAGE_QUEUE

Gibt Microsoft Azure Event Grid als Cloud-Nachrichtenwarteschlangendienst eines Drittanbieters an.

AZURE_STORAGE_QUEUE_PRIMARY_URI = 'queue_url

Gibt die Warteschlangen-URL der Azure Queue Storage-Warteschlange an, die für Event Grid-Benachrichtigungen erstellt wurde. Verwenden Sie eine URL im folgenden Format:

https://storage_queue_account.queue.core.windows.net/storage_queue_name

Bemerkung

Eine einzelne Benachrichtigungsintegration unterstützt genau eine Azure Storage-Warteschlange. Wenn mehrere Benachrichtigungsintegrationen auf dieselbe Speicherwarteschlange verweisen, kann dies zu fehlenden Daten in den Zieltabellen führen, da Ereignisbenachrichtigungen zwischen Benachrichtigungsintegrationen aufgeteilt werden.

AZURE_TENANT_ID = 'ad_directory_id'

Gibt die ID des Azure Active Directory-Mandanten an, der für die Identitätsverwaltung verwendet wird. Diese ID wird benötigt, um die Zustimmungs-URL zu generieren, die Snowflake Zugriff auf das Event Grid-Abonnement gewährt.

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

  • Die Erstellung einer einzigen Benachrichtigungsintegration für mehrere Microsoft Azure Storage-Warteschlangen wird nicht unterstützt.

    Wenn Sie eine neue Pipe unter Verwendung einer Benachrichtigungsintegration erstellen, die dieselbe Warteschlangen-URL wie eine andere Benachrichtigungsintegration hat, schlägt das Erstellen der Pipe mit einem Fehler fehl:

    Notification queue already in use with another integration.

  • Das Verwenden derselben Microsoft Azure Storage-Warteschlange für mehrere eingehende Benachrichtigungsintegrationen wird nicht unterstützt, wenn es sich um automatisiertes Datenladen oder Metadaten-Aktualisierungen handelt.

  • 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 finden Sie unter Azure Government.

Beispiele

Siehe die folgenden Themen:

Sprache: Deutsch