Show Menu
TÓPICOS×

Configurar um fluxo de dados para um conector de banco de dados na interface do usuário

Um fluxo de dados é uma tarefa programada que recupera e ingere dados de uma fonte para um conjunto de dados Platform. Este tutorial fornece etapas para configurar um novo fluxo de dados usando o conector básico do banco de dados.

Introdução

Este tutorial requer uma compreensão funcional dos seguintes componentes do Adobe Experience Platform:
  • Sistema do Experience Data Model (XDM): A estrutura padronizada pela qual o Experience Platform organiza os dados de experiência do cliente.
    • Noções básicas da composição do schema: Saiba mais sobre os elementos básicos dos schemas XDM, incluindo princípios-chave e práticas recomendadas na composição do schema.
    • Tutorial do Editor de Schemas: Saiba como criar schemas personalizados usando a interface do editor de Schemas.
  • Perfil do cliente em tempo real: Fornece um perfil unificado e em tempo real para o consumidor, com base em dados agregados de várias fontes.
Além disso, este tutorial requer que você já tenha criado um conector de banco de dados. Uma lista de tutoriais para criar diferentes conectores de banco de dados na interface do usuário pode ser encontrada na visão geral dos conectores de origem.

Selecionar dados

Depois de criar o conector do banco de dados, a etapa Selecionar dados é exibida, fornecendo uma interface interativa para que você explore a hierarquia do banco de dados.
  • A metade esquerda da interface é um navegador, exibindo a lista de bancos de dados de sua conta.
  • A metade direita da interface permite que você pré-visualização até 100 linhas de dados.
Selecione o banco de dados que deseja usar e clique em Avançar .

Mapear campos de dados para um schema XDM

A etapa Mapeamento é exibida, fornecendo uma interface interativa para mapear os dados de origem para um conjunto de dados Platform.
Escolha um conjunto de dados para os dados de entrada a serem ingeridos. Você pode usar um conjunto de dados existente ou criar um novo conjunto de dados.

Usar um conjunto de dados existente

Para assimilar dados em um conjunto de dados existente, selecione Conjunto de dados ​existente e clique no ícone do conjunto de dados.
A caixa de diálogo Selecionar conjunto de dados é exibida. Encontre o conjunto de dados que deseja usar, selecione-o e clique em Continuar .

Usar um novo conjunto de dados

Para assimilar dados em um novo conjunto de dados, selecione Novo conjunto de dados e insira um nome e uma descrição para o conjunto de dados nos campos fornecidos.
Você pode anexar um campo de schema digitando um nome de schema na barra de pesquisa Selecionar schema . Você também pode selecionar o ícone suspenso para ver uma lista de schemas existentes. Como alternativa, você pode selecionar Pesquisa ​avançada para uma tela de schemas existentes, incluindo seus respectivos detalhes.
A caixa de diálogo *Selecionar schema é exibida. Selecione o schema que deseja aplicar ao novo conjunto de dados e clique em Concluído .
Com base em suas necessidades, você pode optar por mapear os campos diretamente ou usar as funções do mapeador para transformar dados de origem para derivar valores calculados ou calculados. Para obter mais informações sobre funções de mapeamento e mapeamento de dados, consulte o tutorial sobre como mapear dados CSV para campos de schema XDM.
Depois que os dados de origem forem mapeados, clique em Avançar .

Execuções de ingestão agendada

