在API中创建数据集

为了使用创建数据集 Catalog API,您必须了解 $id 的值 Experience Data Model 数据集将基于的(XDM)架构。 POST获得架构ID后,您可以通过向 /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状态201(已创建)和一个响应对象,该响应对象由一个数组组成,数组包含采用格式的新创建数据集的ID "@/datasets/{DATASET_ID}". 数据集ID是系统生成的只读字符串,用于在API调用中引用数据集。

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