Para criar um conjunto de dados usando a variável Catalog , você deve saber o $id
valor de Experience Data Model Esquema do (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 POST para o /datasets
endpoint na variável Catalog API.
Este documento aborda apenas como criar um objeto de conjunto de dados no Catalog. Para obter 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: {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"
}
}'
Propriedade | Descrição |
---|---|
name |
O nome do conjunto de dados a ser criado. |
schemaRef.id |
O 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 esquema no guia API XDM para obter mais informações. |
Este exemplo usa o Apache Parquet formato de arquivo para seus containerFormat
propriedade. 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 cadeia de caracteres gerada pelo sistema e somente leitura usada para fazer referência ao conjunto de dados em chamadas de API.
[
"@/dataSets/5c8c3c555033b814b69f947f"
]