[Ultimate]{class="badge positive"}

Source Snowflake

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

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.

Prérequis prerequisites

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

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.

Liste autorisée d’adresses IP

Une liste d’adresses IP doit être ajoutée à une liste autorisée avant d’utiliser les connecteurs source. Si vous n’ajoutez pas vos adresses IP spécifiques à une région à votre liste autorisée, des erreurs ou une absence de performances peuvent se produire lors de l’utilisation de sources. Voir la page Liste autorisée d’adresses IP pour plus d’informations.

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