Criar conjuntos de dados

Nesta lição, você criará conjuntos de dados para receber seus dados. Você ficará animado em saber que esta é a lição mais curta do tutorial!

Todos os dados assimilados com êxito na Adobe Experience Platform são mantidos no lago de dados como conjuntos de dados. Um conjunto de dados é uma construção de armazenamento e gerenciamento para uma coleção de dados, normalmente uma tabela, que contém um esquema (colunas) e campos (linhas). Os conjuntos de dados também contêm metadados que descrevem vários aspectos dos dados armazenados.

Os arquitetos de dados precisarão criar conjuntos de dados fora deste tutorial.

Antes de começar os exercícios, assista a este breve vídeo para saber mais sobre conjuntos de dados:

Permissões necessárias

Na lição Configurar permissões, configure todos os controles de acesso necessários para concluir esta lição, especificamente:

  • Itens de permissão Gerenciamento de dados > Visualizar conjuntos de dados e Gerenciar conjuntos de dados
  • Item de permissão Sandboxes > Luma Tutorial
  • Acesso de função de usuário ao perfil de produto Luma Tutorial Platform
  • Acesso de função de desenvolvedor ao perfil de produto Luma Tutorial Platform (para API)

Criar conjuntos de dados na interface do usuário

Neste exercício, criaremos conjuntos de dados na interface do usuário do . Vamos começar com o sistema de fidelidade:

  1. Clique em Conjuntos de dados na navegação esquerda da interface do usuário da plataforma

  2. Clique no botão Criar conjunto de dados no canto superior direito
    Criar um conjunto de dados

  3. Na próxima tela, clique em Criar conjunto de dados do esquema

  4. Na próxima tela, selecione seu Luma Loyalty Schema e clique no botão Avançar
    Selecionar o conjunto de dados

  5. Nomeie o conjunto de dados Luma Loyalty Dataset e clique no botão Finalizar
    Nomeie o conjunto de dados

  6. Quando o conjunto de dados tiver sido salvo, você será levado a uma tela como esta:
    Conjunto de dados criado

Pronto! Eu disse que isso seria rápido. Siga as mesmas etapas para criar esses outros conjuntos de dados:

  1. Luma Offline Purchase Event Dataset para seu Luma Offline Purchase Event Schema
  2. Luma Web Events Dataset para seu Luma Web Events Schema
  3. Luma Product Catalog Dataset para seu Luma Product Catalog Schema

Criar um conjunto de dados usando a API

Agora, você criará o Luma CRM Dataset usando a API.

OBSERVAÇÃO

Se você quiser ignorar o exercício da API e criar o Luma CRM Dataset na interface do usuário que está bom, basta nomeá-la Luma CRM Dataset e usar o Luma CRM Schema

Obter a id do esquema a ser usado no conjunto de dados

Primeiro precisamos obter o $id do Luma CRM Schema:

  1. Abrir Postman
  2. Se você não fez uma chamada nas últimas 24 horas, seus tokens de autorização provavelmente expiraram. Abra a chamada Adobe I/O Access Token Generation > Local Signing (Non-production use-only) > IMS: JWT Generate + Auth via User Token e clique em Enviar para solicitar novos tokens de JWT e acesso, como fez na lição Postman.
  3. Abra a chamada Schema Registry API > Schemas > List all schemas within the specified container.
  4. Atualize o cabeçalho Aceito para um dos valores permitidos, por exemplo application/vnd.adobe.xdm+json
  5. Clique no botão Send
  6. Você deve obter uma resposta 200
  7. Procure o item Luma CRM Schema na resposta e copie o valor $id
    Copie o $id

Criar o conjunto de dados

Agora é possível criar o conjunto de dados:

  1. Baixe Catalog Service API.postman_collection.json para sua pasta Luma Tutorial Assets. (A coleção Dataset Service API é para gerenciar rótulos de uso de dados em conjuntos de dados existentes)

  2. Importe a coleção para Postman

  3. Selecione a solicitação Catalog Service API > Datasets > Create a new dataset.

  4. Cole o seguinte como o Body da solicitação, substituindo o valor de id por seu próprio:

    {
        "name": "Luma CRM Dataset",
    
        "schemaRef": {
            "id": "REPLACE_WITH_YOUR_OWN_ID",
            "contentType": "application/vnd.adobe.xed-full+json;version=1"
        },
        "fileDescription": {
            "persisted": true,
            "containerFormat": "parquet",
            "format": "parquet"
        }
    }
    
  5. Clique no botão Send

  6. Você deve obter uma resposta 201 Created contendo a id do novo conjunto de dados!
    Copie o $id

DICA

Problemas comuns que fazem esta chamada e possíveis correções:

  • 400: There was a problem retrieving xdm schema. Certifique-se de ter substituído a id na amostra acima pela id de seu próprio Luma CRM Schema
  • Nenhum token de autenticação: Execute o IMS: JWT Generate + Auth via chamada User Token para gerar novos tokens
  • 401: Not Authorized to PUT/POST/PATCH/DELETE for this path : /global/schemas/: Atualize a variável de ambiente CONTAINER_ ID de global para tenant
  • 403: PALM Access Denied. POST access is denied for this resource from access control: Verifique as permissões do usuário no Admin Console

Você pode voltar para a tela Datasets na interface do usuário da Plataforma, é possível verificar a criação bem-sucedida de todos os cinco conjuntos de dados!
Cinco conjuntos de dados concluídos

Recursos adicionais

Agora que todos os nossos esquemas, identidades e conjuntos de dados estão em vigor, podemos ativá-los para o Perfil do cliente em tempo real.

Nesta página