Show Menu
ARGOMENTI×

Creare un dataset

Per creare un dataset utilizzando l'API Catalog, è necessario conoscere il $id valore dello schema Experience Data Model (XDM) su cui si baserà il dataset. Una volta ottenuto l’ID dello schema, potete creare un dataset effettuando una richiesta POST all’ /datasets endpoint nell’API Catalog.
Questo documento descrive solo come creare un oggetto dataset in Catalog. Per i passaggi completi su come creare, compilare e monitorare un dataset, fare riferimento alla seguente esercitazione .
Formato API
POST /dataSets

Richiesta
La richiesta seguente crea un dataset 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: {IMS_ORG}' \
  -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"
    },
    "fileDescription": {
        "persisted": true,
        "containerFormat": "parquet",
        "format": "parquet"
    }
}'

Proprietà
Descrizione
name
Nome del set di dati da creare.
schemaRef.id
Il $id valore URI per lo schema XDM su cui verrà basato il dataset.
In questo esempio viene utilizzato il formato di file parquet per la relativa containerFormat proprietà. Un esempio che utilizza il formato di file JSON è disponibile nella guida per gli sviluppatori per l’assimilazione batch.
Risposta
Una risposta corretta restituisce lo stato HTTP 201 (Creato) e un oggetto response costituito da un array contenente l'ID del set di dati appena creato nel formato "@/datasets/{DATASET_ID}" . L'ID del set di dati è una stringa di sola lettura generata dal sistema che viene utilizzata per fare riferimento al set di dati nelle chiamate API.
[
    "@/dataSets/5c8c3c555033b814b69f947f"
]