DocumentationExperience PlatformGuide des connecteurs sources

[Ultimate]{class="badge positive"}

Source Snowflake

Last update: Wed Oct 29 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Rubriques :

Créé pour :

  • Développeur
IMPORTANT
  • La source Snowflake est disponible dans le catalogue des sources pour les utilisateurs qui ont acheté Real-Time Customer Data Platform Ultimate.
  • Par défaut, la source de Snowflake interprète null comme une chaîne vide. Contactez votre représentant Adobe pour vous assurer que vos valeurs null sont correctement écrites comme null dans Adobe Experience Platform.
  • Pour qu’Experience Platform ingère des données, les fuseaux horaires de toutes les sources de lots basées sur un tableau doivent être configurés au format UTC. Le seul horodatage pris en charge pour la source Snowflake est TIMESTAMP_NTZ avec l’heure UTC.

Adobe Experience Platform permet d’ingérer des données à partir de sources externes tout en vous offrant la possibilité de structurer, d’étiqueter et d’améliorer les données entrantes à l’aide des services d’Experience Platform. Vous pouvez ingérer des données provenant de diverses sources telles que les applications Adobe, le stockage dans le cloud, les bases de données, etc.

Experience Platform prend en charge l’ingestion de données provenant d’une base de données tierce. Experience Platform peut se connecter à différents types de bases de données tels que des entrepôts relationnels, NoSQL ou de données. La prise en charge des fournisseurs de base de données inclut Snowflake.

Conditions préalables prerequisites

Cette section décrit les tâches de configuration que vous devez effectuer avant de connecter votre source Snowflake à Experience Platform.

Liste autorisée d’adresses IP

Vous devez ajouter à votre place sur la liste autorisée des adresses IP spécifiques à une région avant de connecter vos sources à Experience Platform. Placer sur la liste autorisée Pour plus d’informations, consultez le guide sur la connexion des adresses IP à Experience Platform.

Collecter les informations d’identification requises

Vous devez fournir des valeurs pour les propriétés d’identification suivantes afin d’authentifier votre source Snowflake.

Authentification par clé de compte (Azure)

Fournissez des valeurs pour les informations d’identification suivantes pour connecter Snowflake à Experience Platform sur Azure à l’aide de l’authentification par clé de compte.

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2
Informations d’identification Description
account Un nom de compte identifie de manière unique un compte de votre organisation. Dans ce cas, vous devez identifier de manière unique un compte dans différentes organisations Snowflake. Pour ce faire, vous devez ajouter le nom de votre organisation au nom du compte. Par exemple : orgname-account_name. Lisez la section sur la récupération de l’identifiant Snowflake compte pour plus d’informations. Pour plus d’informations, consultez la Snowflake documentation.
warehouse L’entrepôt de Snowflake gère le processus d’exécution de la requête pour l’application. Chaque entrepôt de Snowflake est indépendant les uns des autres et doit être accessible individuellement lors de l’importation de données dans Experience Platform.
database La base de données Snowflake contient les données que vous souhaitez importer dans Experience Platform.
username Nom d’utilisateur du compte Snowflake.
password Mot de passe du compte utilisateur Snowflake.
role Rôle de contrôle d’accès par défaut à utiliser dans la session Snowflake. Le rôle doit être un rôle existant qui a déjà été attribué à l’utilisateur spécifié. Le rôle par défaut est PUBLIC.
connectionString Chaîne de connexion utilisée pour la connexion à votre instance Snowflake. Le modèle de chaîne de connexion pour Snowflake est jdbc:snowflake://{ACCOUNT_NAME}.snowflakecomputing.com/?user={USERNAME}&password={PASSWORD}&db={DATABASE}&warehouse={WAREHOUSE}.
Authentification par paire de clés (Azure)

