在API中建立資料集

為了使用建立資料集 Catalog API,您必須瞭解 $id 的值 Experience Data Model 資料集將依據的(XDM)結構描述。 擁有結構描述ID後,您可以透過向以下專案發出POST請求來建立資料集: /datasets 中的端點 Catalog API。

NOTE
本檔案僅說明如何在中建立資料集物件 Catalog. 如需建立、填入及監控資料集的完整步驟,請參閱以下內容 教學課程.

API格式

POST /dataSets

要求

以下請求會建立參考先前定義之結構描述的資料集。

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"
    }
}'
屬性
說明
name
要建立的資料集名稱。
schemaRef.id
URI $id 資料集將依據的XDM結構描述值。
schemaRef.contentType
表示結構描述的格式和版本。 請參閱以下小節: 結構描述版本設定 XDM API指南中取得更多資訊。
NOTE
此範例使用 Apache Parquet 檔案格式 containerFormat 屬性。 以下是使用JSON檔案格式的範例: 批次擷取開發人員指南.

回應

成功的回應會傳回HTTP Status 201 (已建立)和一個回應物件,該回應物件包含一個陣列,其中包含以格式建立的新資料集的ID "@/datasets/{DATASET_ID}". 資料集ID是系統產生的唯讀字串,用來參考API呼叫中的資料集。

[
    "@/dataSets/5c8c3c555033b814b69f947f"
]
recommendation-more-help
c5c02be6-79a3-4a2f-b766-136bffe8b676