Documentación Experience Platform Guía de catálogos y conjuntos de datos

Cree un conjunto de datos en la API

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

Temas:
Catálogo

Creado para:

Desarrollador

Para crear un conjunto de datos utilizando la API Catalog, debe conocer el valor $id del esquema Experience Data Model (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 extremo /datasets en la API Catalog.

NOTE

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

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

Valor de URI $id 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 usa el formato de archivo Apache Parquet para su propiedad containerFormat. Encontrará un ejemplo que utiliza el formato de archivo JSON 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