Cette fonctionnalité est disponible pour les clients qui ont acheté le package Real-Time CDP Prime et Ultimate, Adobe Journey Optimizer ou Customer Journey Analytics. Pour plus d’informations, contactez votre représentant d’Adobe.
Cet article explique le workflow requis pour utiliser la variable Flow Service API pour exporter jeux de données de Adobe Experience Platform à l’emplacement de stockage de votre choix dans le cloud, par exemple Amazon S3, emplacements SFTP ou Google Cloud Storage.
Jeux de données disponibles pour l’exportation datasets-to-export
Les jeux de données que vous pouvez exporter dépendent de l’application Experience Platform (Real-Time CDP, Adobe Journey Optimizer), du niveau (Prime ou Ultimate) et des modules complémentaires que vous avez achetés (par exemple : Data Distiller).
Destinations prises en charge supported-destinations
Actuellement, vous pouvez exporter des jeux de données vers les destinations de stockage dans le cloud mises en évidence dans la capture d’écran et répertoriées ci-dessous.
Ce guide nécessite une compréhension professionnelle des composants suivants d’Adobe Experience Platform :
Experience Platform datasets: toutes les données correctement ingérées dans Adobe Experience Platform sont conservées dans la variable Data Lake comme des jeux de données. Un jeu de données est une structure de stockage et de gestion pour la collecte de données, généralement sous la forme d’un tableau, qui contient un schéma (des colonnes) et des champs (des lignes). Les jeux de données contiennent également des métadonnées qui décrivent divers aspects des données stockées.
Sandboxes : 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.
Les sections suivantes apportent des informations supplémentaires que vous devez connaître pour exporter des jeux de données vers des destinations de stockage dans le cloud dans Platform.
Autorisations nécessaires permissions
Pour exporter des jeux de données, vous avez besoin de l’événement Affichage des destinations, Affichage des jeux de données, et Gestion et activation des destinations de jeu de donnéesautorisations de contrôle d’accès. Lisez la présentation du contrôle d’accès ou contactez votre administrateur de produit pour obtenir les autorisations requises.
Pour vous assurer que vous disposez des autorisations nécessaires pour exporter des jeux de données et que la destination prend en charge l’exportation de jeux de données, parcourez le catalogue des destinations. Si une destination comporte un contrôle Activer ou Exporter des jeux de données, vous disposez des autorisations appropriées.
Lecture d’exemples d’appels API reading-sample-api-calls
Ce tutoriel fournit des exemples d’appels API pour démontrer comment formater vos requêtes. Il s’agit notamment de chemins d’accès, d’en-têtes requis et de payloads de requêtes correctement formatés. L’exemple JSON renvoyé dans les réponses de l’API est également fourni. Pour plus d’informations sur les conventions utilisées dans la documentation pour les exemples d’appels d’API, voir la section concernant la lecture d’exemples d’appels d’API dans le guide de dépannage Experience Platform.
Collecter des valeurs pour les en-têtes obligatoires et facultatifs gather-values-headers
Pour lancer des appels à Platform API, vous devez d’abord renseigner la variable Tutoriel sur l’authentification des Experience Platform. Le tutoriel d’authentification fournit les valeurs de chacun des en-têtes requis dans tous les appels d’API Experience Platform, comme indiqué ci-dessous :
Authorization: Bearer {ACCESS_TOKEN}
x-api-key : {API_KEY}
x-gw-ims-org-id : {ORG_ID}
Les ressources dans Experience Platform peuvent être isolées dans des sandbox spécifiques. Dans les requêtes aux API Platform, vous pouvez spécifier le nom et l’identifiant du sandbox dans lequel l’opération aura lieu. Il s’agit de paramètres facultatifs.
Pour obtenir une description des termes que vous rencontrerez dans ce tutoriel sur l’API, consultez la rubrique section glossaire de la documentation de référence de l’API.
Rassemblez les spécifications de connexion et les spécifications de flux pour la destination souhaitée. gather-connection-spec-flow-spec
Avant de démarrer le workflow pour exporter un jeu de données, identifiez les identifiants de spécification de connexion et de flux de la destination vers laquelle vous envisagez d’exporter des jeux de données. Utilisez le tableau ci-dessous à titre de référence.
Destination
Spécification de connexion
Spécification de flux
Amazon S3
4fce964d-3f37-408f-9778-e597338a21ee
269ba276-16fc-47db-92b0-c1049a3c131f
Azure Blob Storage
6d6b59bf-fb58-4107-9064-4d246c0e5bb2
95bd8965-fc8a-4119-b9c3-944c2c2df6d2
Azure Data Lake Gen 2(ADLS Gen2)
be2c3209-53bc-47e7-ab25-145db8b873e1
17be2013-2549-41ce-96e7-a70363bec293
Data Landing Zone(DLZ)
10440537-2a7b-4583-ac39-ed38d4b848e8
cd2fc47e-e838-4f38-a581-8fff2f99b63a
Google Cloud Storage
c5d93acb-ea8b-4b14-8f53-02138444ae99
585c15c4-6cbf-4126-8f87-e26bff78b657
SFTP
36965a81-b1c6-401b-99f8-22508f1e6a26
354d6aad-4754-46e4-a576-1b384561c440
Vous avez besoin de ces identifiants pour construire diverses Flow Service entités. Vous devez également vous référer à des parties de la variable Connection Spec pour configurer certaines entités afin que vous puissiez récupérer la variable Connection Spec de Flow Service APIs. Consultez les exemples ci-dessous de récupération des spécifications de connexion pour toutes les destinations dans le tableau :
Suivez les étapes ci-dessous pour configurer un flux de données de jeu de données vers une destination de stockage dans le cloud. Pour certaines étapes, les requêtes et les réponses diffèrent entre les différentes destinations de stockage dans le cloud. Dans ces cas, utilisez les onglets de la page pour récupérer les requêtes et réponses spécifiques à la destination à laquelle vous souhaitez vous connecter et exporter des jeux de données. Veillez à utiliser la variable connection spec et flow spec pour la destination que vous configurez.
Récupération d’une liste de jeux de données retrieve-list-of-available-datasets
Pour récupérer une liste de jeux de données éligibles à l’activation, commencez par effectuer un appel API vers le point de terminaison ci-dessous.
recommendation-more-help
Requête
Récupération des jeux de données éligibles - Requête
Notez que pour récupérer les jeux de données éligibles, la variable connection spec L’identifiant utilisé dans l’URL de requête doit correspondre à l’identifiant de spécification de la connexion au lac de données, 23598e46-f560-407b-88d5-ea6207e49db0, et les deux paramètres de requête outputField=datasets et outputType=activationDatasets doit être spécifié. Tous les autres paramètres de requête sont des paramètres standard pris en charge par la variable API Catalog Service.
Une réponse réussie contient une liste de jeux de données éligibles à l’activation. Ces jeux de données peuvent être utilisés lors de la création de la connexion source à l’étape suivante.
Créer une connexion source create-source-connection
Après avoir récupéré la liste des jeux de données à exporter, vous pouvez créer une connexion source à l’aide de ces identifiants de jeu de données.
Requête
Créer une connexion source - Requête
Notez les lignes surlignées avec des commentaires intégrés dans l’exemple de requête, qui fournissent des informations supplémentaires. Supprimez les commentaires insérés dans la requête lorsque vous copiez-collez la requête dans votre terminal de votre choix.
Une réponse réussie renvoie l’identifiant (id) de la nouvelle connexion source et un etag. Notez l’identifiant de connexion source, car vous en aurez besoin ultérieurement lors de la création du flux de données.
N’oubliez pas que :
La connexion source créée au cours de cette étape doit être liée à un flux de données pour que ses jeux de données soient activés vers une destination. Voir création d’un flux de données pour plus d’informations sur la liaison d’une connexion source à un flux de données.
Les identifiants de jeu de données d’une connexion source ne peuvent pas être modifiés après la création. Si vous devez ajouter ou supprimer des jeux de données d’une connexion source, vous devez créer une nouvelle connexion source et lier l’identifiant de la nouvelle connexion source au flux de données.
Création d’une connexion de base (cible) create-base-connection
Une connexion de base stocke en toute sécurité les informations d’identification vers votre destination. Selon le type de destination, les informations d’identification nécessaires pour s’authentifier sur cette destination peuvent varier. Pour rechercher ces paramètres d’authentification, récupérez d’abord la variable connection spec pour la destination souhaitée, comme décrit dans la section Collecte des spécifications de connexion et des spécifications de flux et puis regardez le authSpec de la réponse. Référencez les onglets ci-dessous pour le authSpec propriétés de toutes les destinations prises en charge.
Amazon S3
accordion
Amazon S3 - Connection spec affichage auth spec
Notez la ligne mise en surbrillance avec les commentaires insérés dans la connection spec l’exemple ci-dessous, qui fournit des informations supplémentaires sur l’emplacement des paramètres d’authentification dans la variable connection spec.
Notez la ligne mise en surbrillance avec les commentaires insérés dans la connection spec l’exemple ci-dessous, qui fournit des informations supplémentaires sur l’emplacement des paramètres d’authentification dans la variable connection spec.
Azure Data Lake Gen 2(ADLS Gen2) - Connection spec affichage auth spec
Notez la ligne mise en surbrillance avec les commentaires insérés dans la connection spec l’exemple ci-dessous, qui fournit des informations supplémentaires sur l’emplacement des paramètres d’authentification dans la variable connection spec.
Google Cloud Storage - Connection spec affichage auth spec
Notez la ligne mise en surbrillance avec les commentaires insérés dans la connection spec l’exemple ci-dessous, qui fournit des informations supplémentaires sur l’emplacement des paramètres d’authentification dans la variable connection spec.
{
"items": [
{
"id": "c5d93acb-ea8b-4b14-8f53-02138444ae99",
"name": "Google Cloud Storage",
"providerId": "14e34fac-d307-11e9-bb65-2a2ae2dbcce4",
"version": "1.0",
"authSpec": [ // describes the authentication parameters
{
"name": "Google Cloud Storage authentication credentials",
"type": "GoogleCloudStorageAuth",
"spec": {
"$schema": "http://json-schema.org/draft-07/schema#",
"description": "defines auth params required for connecting to google cloud storage connector.",
"type": "object",
"properties": {
"accessKeyId": {
"description": "Access Key Id for the user account",
"type": "string"
},
"secretAccessKey": {
"description": "Secret Access Key for the user account",
"type": "string",
"format": "password"
}
},
"required": [
"accessKeyId",
"secretAccessKey"
]
}
}
],
//...
SFTP
accordion
SFTP - Connection spec affichage auth spec
note note
NOTE
La destination SFTP contient deux éléments distincts dans la variable auth spec, car il prend en charge l’authentification par mot de passe et clé SSH.
Notez la ligne mise en surbrillance avec les commentaires insérés dans la connection spec l’exemple ci-dessous, qui fournit des informations supplémentaires sur l’emplacement des paramètres d’authentification dans la variable connection spec.
En utilisant les propriétés spécifiées dans la spécification d’authentification (c.-à-d. authSpec à partir de la réponse) vous pouvez créer une connexion de base avec les informations d’identification requises, spécifiques à chaque type de destination, comme illustré dans les exemples ci-dessous :
Amazon S3
Requête
accordion
Amazon S3 - requête de connexion de base
note tip
TIP
Pour plus d’informations sur la manière d’obtenir les informations d’authentification requises, reportez-vous à la section s’authentifier à la destination de la page de documentation sur la destination Amazon S3.
Notez les lignes surlignées avec des commentaires intégrés dans l’exemple de requête, qui fournissent des informations supplémentaires. Supprimez les commentaires insérés dans la requête lorsque vous copiez-collez la requête dans votre terminal de votre choix.
Pour plus d’informations sur la manière d’obtenir les informations d’authentification requises, reportez-vous à la section s’authentifier à la destination section de la page de documentation de destination du stockage Blob de Microsoft Azure.
Notez les lignes surlignées avec des commentaires intégrés dans l’exemple de requête, qui fournissent des informations supplémentaires. Supprimez les commentaires insérés dans la requête lorsque vous copiez-collez la requête dans votre terminal de votre choix.
Azure Data Lake Gen 2(ADLS Gen2) - requête de connexion de base
note tip
TIP
Pour plus d’informations sur la manière d’obtenir les informations d’authentification requises, reportez-vous à la section s’authentifier à la destination section de la page de documentation de destination Azure Data Lake Gen 2 (ADLS Gen2).
Notez les lignes surlignées avec des commentaires intégrés dans l’exemple de requête, qui fournissent des informations supplémentaires. Supprimez les commentaires insérés dans la requête lorsque vous copiez-collez la requête dans votre terminal de votre choix.
Data Landing Zone(DLZ) - requête de connexion de base
note tip
TIP
Aucune information d’identification d’authentification n’est requise pour la destination de la zone d’entrée des données. Pour plus d’informations, voir la section s’authentifier à la destination de la page de documentation sur la destination des zones d’entrée de données.
Google Cloud Storage - requête de connexion de base
note tip
TIP
Pour plus d’informations sur la manière d’obtenir les informations d’authentification requises, reportez-vous à la section s’authentifier à la destination de la page de documentation sur la destination de stockage dans le cloud de Google.
Notez les lignes surlignées avec des commentaires intégrés dans l’exemple de requête, qui fournissent des informations supplémentaires. Supprimez les commentaires insérés dans la requête lorsque vous copiez-collez la requête dans votre terminal de votre choix.
SFTP avec mot de passe - Demande de connexion de base
note tip
TIP
Pour plus d’informations sur la manière d’obtenir les informations d’authentification requises, reportez-vous à la section s’authentifier à la destination de la page de documentation sur la destination SFTP.
Notez les lignes surlignées avec des commentaires intégrés dans l’exemple de requête, qui fournissent des informations supplémentaires. Supprimez les commentaires insérés dans la requête lorsque vous copiez-collez la requête dans votre terminal de votre choix.
Pour plus d’informations sur la manière d’obtenir les informations d’authentification requises, reportez-vous à la section s’authentifier à la destination de la page de documentation sur la destination SFTP.
Notez les lignes surlignées avec des commentaires intégrés dans l’exemple de requête, qui fournissent des informations supplémentaires. Supprimez les commentaires insérés dans la requête lorsque vous copiez-collez la requête dans votre terminal de votre choix.
Notez l’identifiant de connexion de la réponse. Cet identifiant sera requis à l’étape suivante lors de la création de la connexion cible.
Créer une connexion cible create-target-connection
Ensuite, vous devez créer une connexion cible qui stocke les paramètres d’exportation de vos jeux de données. Les paramètres d’exportation incluent l’emplacement, le format de fichier, la compression et d’autres détails. Voir targetSpec propriétés fournies dans la spécification de connexion de la destination pour comprendre les propriétés prises en charge pour chaque type de destination. Référencez les onglets ci-dessous pour le targetSpec propriétés de toutes les destinations prises en charge.
WARNING
Les exportations vers les fichiers JSON sont prises en charge en mode compressé uniquement. Exportations vers Parquet Les fichiers sont pris en charge en mode compressé et décompressé.
Amazon S3
accordion
Amazon S3 - Connection spec affichage des paramètres de connexion cible
Notez les lignes surlignées avec des commentaires intégrés dans la variable connection spec exemple ci-dessous, qui fournit des informations supplémentaires sur l’emplacement de la variable target spec dans la spécification de connexion. Vous pouvez également voir dans l’exemple ci-dessous les paramètres de cible not applicable aux destinations d’exportation de jeux de données.
Azure Blob Storage - Connection spec affichage des paramètres de connexion cible
Notez les lignes surlignées avec des commentaires intégrés dans la variable connection spec exemple ci-dessous, qui fournit des informations supplémentaires sur l’emplacement de la variable target spec dans la spécification de connexion. Vous pouvez également voir dans l’exemple ci-dessous les paramètres de cible not applicable aux destinations d’exportation de jeux de données.
Azure Data Lake Gen 2(ADLS Gen2) - Connection spec affichage des paramètres de connexion cible
Notez les lignes surlignées avec des commentaires intégrés dans la variable connection spec exemple ci-dessous, qui fournit des informations supplémentaires sur l’emplacement de la variable target spec dans la spécification de connexion. Vous pouvez également voir dans l’exemple ci-dessous les paramètres de cible not applicable aux destinations d’exportation de jeux de données.
{
"items": [
{
"id": "be2c3209-53bc-47e7-ab25-145db8b873e1",
"name": "Azure Data Lake Gen2",
"providerId": "14e34fac-d307-11e9-bb65-2a2ae2dbcce4",
"version": "1.0",
"authSpec": [...],
"encryptionSpecs": [...],
"targetSpec": { // describes the target connection parameters
"name": "User based target",
"type": "UserNamespace",
"spec": {
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {
"path": {
"title": "Folder path",
"description": "Enter the path to your Azure Data Lake Storage folder",
"type": "string"
},
"fileType": {...}, // not applicable to dataset destinations
"datasetFileType": {
"conditional": {
"field": "flowSpec.attributes._workflow",
"operator": "CONTAINS",
"value": "DATASETS"
},
"title": "File Type",
"description": "Select file format",
"type": "string",
"enum": [
"JSON",
"PARQUET"
]
},
"csvOptions":{...}, // not applicable to dataset destinations
"compression": {
"title": "Compression format",
"description": "Select the desired file compression format.",
"type": "string",
"enum": [
"NONE",
"GZIP"
]
}
},
"required": [
"path",
"datasetFileType",
"compression",
"fileType"
]
}
//...
Zone d’entrée des données (DLZ)
accordion
Data Landing Zone(DLZ) - Connection spec affichage des paramètres de connexion cible
Notez les lignes surlignées avec des commentaires intégrés dans la variable connection spec exemple ci-dessous, qui fournit des informations supplémentaires sur l’emplacement de la variable target spec dans la spécification de connexion. Vous pouvez également voir dans l’exemple ci-dessous les paramètres de cible not applicable aux destinations d’exportation de jeux de données.
Google Cloud Storage - Connection spec affichage des paramètres de connexion cible
Notez les lignes surlignées avec des commentaires intégrés dans la variable connection spec exemple ci-dessous, qui fournit des informations supplémentaires sur l’emplacement de la variable target spec dans la spécification de connexion. Vous pouvez également voir dans l’exemple ci-dessous les paramètres de cible not applicable aux destinations d’exportation de jeux de données.
SFTP - Connection spec affichage des paramètres de connexion cible
Notez les lignes surlignées avec des commentaires intégrés dans la variable connection spec exemple ci-dessous, qui fournit des informations supplémentaires sur l’emplacement de la variable target spec dans la spécification de connexion. Vous pouvez également voir dans l’exemple ci-dessous les paramètres de cible not applicable aux destinations d’exportation de jeux de données.
En utilisant la spécification ci-dessus, vous pouvez créer une requête de connexion cible spécifique à la destination de stockage dans le cloud souhaitée, comme indiqué dans les onglets ci-dessous.
Amazon S3
Requête
accordion
Amazon S3 - Demande de connexion Target
note tip
TIP
Pour plus d’informations sur l’obtention des paramètres de ciblage requis, reportez-vous à la section remplir les détails de destination de la Amazon S3 page de documentation de destination. Pour les autres valeurs prises en charge par datasetFileType, consultez la documentation de référence sur les API .
Notez les lignes surlignées avec des commentaires intégrés dans l’exemple de requête, qui fournissent des informations supplémentaires. Supprimez les commentaires insérés dans la requête lorsque vous copiez-collez la requête dans votre terminal de votre choix.
Pour plus d’informations sur l’obtention des paramètres de ciblage requis, reportez-vous à la section remplir les détails de destination de la Azure Blob Storage page de documentation de destination. Pour les autres valeurs prises en charge par datasetFileType, consultez la documentation de référence sur les API .
Notez les lignes surlignées avec des commentaires intégrés dans l’exemple de requête, qui fournissent des informations supplémentaires. Supprimez les commentaires insérés dans la requête lorsque vous copiez-collez la requête dans votre terminal de votre choix.
Pour plus d’informations sur l’obtention des paramètres de ciblage requis, reportez-vous à la section remplir les détails de destination section d’Azure Data Lake Gen 2(ADLS Gen2) page de documentation de destination. Pour les autres valeurs prises en charge par datasetFileType, consultez la documentation de référence sur les API .
Notez les lignes surlignées avec des commentaires intégrés dans l’exemple de requête, qui fournissent des informations supplémentaires. Supprimez les commentaires insérés dans la requête lorsque vous copiez-collez la requête dans votre terminal de votre choix.
Pour plus d’informations sur l’obtention des paramètres de ciblage requis, reportez-vous à la section remplir les détails de destination de la Data Landing Zone page de documentation de destination. Pour les autres valeurs prises en charge par datasetFileType, consultez la documentation de référence sur les API .
Notez les lignes surlignées avec des commentaires intégrés dans l’exemple de requête, qui fournissent des informations supplémentaires. Supprimez les commentaires insérés dans la requête lorsque vous copiez-collez la requête dans votre terminal de votre choix.
Google Cloud Storage - Demande de connexion Target
note tip
TIP
Pour plus d’informations sur l’obtention des paramètres de ciblage requis, reportez-vous à la section remplir les détails de destination de la Google Cloud Storage page de documentation de destination. Pour les autres valeurs prises en charge par datasetFileType, consultez la documentation de référence sur les API .
Notez les lignes surlignées avec des commentaires intégrés dans l’exemple de requête, qui fournissent des informations supplémentaires. Supprimez les commentaires insérés dans la requête lorsque vous copiez-collez la requête dans votre terminal de votre choix.
Pour plus d’informations sur l’obtention des paramètres de ciblage requis, reportez-vous à la section remplir les détails de destination de la page de documentation sur la destination SFTP. Pour les autres valeurs prises en charge par datasetFileType, consultez la documentation de référence sur les API .
Notez les lignes surlignées avec des commentaires intégrés dans l’exemple de requête, qui fournissent des informations supplémentaires. Supprimez les commentaires insérés dans la requête lorsque vous copiez-collez la requête dans votre terminal de votre choix.
Notez l’identifiant de connexion Target de la réponse. Cet identifiant sera requis à l’étape suivante lors de la création du flux de données pour exporter des jeux de données.
Créer un flux de données create-dataflow
La dernière étape de la configuration de destination consiste à configurer un flux de données. Un flux de données relie des entités créées précédemment et fournit également des options pour configurer le planning d’exportation du jeu de données. Pour créer le flux de données, utilisez les payloads ci-dessous, en fonction de la destination de stockage dans le cloud souhaitée, et remplacez les identifiants d’entité des étapes précédentes.
Amazon S3
Requête
accordion
Créez un flux de données de jeu de données sur Amazon S3 destination - Requête
Notez les lignes surlignées avec des commentaires intégrés dans l’exemple de requête, qui fournissent des informations supplémentaires. Supprimez les commentaires insérés dans la requête lorsque vous copiez-collez la requête dans votre terminal de votre choix.
Créez un flux de données de jeu de données sur Azure Blob Storage destination - Requête
Notez les lignes surlignées avec des commentaires intégrés dans l’exemple de requête, qui fournissent des informations supplémentaires. Supprimez les commentaires insérés dans la requête lorsque vous copiez-collez la requête dans votre terminal de votre choix.
Créez un flux de données de jeu de données sur Azure Data Lake Gen 2(ADLS Gen2) destination - Requête
Notez les lignes surlignées avec des commentaires intégrés dans l’exemple de requête, qui fournissent des informations supplémentaires. Supprimez les commentaires insérés dans la requête lorsque vous copiez-collez la requête dans votre terminal de votre choix.
Créez un flux de données de jeu de données sur Data Landing Zone destination - Requête
Notez les lignes surlignées avec des commentaires intégrés dans l’exemple de requête, qui fournissent des informations supplémentaires. Supprimez les commentaires insérés dans la requête lorsque vous copiez-collez la requête dans votre terminal de votre choix.
Créez un flux de données de jeu de données sur Google Cloud Storage destination - Requête
Notez les lignes surlignées avec des commentaires intégrés dans l’exemple de requête, qui fournissent des informations supplémentaires. Supprimez les commentaires insérés dans la requête lorsque vous copiez-collez la requête dans votre terminal de votre choix.
Créer un flux de données de jeu de données vers la destination SFTP - Requête
Notez les lignes surlignées avec des commentaires intégrés dans l’exemple de requête, qui fournissent des informations supplémentaires. Supprimez les commentaires insérés dans la requête lorsque vous copiez-collez la requête dans votre terminal de votre choix.
Notez l’identifiant du flux de données de la réponse. Cet identifiant sera requis à l’étape suivante lors de la récupération des exécutions du flux de données pour valider les exportations réussies du jeu de données.
Obtention des exécutions de flux de données get-dataflow-runs
Pour vérifier les exécutions d’un flux de données, utilisez l’API des exécutions de flux de données :
Requête
Obtenir les exécutions de flux de données - Requête
Dans la requête de récupération des exécutions de flux de données, ajoutez en tant que paramètre de requête l’identifiant de flux de données obtenu à l’étape précédente, lors de la création du flux de données.
Vérifier l’exportation réussie d’un jeu de données verify
Lors de l’exportation de jeux de données, Experience Platform crée un fichier .json ou .parquet dans l’emplacement de stockage que vous avez fourni. Attendez-vous à ce qu’un nouveau fichier soit déposé dans votre emplacement de stockage en fonction du planning d’exportation que vous avez fourni lors de la création d’un flux de données.
Experience Platform crée une structure de dossiers dans l’emplacement de stockage que vous avez spécifié, où il dépose les fichiers de jeu de données exportés. Un nouveau dossier est créé pour chaque heure d’exportation, selon le modèle ci-dessous :
Le nom de fichier par défaut est généré de manière aléatoire pour garantir que les noms de fichier exportés soient uniques.
Exemples de fichiers de jeu de données sample-files
La présence de ces fichiers dans votre emplacement de stockage confirme que l’activation a été réalisée avec succès. Pour comprendre la structure des fichiers exportés, vous pouvez télécharger un exemple de fichier parquet ou de fichier JSON.
Fichiers de jeux de données compressés compressed-dataset-files
À l’étape créer une connexion cible ;, vous pouvez sélectionner les fichiers de jeu de données exportés à compresser.
Notez la différence de format de fichier entre les deux types de fichiers, lorsqu’ils sont compressés :
Lors de l’exportation de fichiers JSON compressés, le format de fichier exporté est json.gz
Lors de l’exportation de fichiers parquet compressés, le format de fichier exporté est gz.parquet
Gestion des erreurs d’API api-error-handling
Les points de terminaison d’API de ce tutoriel suivent les principes généraux des messages d’erreur de l’API d’Experience Platform. Voir Codes d’état d’API et erreurs d’en-tête de requête dans le guide de dépannage de Platform pour plus d’informations sur l’interprétation des réponses d’erreur.
Étapes suivantes next-steps
En suivant ce tutoriel, vous avez réussi à connecter Platform à l’une de vos destinations de stockage dans le cloud par lots préférées et à configurer un flux de données vers la destination correspondante pour exporter les jeux de données. Consultez les pages suivantes pour plus d’informations, telles que la modification des flux de données existants à l’aide de l’API Flow Service :