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 Amazon S3) ::=
  AWS_SNS_TOPIC_ARN = '<topic_arn>'
  AWS_SNS_ROLE_ARN = '<iam_role_arn>'

cloudProviderParams (for Google Cloud Storage) ::=
  GCP_PUBSUB_SUBSCRIPTION_NAME = '<subscription_id>'

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)

Amazon S3

AWS_SNS_TOPIC_ARN = '<topic_arn>'

Nom de la ressource Amazon (ARN) du sujet Amazon SNS (SNS) qui traite les messages d’erreur.

Notez que vous devez d’abord modifier la politique IAM pour le sujet et modifier la ressource pour le nouveau ARN du sujet. Pour plus d’informations, voir « Étape 2 : Création de la politique IAM » dans Activation des notifications d’erreur pour Snowpipe.

AWS_SNS_ROLE_ARN = '<iam_role_arn>'

ARN du rôle IAM qui a les autorisations pour publier des messages d’erreur dans le sujet SNS.

Notez que vous devez mettre à jour la politique IAM pour le rôle et accorder l’action sts:AssumeRole à l’utilisateur Snowflake. Pour plus d’informations, voir « Modifier la relation de confiance dans le rôle IAM » dans Activation des notifications d’erreur pour Snowpipe.

Google Cloud Storage

GCP_PUBSUB_SUBSCRIPTION_NAME = '<subscription_id>'

ID d’abonnement à un sujet Pub/Sub utilisé pour permettre à Snowflake d’accéder aux messages d’événement.

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

  • 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;
⇧
Revenir au début