DocumentationExperience PlatformGuide des catalogues et des jeux de données

Création d’un jeu de données dans l’API

Last update: Tue Jan 10 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Créé pour :

  • Developer

Pour créer un jeu de données à l’aide de la variable Catalog API, vous devez connaître la variable $id de la variable Experience Data Model Schéma (XDM) sur lequel le jeu de données sera basé. Une fois que vous disposez de l’identifiant de schéma, vous pouvez créer un jeu de données en envoyant une requête de POST à la variable /datasets du point de terminaison Catalog API.

NOTE
Ce document couvre uniquement la création d’un objet de jeu de données dans Catalog. Pour obtenir des instructions complètes sur la création, le remplissage et la surveillance d’un jeu de données, reportez-vous au tutoriel suivant.

Format d’API

POST /dataSets

Requête

La requête suivante crée un jeu de données se référant à un schéma précédemment défini.

curl -X POST \
  'https://platform.adobe.io/data/foundation/catalog/dataSets?requestDataSource=true' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -d '{
    "name":"LoyaltyMembersDataset",
    "schemaRef": {
        "id": "https://ns.adobe.com/{TENANT_ID}/schemas/719c4e19184402c27595e65b931a142b",
        "contentType": "application/vnd.adobe.xed+json;version=1"
    }
}'
Propriété
Description
name
Nom du jeu de données à créer.
schemaRef.id
La valeur $id de l’URI pour le schéma XDM sur lequel sera basé le jeu de données.
schemaRef.contentType
Indique le format et la version du schéma. Pour plus d’informations, reportez-vous à la section contrôle de version des schémas du guide de l’API XDM.
NOTE
Cet exemple utilise la méthode Apache Parquet format de fichier pour son containerFormat . Vous trouverez un exemple d’utilisation du format de fichier JSON dans le guide de développement de l’ingestion par lots.

Réponse

Une réponse réussie renvoie un état HTTP 201 (Créé) et un objet de réponse constitué d’un tableau contenant l’identifiant du jeu de données nouvellement créé au format "@/datasets/{DATASET_ID}". L’identifiant du jeu de données est une chaîne en lecture seule générée par le système et utilisée pour référencer le jeu de données dans les appels API.

[
    "@/dataSets/5c8c3c555033b814b69f947f"
]
recommendation-more-help
c5c02be6-79a3-4a2f-b766-136bffe8b676