Criar um conjunto de dados na API

Para criar um conjunto de dados usando a API Catalog, você deve saber o valor $id do schema Experience Data Model (XDM) no qual o conjunto de dados será baseado. Depois de ter a ID do esquema, é possível criar um conjunto de dados, fazendo uma solicitação de POST para o endpoint /datasets na API Catalog.

OBSERVAÇÃO

Este documento aborda apenas como criar um objeto de conjunto de dados em Catalog. Para obter as etapas completas sobre como criar, preencher e monitorar um conjunto de dados, consulte o seguinte tutorial.

Formato da API

POST /dataSets

Solicitação

A solicitação a seguir cria um conjunto de dados que faz referência a um 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: {IMS_ORG}' \
  -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"
    }
}'
Propriedade Descrição
name O nome do conjunto de dados a ser criado.
schemaRef.id O valor de URI $id para o esquema XDM no qual o conjunto de dados será baseado.
schemaRef.contentType Indica o formato e a versão do esquema. Consulte a seção sobre controle de versão do schema no guia da API XDM para obter mais informações.
OBSERVAÇÃO

Este exemplo usa o formato de arquivo Apache Parquet para sua propriedade containerFormat. Um exemplo que usa o formato de arquivo JSON pode ser encontrado no guia do desenvolvedor de assimilação em lote.

Resposta

Uma resposta bem-sucedida retorna o Status HTTP 201 (Criado) e um objeto de resposta que consiste em uma matriz que contém a ID do conjunto de dados recém-criado no formato "@/datasets/{DATASET_ID}". A ID do conjunto de dados é uma string gerada pelo sistema e somente leitura, usada para fazer referência ao conjunto de dados nas chamadas de API.

[
    "@/dataSets/5c8c3c555033b814b69f947f"
]

Nesta página