Dokumentation Experience Platform Användarhandbok om kataloger och datauppsättningar

Skapa en datauppsättning i API:t

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

Ämnen:
Katalog

Skapat för:

Utvecklare

Om du vill skapa en datauppsättning med API:t Catalog måste du känna till $id-värdet för det Experience Data Model (XDM)-schema som datauppsättningen ska baseras på. När du har ett schema-ID kan du skapa en datauppsättning genom att göra en POST-förfrågan till /datasets-slutpunkten i Catalog API.

NOTE

Det här dokumentet beskriver bara hur du skapar ett datauppsättningsobjekt i Catalog. Fullständiga anvisningar om hur du skapar, fyller i och övervakar en datauppsättning finns i följande självstudiekurs.

API-format

POST /dataSets

Begäran

Följande begäran skapar en datauppsättning som refererar till ett tidigare definierat schema.

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"
    }
}'

Egenskap

Beskrivning

name

Namnet på datauppsättningen som ska skapas.

schemaRef.id

URI $id-värdet för XDM-schemat som datamängden baseras på.

schemaRef.contentType

Anger schemats format och version. Mer information finns i avsnittet schemaversion i XDM API-guiden.

NOTE

I det här exemplet används filformatet Apache Parquet för egenskapen containerFormat. Ett exempel som använder JSON-filformatet finns i Utvecklarhandboken för gruppfrågor.

Svar

Ett lyckat svar returnerar HTTP-status 201 (Skapad) och ett svarsobjekt som består av en array som innehåller ID:t för den nyskapade datauppsättningen i formatet "@/datasets/{DATASET_ID}". Datauppsättnings-ID är en skrivskyddad, systemgenererad sträng som används för att referera till datauppsättningen i API-anrop.

[
    "@/dataSets/5c8c3c555033b814b69f947f"
]

recommendation-more-help

c5c02be6-79a3-4a2f-b766-136bffe8b676