在API中创建数据集

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

主题：

创建对象：

undefined

要使用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 （已创建）和一个响应对象，该响应对象由包含新创建的数据集的ID的数组组成，格式为"@/datasets/{DATASET_ID}"。数据集ID是系统生成的只读字符串，用于在API调用中引用数据集。

[
    "@/dataSets/5c8c3c555033b814b69f947f"
]

recommendation-more-help

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