[Ultimate]{class="badge positive"}
Créer une connexion source Snowflake dans l’interface utilisateur
Ce tutoriel décrit les étapes de création d’un connecteur source Snowflake à l’aide de l’interface utilisateur de Adobe Experience Platform.
Prise en main
Ce tutoriel nécessite une compréhension du fonctionnement des composants suivants d’Adobe Experience Platform :
- Sources: Experience Platformpermet d’ingérer des données provenant de diverses sources tout en vous offrant la possibilité de structurer, d’étiqueter et d’améliorer les données entrantes à l’aide des services Platform.
- Sandbox : Experience Platform fournit des sandbox virtuels qui divisent une instance Platform unique en environnements virtuels distincts pour favoriser le développement et l’évolution d’applications d’expérience digitale.
Collecter les informations d’identification requises
Vous devez fournir des valeurs pour les propriétés d’identification suivantes pour authentifier votre source Snowflake.
| 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 |
| Compte | Un nom de compte identifie de manière unique un compte au sein de votre organisation. Dans ce cas, vous devez identifier de manière unique un compte parmi différentes organisations Snowflake. Pour ce faire, vous devez ajouter le nom de votre organisation en préfixe sur le nom du compte. Par exemple : orgname-account_name. Lisez le guide sur la récupération de votre Snowflake identifiant de compte pour plus d’informations. Pour plus d’informations, consultez la Snowflake documentation. |
| Entrepôt | L’entrepôt Snowflake gère le processus d’exécution de requête pour l’application. Chaque entrepôt Snowflake est indépendant l’un de l’autre et doit être accessible individuellement lors de la transmission de données à Platform. |
| Base de données | La base de données Snowflake contient les données que vous souhaitez importer dans Platform. |
| Nom d’utilisateur | Nom d’utilisateur du compte Snowflake. |
| Mot de passe | Mot de passe du compte utilisateur Snowflake. |
| Rôle | 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. |
| Chaîne de connexion | Chaîne de connexion utilisée pour se connecter à 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} |
Pour utiliser l’authentification par paire de clés, vous devez générer une paire de clés RSA 2 048 bits, puis fournir les valeurs suivantes lors de la création d’un compte pour votre source Snowflake.
| 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 |
| Compte | Un nom de compte identifie de manière unique un compte au sein de votre organisation. Dans ce cas, vous devez identifier de manière unique un compte parmi différentes organisations Snowflake. Pour ce faire, vous devez ajouter le nom de votre organisation en préfixe sur le nom du compte. Par exemple : orgname-account_name. Lisez le guide sur la récupération de votre Snowflake identifiant de compte pour plus d’informations. Pour plus d’informations, consultez la Snowflake documentation. |
| Nom d’utilisateur | Nom d’utilisateur de votre compte Snowflake. |
| Clé privée | La clé privée Base64- codé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 un mot de passe de clé privée lors de l’authentification par rapport à un Experience Platform. Pour plus d’informations, consultez le guide sur la récupération de votre Snowflake clé privée . |
| Passphrase de clé privée | La phrase secrète de clé privée est une couche supplémentaire de sécurité 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. |
| Base de données | La base de données Snowflake qui contient les données que vous souhaitez ingérer à l’Experience Platform. |
| Entrepôt | L’entrepôt Snowflake gère le processus d’exécution de requête pour l’application. Chaque entrepôt Snowflake est indépendant l’un de l’autre et doit être accessible individuellement lors de la transmission de données à Platform. |
Pour plus d'informations sur ces valeurs, consultez ce document de Snowflake.
PREVENT_UNLOAD_TO_INLINE_URL sur FALSE pour autoriser le déchargement des données de votre base de données Snowflake vers l’Experience Platform.Connexion à votre compte Snowflake
Dans l’interface utilisateur de Platform, sélectionnez Sources dans le volet de navigation de gauche pour accéder à l’espace de travail Sources.
Vous pouvez sélectionner la catégorie appropriée dans le catalogue sur le côté gauche de votre écran. Vous pouvez également sélectionner la source de votre choix à l’aide de la barre de recherche.
Sous la catégorie Bases de données, sélectionnez Snowflake, puis sélectionnez Ajouter des données.
La page Se connecter à Snowflake s’affiche. Sur cette page, vous pouvez utiliser de nouvelles informations d’identification ou des informations d’identification existantes.
Compte existant
Pour utiliser un compte existant, sélectionnez le compte Snowflake auquel vous souhaitez vous connecter, puis sélectionnez Suivant pour continuer.
Nouveau compte
Pour créer un nouveau compte, sélectionnez Nouveau compte, puis fournissez un nom et une description facultative de votre nouveau compte Snowflake.
Pour utiliser l'authentification par clé de compte, indiquez votre chaîne de connexion dans le formulaire de saisie, puis sélectionnez Se connecter à la source.
Pour utiliser l’authentification par paire de clés, indiquez les valeurs de votre compte, nom d’utilisateur, clé privée, mot de passe de clé privée, base de données et entrepôt, puis sélectionnez Se connecter à la source.
Ignorer l’aperçu des données d’exemple skip-preview-of-sample-data
Au cours de l’étape de sélection des données, vous pouvez rencontrer un délai d’expiration lors de l’ingestion de tables volumineuses ou de fichiers de données. Vous pouvez ignorer l’aperçu des données pour contourner le délai d’expiration et tout en affichant votre schéma, bien que sans exemple de données. Pour ignorer l’aperçu des données, activez la bascule Ignorer l’aperçu des données d’exemple .
Le reste du workflow restera le même. Le seul avertissement à retenir est que l’absence de prévisualisation des données peut empêcher la validation automatique des champs calculés et obligatoires lors de l’étape de mappage. Vous devrez ensuite valider manuellement ces champs lors du mappage.
Étapes suivantes
En suivant ce tutoriel, vous avez établi une connexion à votre compte de Snowflake. Vous pouvez maintenant passer au tutoriel suivant et configurer un flux de données pour importer des données dans Platform.