DocumentaciónExperience PlatformGuía de catálogos y conjuntos de datos

Cree un conjunto de datos en la API

Last update: Mon Mar 13 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Creado para:

  • Developer

Para crear un conjunto de datos utilizando Catalog API, debe conocer el $id valor del Experience Data Model Esquema (XDM) en el que se basará el conjunto de datos. Una vez que tenga el ID de esquema, puede crear un conjunto de datos realizando una solicitud del POST al /datasets punto final en la Catalog API.

NOTE
Este documento solo explica cómo crear un objeto de conjunto de datos en Catalog. Para ver los pasos completos sobre cómo crear, rellenar y monitorizar un conjunto de datos, consulte lo siguiente tutorial.

Formato de API

POST /dataSets

Solicitud

La siguiente solicitud crea un conjunto de datos que hace referencia a un esquema definido anteriormente.

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"
    }
}'
Propiedad
Descripción
name
Nombre del conjunto de datos que se va a crear.
schemaRef.id
El URI $id valor para el esquema XDM en el que se basará el conjunto de datos.
schemaRef.contentType
Indica el formato y la versión del esquema. Consulte la sección sobre versiones de esquema en la Guía de API de XDM para obtener más información.
NOTE
Este ejemplo utiliza el Apache Parquet formato de archivo para su containerFormat propiedad. Un ejemplo que utiliza el formato de archivo JSON se encuentra en la guía para desarrolladores de ingesta por lotes.

Respuesta

Una respuesta correcta devuelve el estado HTTP 201 (Creado) y un objeto de respuesta que consta de una matriz que contiene el ID del conjunto de datos recién creado con el formato "@/datasets/{DATASET_ID}". El ID del conjunto de datos es una cadena generada por el sistema de solo lectura que se utiliza para hacer referencia al conjunto de datos en las llamadas a la API.

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