Catégories :

Utilisateur et sécurité DDL (Intégrations de services tiers)

ALTER NOTIFICATION INTEGRATION

Modifie les propriétés d’une intégration de notification existante.

Voir aussi :

CREATE NOTIFICATION INTEGRATION , DROP INTEGRATION , SHOW INTEGRATIONS

Dans ce chapitre :

Syntaxe

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

ALTER [ NOTIFICATION ] INTEGRATION <name> SET TAG <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' ... ]

ALTER [ NOTIFICATION ] INTEGRATION <name> UNSET TAG <tag_name> [ , <tag_name> ... ]

ALTER [ NOTIFICATION ] INTEGRATION [ IF EXISTS ] <name> UNSET
  ENABLED |
  COMMENT

Où :

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>'

Paramètres

nom

Identificateur pour l’intégration à modifier. Si l’identificateur contient des espaces ou des caractères spéciaux, toute la chaîne doit être délimitée par des guillemets doubles. Les identificateurs entre guillemets doubles sont également sensibles à la casse.

SET ...

Spécifie un(e) ou plusieurs paramètre(s)/propriété(s) à définir pour la table (séparés par des espaces, des virgules ou de nouvelles lignes) :

ENABLED = TRUE | FALSE Spécifie s’il faut initier l’opération de l’intégration ou la suspendre.

  • TRUE permet l’exécution de l’intégration en fonction des paramètres spécifiés dans la définition de canal.

  • FALSE suspend l’intégration pour la maintenance. Toute intégration entre Snowflake et un service tiers échoue.

TAG nom_balise = 'valeur_balise' [ , nom_balise = 'valeur_balise' , ... ]

Spécifie le nom de la balise (c’est-à-dire la clé) et la valeur de la balise.

La valeur de la balise est toujours une chaîne de caractères et le nombre maximum de caractères pour la valeur de la balise est 256. Le nombre maximum de clés de balises uniques pouvant être définies sur un objet est de 20.

COMMENT = 'littéral_chaine'

Chaîne (littérale) qui spécifie un commentaire pour l’intégration.

UNSET ...

Spécifie un(e) ou plusieurs propriété(s)/paramètre(s) à désactiver pour l’intégration API, ce qui les réinitialise à leurs valeurs par défaut :

  • ENABLED

  • TAG nom_balise [ , nom_balise ... ]

  • COMMENT

Paramètres du fournisseur Cloud (cloudProviderParams)

Microsoft Azure

AZURE_STORAGE_QUEUE_PRIMARY_URI = 'https://compte_file_stockage.queue.core.windows.net/nom_file_stockage'

Spécifie l’ID de file d’attente pour la file d’attente de stockage Azure Queue Storage créée pour les notifications Event Grid.

Note

Une file d’attente Azure Queue Storage prend en charge une intégration de notification unique. Le fait de référencer une file d’attente de stockage unique dans plusieurs intégrations de notification peut entraîner des données manquantes dans les tables cibles, car les notifications d’événements sont réparties entre les intégrations de notification.

Pour plus d’informations, voir :

Snowpipe

Automatisation de Snowpipe pour le stockage Microsoft Azure Blob

Tables externes

Actualisation automatique des tables externes pour Azure Blob Storage

AZURE_TENANT_ID = 'id_répertoire_ad'

Spécifie l’ID du client Azure Active Directory utilisé pour la gestion des identités. Cet ID est nécessaire pour générer l’URL de consentement qui accorde à Snowflake l’accès à l’abonnement aux notifications Event Grid, utilisé pour déclencher automatiquement des chargements par Snowpipe de nouveaux fichiers dans le stockage Blob.

Notes sur l’utilisation

  • Cette commande ne prend pas en charge les abonnements Google Cloud Pub/Sub. Pour modifier un paramètre d’une intégration de notification existante pour un abonnement Pub/Sub, vous devez recréer l’objet (en utilisant CREATE OR REPLACE NOTIFICATION INTEGRATION).

  • Concernant les métadonnées :

    Attention

    Les clients doivent s’assurer qu’aucune donnée personnelle (autre que pour un objet utilisateur), donnée sensible, donnée à exportation contrôlée ou autre donnée réglementée n’est saisie comme métadonnée lors de l’utilisation du service Snowflake. Pour plus d’informations, voir Champs de métadonnées dans Snowflake.

Exemples

L’exemple suivant lance l’opération d’une intégration suspendue :

ALTER NOTIFICATION INTEGRATION myint SET ENABLED = TRUE;