DocumentazioneExperience PlatformGuida al catalogo e ai set di dati

Creare un set di dati nell’API

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Sviluppatore

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. Dopo aver ottenuto l'ID dello schema, puoi 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
c5c02be6-79a3-4a2f-b766-136bffe8b676