DocumentazioneExperience PlatformGuida al catalogo e ai set di dati

Creare un set di dati nell’API

Ultimo aggiornamento: 24 maggio 2026

Creato per:

  • {"id":"ff6a42d2-313e-452e-93a6-792e4fad9ff8"}

Per creare un set di dati utilizzando l’API Catalog, è necessario conoscere il valore $id dello schema Experience Data Model (XDM) su cui sarà basato il set di dati. Una volta ottenuto l’ID dello schema, è possibile creare un set di dati effettuando una richiesta POST all’endpoint /datasets nell’API Catalog.

NOTE
In questo documento viene descritto solo come creare un oggetto set di dati in Catalog. Per i passaggi completi su come creare, popolare e monitorare un set di dati, consulta la seguente esercitazione.

Formato API

POST /dataSets

Richiesta

La richiesta seguente crea un set di dati che fa riferimento a uno schema definito in precedenza.

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"
    }
}'
Proprietà
Descrizione
name
Nome del set di dati da creare.
schemaRef.id
Il valore URI $id per lo schema XDM su cui sarà basato il set di dati.
schemaRef.contentType
Indica il formato e la versione dello schema. Per ulteriori informazioni, consulta la sezione sul controllo delle versioni dello schema 1} nella guida dell’API XDM.
NOTE
In questo esempio viene utilizzato il formato di file Apache Parquet per la proprietà containerFormat. Un esempio che utilizza il formato di file JSON è disponibile nella guida per gli sviluppatori sull'acquisizione batch.

Risposta

In caso di esito positivo, la risposta restituisce lo stato HTTP 201 (Creato) e un oggetto di risposta costituito da un array contenente l’ID del set di dati appena creato in formato "@/datasets/{DATASET_ID}". L’ID del set di dati è una stringa di sola lettura generata dal sistema e utilizzata per fare riferimento al set di dati nelle chiamate API.

[
    "@/dataSets/5c8c3c555033b814b69f947f"
]
recommendation-more-help
experience-platform-help-catalog