Creare un set di dati nell’API

Per creare un set di dati utilizzando Catalog API, devi conoscere $id del valore Experience Data Model Schema (XDM) su cui verrà basato il set di dati. Una volta ottenuto l’ID schema, puoi creare un set di dati effettuando una richiesta di POST al gruppo /datasets punto finale Catalog API.

NOTA

Questo documento illustra solo come creare un oggetto set di dati in Catalog. Per i passaggi completi su come creare, compilare e monitorare un set di dati, consulta quanto segue tutorial.

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 URI $id valore per lo schema XDM su cui verrà basato il set di dati.
schemaRef.contentType Indica il formato e la versione dello schema. Vedi la sezione su versione dello schema nella guida API XDM per ulteriori informazioni.
NOTA

In questo esempio viene utilizzato Parquet Apache formato di file containerFormat proprietà. Un esempio che utilizza il formato di file JSON si trova nella guida per gli sviluppatori di batch ingestion.

Risposta

Una risposta corretta restituisce lo stato HTTP 201 (Creato) e un oggetto di risposta 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"
]

In questa pagina