Connexion Azure Data Lake Storage Gen2
Présentation overview
Lisez cette page pour apprendre à créer une connexion sortante active vers votre lac de données Azure Data Lake Storage Gen2 (ADLS Gen2) pour exporter périodiquement des fichiers de données à partir d’Experience Platform.
Connexion à votre stockage ADLS Gen2 via l’API ou l’interface utilisateur connect-api-or-ui
- Pour vous connecter à votre emplacement de stockage ADLS Gen2 à l’aide de l’interface utilisateur de Platform, lisez les sections Se connecter à la destination et Activer les audiences vers cette destination ci-dessous.
- Pour vous connecter à votre emplacement de stockage ADLS Gen2 par programmation, lisez le tutoriel Activer les audiences vers des destinations basées sur des fichiers à l’aide de l’API Flow Service.
Audiences prises en charge supported-audiences
Cette section décrit les types d’audiences que vous pouvez exporter vers cette destination.
Type et fréquence d’exportation export-type-frequency
Reportez-vous au tableau ci-dessous pour plus d’informations sur le type et la fréquence d’exportation des destinations.
Exporter des jeux de données export-datasets
Cette destination prend en charge les exportations de jeux de données. Pour obtenir des informations complètes sur la configuration des exportations de jeux de données, consultez les tutoriels :
Format de fichier des données exportées file-format
Lors de l’exportation de données d’audience, Platform crée un fichier .csv, parquet ou .json dans l’emplacement de stockage que vous avez fourni. Pour plus d’informations sur les fichiers, consultez la section Formats de fichiers pris en charge pour l’exportation du tutoriel sur l’activation de l’audience.
Lors de l’exportation de jeux de données, Platform crée un fichier .parquet ou .json dans l’emplacement de stockage que vous avez fourni. Pour plus d’informations sur les fichiers, consultez la section Vérification de l’exportation des jeux de données réussie du tutoriel sur l’exportation des jeux de données.
Se connecter à la destination connect
Pour vous connecter à cette destination, procédez comme décrit dans le tutoriel sur la configuration des destinations. Dans le workflow de configuration des destinations, renseignez les champs répertoriés dans les deux sections ci-dessous.
S’authentifier auprès de la destination authenticate
Pour vous authentifier à la destination, renseignez les champs requis et sélectionnez Se connecter à la destination.
-
URL : le point d’entrée pour Azure Data Lake Storage Gen2. Le modèle de point d’entrée est le suivant :
abfss://<container>@<accountname>.dfs.core.windows.net. -
Client : les informations du client qui contiennent votre application.
-
Identifiant principal du service : identifiant client de l’application.
-
Clé principale du service : clé de l’application.
-
Clé de chiffrement : vous pouvez éventuellement joindre votre clé publique au format RSA pour ajouter un chiffrement à vos fichiers exportés. Vous pouvez voir un exemple de clé correctement formatée dans l’image ci-dessous.
Renseigner les détails de la destination destination-details
Pour configurer les détails de la destination, renseignez les champs obligatoires et facultatifs ci-dessous. Un astérisque situé en regard d’un champ de l’interface utilisateur indique que le champ est obligatoire.
-
Nom : renseignez le nom de votre choix pour cette destination.
-
Description : facultatif. Vous pouvez, par exemple, mentionner la campagne pour laquelle vous utilisez cette destination.
-
Chemin d’accès au dossier : saisissez le chemin d’accès au dossier de destination qui héberge les fichiers exportés.
-
Type de fichier : sélectionnez le format que l’Experience Platform doit utiliser pour les fichiers exportés. Lorsque vous sélectionnez l’option CSV , vous pouvez également configurer les options de formatage de fichier.
-
Format de compression : sélectionnez le type de compression que l’Experience Platform doit utiliser pour les fichiers exportés.
-
Inclure le fichier manifeste : activez cette option si vous souhaitez que les exportations incluent un fichier JSON manifeste contenant des informations sur l’emplacement d’exportation, la taille de l’exportation, etc. Le manifeste est nommé au format
manifest-<<destinationId>>-<<dataflowRunId>>.json. Affichez un exemple de fichier manifeste. Le fichier de manifeste comprend les champs suivants :flowRunId: exécution de flux de données qui a généré le fichier exporté.scheduledTime: heure en UTC à laquelle le fichier a été exporté.exportResults.sinkPath: chemin d’accès dans l’emplacement de stockage où le fichier exporté est déposé.exportResults.name: nom du fichier exporté.size: taille du fichier exporté, en octets.
Activer les alertes enable-alerts
Vous pouvez activer les alertes pour recevoir des notifications sur le statut de votre flux de données vers votre destination. Sélectionnez une alerte dans la liste et abonnez-vous à des notifications concernant le statut de votre flux de données. Pour plus d’informations sur les alertes, consultez le guide sur l’abonnement aux alertes des destinations dans l’interface utilisateur.
Lorsque vous avez terminé de renseigner les détails sur votre connexion de destination, sélectionnez Suivant.
Activer des audiences vers cette destination activate
- Pour activer les données, vous avez besoin des , Activer les destinations, et autorisations de contrôle d’accès. Lisez la présentation du contrôle d’accès ou contactez votre administrateur ou administratrice du produit pour obtenir les autorisations requises.
- Pour exporter des identités, vous avez besoin de l'autorisation Afficher le graphique d'identités 🔗.
Voir Activation des données d’audience vers des destinations d’exportation de profil de lot pour obtenir des instructions sur l’activation des audiences vers cette destination.
Planification scheduling
Dans l’étape Planifier, vous pouvez configurer le planning d’exportation pour votre destination Azure Data Lake Storage Gen2 et vous pouvez également configurer le nom de vos fichiers exportés.
Mapper les attributs et les identités map
Dans l’étape Mappage, vous pouvez sélectionner les champs d’attribut et d’identité à exporter pour vos profils. Vous pouvez également choisir de remplacer les en-têtes du fichier exporté par un nom convivial de votre choix. Pour plus d’informations, voir l’étape de mappage dans le tutoriel Activer l’interface utilisateur des destinations par lot.
Valider l’exportation des données avec succès exported-data
Pour vérifier si l’exportation des données a réussi, vérifiez le stockage Azure Data Lake Storage Gen2 et assurez-vous que les fichiers exportés contiennent les populations de profils attendues.