Pour utiliser l’authentification par paire de clés, générez d’abord une paire de clés RSA 2 048 bits. Indiquez ensuite les valeurs des informations d’identification suivantes pour vous connecter à Experience Platform sur Azure à l’aide de l’authentification par paire de clés.

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2
Informations d’identification Description
account Un nom de compte identifie de manière unique un compte de votre organisation. Dans ce cas, vous devez identifier de manière unique un compte dans différentes organisations Snowflake. Pour ce faire, vous devez ajouter le nom de votre organisation au nom du compte. Par exemple : orgname-account_name. Lisez la section sur la récupération de l’identifiant Snowflake compte pour plus d’informations. Pour plus d’informations, consultez la Snowflake documentation.
username Nom d’utilisateur de votre compte Snowflake.
privateKey Clé privée Base64-encodée) de votre compte Snowflake. Vous pouvez générer des clés privées chiffrées ou non chiffrées. Si vous utilisez une clé privée chiffrée, vous devez également fournir une phrase secrète de clé privée lors de l’authentification auprès d’Experience Platform. Pour plus d’informations, consultez la section relative à la récupération de votre clé privée.
privateKeyPassphrase La phrase secrète de la clé privée est une couche de sécurité supplémentaire que vous devez utiliser lors de l’authentification avec une clé privée chiffrée. Vous n’êtes pas tenu de fournir la phrase secrète si vous utilisez une clé privée non chiffrée.
port Numéro de port utilisé par Snowflake lors de la connexion à un serveur via Internet.
database Base de données Snowflake contenant les données à ingérer dans Experience Platform.
warehouse L’entrepôt de Snowflake gère le processus d’exécution de la requête pour l’application. Chaque entrepôt de Snowflake est indépendant les uns des autres et doit être accessible individuellement lors de l’importation de données dans Experience Platform.

Pour plus d’informations sur ces valeurs, consultez le Snowflake guide d’authentification par paire de clés.

Authentification de base (AWS)

Fournissez des valeurs pour les informations d’identification suivantes pour connecter Snowflake à Experience Platform sur AWS à l’aide de l’authentification de base.

note warning
WARNING
L’authentification de base (ou authentification par clé de compte) de la source Snowflake sera abandonnée en novembre 2025. Vous devez passer à l’authentification par paire de clés pour continuer à utiliser la source et à ingérer des données de votre base de données vers Experience Platform. Pour plus d’informations sur l’obsolescence, consultez le Snowflake guide des bonnes pratiques sur la réduction des risques liés à la compromission des informations d’identification.
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2
Informations d’identification Description
host URL hôte à laquelle votre compte Snowflake se connecte.
port Numéro de port utilisé par Snowflake lors de la connexion à un serveur via Internet.
username Nom d’utilisateur associé à votre compte Snowflake.
password Mot de passe associé à votre compte Snowflake.
database Base de données Snowflake à partir de laquelle les données seront extraites.
schema Nom du schéma associé à votre base de données Snowflake. Vous devez vous assurer que l’utilisateur auquel vous souhaitez accorder l’accès à la base de données a également accès à ce schéma.
warehouse Entrepôt de Snowflake utilisé.
Authentification par paire de clés (AWS)

Pour utiliser l’authentification par paire de clés, générez d’abord une paire de clés RSA 2 048 bits. Indiquez ensuite les valeurs des informations d’identification suivantes pour vous connecter à Experience Platform sur AWS à l’aide de l’authentification par paire de clés.

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2
Informations d’identification Description
account Un nom de compte identifie de manière unique un compte de votre organisation. Dans ce cas, vous devez identifier de manière unique un compte dans différentes organisations Snowflake. Pour ce faire, vous devez ajouter le nom de votre organisation au nom du compte. Par exemple : orgname-account_name. Lisez le guide sur la récupération de l’identifiant Snowflake compte pour obtenir des conseils supplémentaires. Pour plus d’informations, consultez la Snowflake documentation.
username Nom d’utilisateur de votre compte Snowflake.
privateKey Clé privée de votre utilisateur Snowflake, codée en base64 sur une seule ligne, sans en-têtes ni sauts de ligne. Pour le préparer, copiez le contenu de votre fichier PEM, supprimez les lignes BEGIN/END et tous les sauts de ligne, puis codez le résultat en base64. Pour plus d’informations, consultez la section relative à la récupération de votre clé privée. Remarque : les clés privées chiffrées ne sont actuellement pas prises en charge pour une connexion AWS.
port Numéro de port utilisé par Snowflake lors de la connexion à un serveur via Internet.
database Base de données Snowflake contenant les données à ingérer dans Experience Platform.
warehouse L’entrepôt de Snowflake gère le processus d’exécution de la requête pour l’application. Chaque entrepôt de Snowflake est indépendant les uns des autres et doit être accessible individuellement lors de l’importation de données dans Experience Platform.