A etapa Agendamento é exibida, permitindo que você configure um agendamento de ingestão para assimilar automaticamente os dados de origem selecionados usando os mapeamentos configurados. A tabela a seguir descreve os diferentes campos configuráveis para programação:
Campo
Descrição
Frequência
As frequências selecionáveis incluem Uma vez, Minuto, Hora, Dia e Semana.
Intervalo
Um número inteiro que define o intervalo para a frequência selecionada.
hora do Start
Um carimbo de data e hora UTC indicando quando a primeira ingestão está definida para ocorrer
Backfill
Um valor booliano que determina quais dados são inicialmente assimilados. Se o preenchimento retroativo estiver ativado, todos os arquivos atuais no caminho especificado serão ingeridos durante a primeira ingestão programada. Se o preenchimento retroativo estiver desativado, somente os arquivos carregados entre a primeira execução da ingestão e a hora do Start serão assimilados. Os arquivos carregados antes da hora do Start não serão ingeridos.
Coluna Delta
Uma opção com um conjunto filtrado de campos de schema de origem de tipo, data ou hora. Esse campo é usado para diferenciar entre dados novos e existentes. Os dados incrementais serão ingeridos com base no carimbo de data e hora da coluna selecionada.
Os fluxos de dados são projetados para assimilar dados automaticamente de acordo com uma programação. Start selecionando a frequência da ingestão. Em seguida, defina o intervalo para designar o período entre duas execuções de fluxo. O valor do intervalo deve ser um número inteiro diferente de zero e deve ser definido como maior ou igual a 15.
Para definir a hora de ingestão do start, ajuste a data e a hora exibidas na caixa da hora do start. Como alternativa, você pode selecionar o ícone de calendário para editar o valor de hora do start. O tempo de Start deve ser maior ou igual ao tempo UTC atual.
Selecione Carregar dados incrementais por para atribuir a coluna delta. Este campo fornece uma distinção entre dados novos e existentes.

Configurar um fluxo de dados de ingestão única

Para configurar a ingestão única, selecione a seta suspensa de frequência e selecione Uma vez .
O intervalo e o preenchimento retroativo não são visíveis durante uma ingestão única.
Depois de fornecer os valores apropriados para a programação, selecione Avançar .

Dê um nome ao seu fluxo de dados

A etapa de detalhes do dataflow é exibida, onde você deve fornecer um nome e uma descrição opcional para o dataflow. Selecione Próximo ao terminar.

Revisar seu fluxo de dados

A etapa Revisar é exibida, permitindo que você revise seu novo fluxo de dados antes de ele ser criado. Os detalhes são agrupados nas seguintes categorias:
  • Conexão : Mostra o tipo de origem, o caminho relevante do arquivo de origem escolhido e a quantidade de colunas nesse arquivo de origem.
  • Atribuir campos do conjunto de dados e mapear: Mostra em qual conjunto de dados os dados de origem estão sendo assimilados, incluindo o schema ao qual o conjunto de dados adere.
  • Agendamento : Mostra o período ativo, a frequência e o intervalo do agendamento da ingestão.
Depois de revisar seu fluxo de dados, clique em Concluir e aguarde algum tempo para que o fluxo de dados seja criado.

Monitore e exclua seu fluxo de dados

Depois que o seu fluxo de dados for criado, você poderá monitorar os dados que estão sendo assimilados por meio dele. Para obter mais informações sobre como monitorar e excluir seu fluxo de dados, consulte o tutorial sobre como monitorar e excluir fluxos de dados .

Próximas etapas

Ao seguir este tutorial, você criou com êxito um fluxo de dados para trazer dados de um banco de dados externo e obteve informações sobre o monitoramento de conjuntos de dados. Os dados recebidos agora podem ser usados pelos serviços da Platform de downstream, como o Perfil do cliente em tempo real e a Área de trabalho de análise de dados. Consulte os seguintes documentos para obter mais detalhes:

Apêndice

As seções a seguir fornecem informações adicionais para trabalhar com conectores de origem.

Desativar um fluxo de dados

Quando um fluxo de dados é criado, ele imediatamente se torna ativo e ingere dados de acordo com o agendamento que foi fornecido. Você pode desativar um fluxo de dados ativo a qualquer momento seguindo as instruções abaixo.
Na área de trabalho Fontes , selecione a guia Fluxos de dados . Em seguida, selecione o fluxo de dados que deseja desativar.
A coluna Propriedades é exibida no lado direito da tela, incluindo um botão de alternância Ativado . Selecione a alternância para desativar o fluxo de dados. A mesma alternância pode ser usada para reativar um fluxo de dados depois que ele for desativado.

Ativar dados de entrada para Profile população

Os dados de entrada do conector de origem podem ser usados para enriquecer e preencher seus Real-time Customer Profile dados. Para obter mais informações sobre como preencher seus Real-time Customer Profile dados, consulte o tutorial sobre a população do Perfil.