Kategorien:

DDL für Benutzer und Sicherheit (Integrationen von Drittanbieterservices)

ALTER NOTIFICATION INTEGRATION

Ändert die Eigenschaften für eine bestehende Benachrichtigungsintegration.

Siehe auch:

CREATE NOTIFICATION INTEGRATION, DROP INTEGRATION, SHOW INTEGRATIONS

Unter diesem Thema:

Syntax

ALTER [ NOTIFICATION ] INTEGRATION [ IF EXISTS ] <name> SET
  [ ENABLED = { TRUE | FALSE } ]
  cloudProviderParams
  [ COMMENT = '<string_literal>' ]

Wobei:

cloudProviderParams (for Microsoft Azure) ::=
  AZURE_STORAGE_QUEUE_PRIMARY_URI = 'https://<storage_queue_account>.queue.core.windows.net/<storage_queue_name>'
  AZURE_TENANT_ID = '<ad_directory_id>'

Parameter

Name

Bezeichner für die zu ändernde Integration. Wenn der Bezeichner Leerzeichen oder Sonderzeichen enthält, muss die gesamte Zeichenfolge in doppelte Anführungszeichen gesetzt werden. Bei Bezeichnern, die in doppelte Anführungszeichen eingeschlossen sind, ist auch die Groß- und Kleinschreibung zu beachten.

SET ...

Gibt eine (oder mehrere) Eigenschaften/Parameter an, die für die Tabelle festgelegt werden sollen (getrennt durch Leerzeichen, Kommas oder neue Zeilen):

ENABLED = TRUE | FALSE gibt an, ob die Integrationsoperation gestartet oder angehalten werden soll.

  • TRUE ermöglicht die Ausführung der Integration basierend auf den in der Pipedefinition angegebenen Parametern.

  • FALSE hält die Integration für Wartungszwecke an. Eine Integration zwischen Snowflake und einem Drittanbieterdienst funktioniert nicht.

COMMENT = 'Zeichenfolgenliteral'

Zeichenfolge (Literal), die einen Kommentar zur Integration enthält.

Cloudanbieterparameter (cloudProviderParams)

Microsoft Azure

AZURE_STORAGE_QUEUE_PRIMARY_URI = 'https://Konto_der_Speicherwarteschlange.queue.core.windows.net/Name_der_Speicherwarteschlange'

Gibt die Warteschlangen-ID der Azure Queue Storage-Warteschlange an, die für Event Grid-Benachrichtigungen erstellt wurde.

Bemerkung

Eine Azure Queue Storage-Warteschlange unterstützt eine einzelne Benachrichtigungsintegration. Das Verweisen auf eine einzelne Speicherwarteschlange in mehreren Benachrichtigungsintegrationen kann dazu führen, dass Daten in Zieltabellen fehlen, da Ereignisbenachrichtigungen zwischen Benachrichtigungsintegrationen aufgeteilt werden.

Weitere Informationen dazu finden Sie unter:

Snowpipe

Automatisieren von Snowpipe für Microsoft Azure Blob-Speicher

Externe Tabellen

Automatisches Aktualisieren externer Tabellen für Azure Blob Storage

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, mit der Snowflake Zugriff auf das Abonnement für Event Grid-Benachrichtigungen erhält, damit Snowpipe-Ladevorgänge neuer Dateien im Blob-Speicher automatisch ausgelöst werden können.

Nutzungshinweise

  • Dieser Befehl unterstützt keine Google Cloud Pub/Sub-Abonnements. Um einen Parameter einer bestehenden Benachrichtigungsintegration für ein Pub/Sub-Abonnement zu ändern, müssen Sie das Objekt neu erstellen (mit CREATE OR REPLACE NOTIFICATION INTEGRATION).

Beispiele

Das folgende Beispiel leitet die Operation einer angehaltenen Integration ein:

ALTER NOTIFICATION INTEGRATION myint SET ENABLED = TRUE;