在API中建立資料集

最後更新： 2024年7月16日

主題：
目錄

建立對象：

開發人員

若要使用Catalog API建立資料集，您必須知道資料集將依據的Experience Data Model (XDM)結構描述的$id值。一旦您擁有結構描述ID，您就可以對Catalog API中的/datasets端點發出POST要求來建立資料集。

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

資料集將依據的XDM結構描述的URI $id值。

schemaRef.contentType

表示結構描述的格式和版本。如需詳細資訊，請參閱XDM API指南中架構版本設定的相關章節。

NOTE

此範例將Apache Parquet檔案格式用於其containerFormat屬性。您可以在批次擷取開發人員指南中找到使用JSON檔案格式的範例。

回應

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

[
    "@/dataSets/5c8c3c555033b814b69f947f"
]

recommendation-more-help