Creare un set di dati nell’API
Per creare un set di dati utilizzando l’API Catalog, è necessario conoscere il valore $id dello schema Experience Data Model (XDM) su cui verrà basato il set di dati. Una volta ottenuto l’ID schema, puoi creare un set di dati effettuando una richiesta POST all’endpoint /datasets nell’ API Catalog .
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, fai riferimento alla 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: {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"
}
}'
| Proprietà | Descrizione |
|---|---|
name |
Nome del set di dati da creare. |
schemaRef.id |
Il valore URI $id per lo schema XDM su cui verrà 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 nella guida API XDM . |
In questo esempio viene utilizzato il formato di file Apache Parquet per la relativa proprietà containerFormat. Un esempio che utilizza il formato di file JSON si trova nella guida per gli sviluppatori per l’acquisizione batch.
Risposta
Una risposta corretta restituisce lo stato HTTP 201 (Creato) e un oggetto di risposta costituito da una matrice 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
Riferimenti
Account Adobe
