Per creare un set di dati utilizzando Catalog API, è necessario conoscere $id
valore del Experience Data Model Schema (XDM) su cui verrà basato il set di dati. Una volta ottenuto l’ID dello schema, puoi creare un set di dati effettuando una richiesta POST al /datasets
endpoint nella Catalog API.
Questo documento illustra 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 i seguenti 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 |
URI $id valore per lo schema XDM su cui sarà basato il set di dati. |
schemaRef.contentType |
Indica il formato e la versione dello schema. Consulta la sezione su controllo delle versioni dello schema per ulteriori informazioni, consulta la guida dell’API XDM. |
In questo esempio viene utilizzato Apache Parquet formato file per i relativi containerFormat
proprietà. Un esempio che utilizza il formato di file JSON si trova in 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 nel 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"
]