Pour plus d’informations sur ces valeurs, consultez le Snowflake guide d’authentification par paire de clés.

Récupérer l’identifiant de votre compte retrieve-your-account-identifier

Vous devez récupérer l’identifiant de votre compte à partir du tableau de bord de l’interface utilisateur Snowflake, car vous utiliserez l’identifiant du compte pour authentifier votre instance Snowflake sur Experience Platform.

Pour récupérer l’identifiant de votre compte :

  • Accédez à votre compte dans le tableau de bord de l’interface utilisateur de l’application Snowflake ​.
  • Dans le volet de navigation de gauche, sélectionnez Accounts, puis Active Accounts dans l’en-tête.
  • Sélectionnez ensuite l’icône d’information, puis sélectionnez et copiez le nom de domaine de l’URL active.

Tableau de bord de l’interface utilisateur de Snowflake avec le nom de domaine sélectionné.

Récupérer votre clé privée retrieve-your-private-key

Si vous utilisez l’authentification par paire de clés pour votre connexion Snowflake, vous devez également générer votre clé privée avant de vous connecter à Experience Platform.

Créer une clé privée chiffrée

Pour générer votre clé privée Snowflake chiffrée, exécutez la commande suivante sur votre terminal :

code language-shell 
openssl genrsa 2048 | openssl pkcs8 -topk8 -v2 des3 -inform PEM -out rsa_key.p8

En cas de réussite, vous devriez recevoir votre clé privée au format PEM.

code language-shell 
|-----BEGIN ENCRYPTED PRIVATE KEY-----
MIIE6T...
|-----END ENCRYPTED PRIVATE KEY-----
Créer une clé privée non chiffrée

Pour générer votre clé privée Snowflake non chiffrée, exécutez la commande suivante sur votre terminal :

code language-shell 
openssl genrsa 2048 | openssl pkcs8 -topk8 -inform PEM -out rsa_key.p8 -nocrypt

En cas de réussite, vous devriez recevoir votre clé privée au format PEM.

code language-shell 
|-----BEGIN PRIVATE KEY-----
MIIE6T...
|-----END PRIVATE KEY-----

Ensuite, prenez votre clé privée et codez-la en Base64. Assurez-vous de ne pas effectuer de transformations ou de conversions de format sur votre clé privée Snowflake. En outre, vous devez vous assurer qu’il n’y a aucun caractère de nouvelle ligne à la fin de votre clé privée, avant de la coder en Base64.

Vérifier les configurations

Avant de pouvoir créer une connexion source pour vos données Snowflake, vous devez également vous assurer que les configurations suivantes sont respectées :

  • L’entrepôt par défaut affecté à un utilisateur donné doit être le même que celui que vous saisissez lors de l’authentification auprès d’Experience Platform.
  • Le rôle par défaut attribué à un utilisateur donné doit avoir accès à la même base de données que celle que vous avez saisie lors de l’authentification auprès d’Experience Platform.

Pour vérifier votre rôle et votre entrepôt :

  • Sélectionnez Admin dans le volet de navigation de gauche, puis sélectionnez Users & Roles.
  • Sélectionnez l’utilisateur approprié, puis sélectionnez les points de suspension (...) dans le coin supérieur droit.
  • Dans la fenêtre de Edit user qui s’affiche, accédez à Default Role pour afficher le rôle associé à l’utilisateur donné.
  • Dans la même fenêtre, accédez à Default Warehouse pour afficher l'entrepôt associé à l'utilisateur donné.

Interface utilisateur de Snowflake dans laquelle vous pouvez vérifier votre rôle et votre entrepôt de données.

Une fois le codage réussi, vous pouvez utiliser cette clé privée codée en Base64 sur Experience Platform pour authentifier votre compte Snowflake.

La documentation ci-dessous fournit des informations sur la connexion de Snowflake à Experience Platform à l’aide d’API ou de l’interface utilisateur :

Connexion de Snowflake à Experience Platform à l’aide d’API

Connexion d’Snowflake à Experience Platform à l’aide de l’interface utilisateur

recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089