在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"
]
上一頁刪除物件
下一頁建立批次

Experience Platform