DocumentaçãoExperience PlatformGuia dos conectores de origem

[Beta]{class="badge informative"}

Use o conector de origem Databricks Delta Sharing na interface do usuário use-deltashare-in-the-ui

Última atualização: 26 de outubro de 2026

Criado para:

  • Desenvolvedor
AVAILABILITY
Este recurso está atualmente em um beta limitado e só estará disponível até 1º de agosto de 2026. Entre em contato com a equipe de conta da Adobe para solicitar acesso ao beta.

Leia este guia para saber como usar o conector de origem Databricks Delta Sharing na interface do usuário do Adobe Experience Platform.

Introdução

Este tutorial requer uma compreensão funcional dos seguintes componentes do Experience Platform:

  • Fontes: use Fontes para criar conexões e fluxos de dados para fontes de dados externas com suporte.
  • Esquemas do Experience Data Model (XDM): as tabelas compartilhadas são representadas no Experience Platform por meio de esquemas relacionais.
  • Conjuntos de dados: os dados compartilhados são representados como conjuntos de dados virtuais no Experience Platform. Os dados de origem não são assimilados fisicamente ou copiados para o data lake da Experience Platform.
  • Serviço de Consulta/Data Distiller: use o Serviço de Consulta ou o Data Distiller para consultar e trabalhar com conjuntos de dados virtuais.
IMPORTANT
Leia a Delta Sharing visão geral para saber mais sobre as etapas de pré-requisito que você precisa concluir antes de conectar sua conta à Experience Platform.

Na interface do Experience Platform, selecione Fontes na navegação à esquerda para acessar o espaço de trabalho Fontes. Selecione a categoria apropriada no painel Categorias. Como alternativa, use a barra de pesquisa para navegar até a fonte específica que deseja usar.

Para usar o Delta Sharing, selecione o cartão de origem Compartilhamento Delta para Databricks em Compartilhamento de dados e selecione Adicionar dados.

TIP
As origens no catálogo de origens exibem a opção Configurar quando uma determinada origem ainda não tem uma conta autenticada. Após a criação de uma conta autenticada, esta opção será alterada para Adicionar dados.

O catálogo de fontes com o cartão de origem Compartilhamento Delta em Compartilhamento de Dados foi selecionado.

Usar uma conta existente

Para usar uma conta existente, selecione Conta existente e selecione a conta Delta Sharing que deseja usar na interface de contas.

A interface de contas existentes no fluxo de trabalho de origem com a conta Existente selecionada.

Criar uma nova conta

Para criar uma nova conta, selecione Nova conta e forneça um nome e uma descrição opcional para sua conta. Forneça valores para as seguintes credenciais de autenticação:

  • Endpoint
  • Token de portador
  • Versão das credenciais de compartilhamento
  • Tempo de expiração
TIP
Leia o Delta Sharing guia de autenticação para obter mais informações sobre essas credenciais.

Quando terminar, selecione Conectar à origem e aguarde alguns momentos para estabelecer a conexão.

A nova interface de conta com campos de autenticação de Compartilhamento Delta, incluindo ponto de extremidade, token de portador, versão de credenciais de compartilhamento e hora de expiração.

Selecione seus dados

Em seguida, selecione o para o qual deseja criar um conjunto de dados virtual no Experience Platform e em aplicativos baseados em plataforma. Use o diretório da tabela para navegar até os dados desejados e use a interface de visualização para exibir o conteúdo e a estrutura dos dados selecionados. Quando terminar, selecione Próximo para selecionar colunas para o esquema.

A etapa de seleção de dados que mostra o diretório da tabela e a visualização dos dados a serem assimilados.

Selecione seu esquema

IMPORTANT
Depois de selecionar Próximo, você não poderá alterar a estrutura do esquema selecionado. Se você já tiver selecionado Próximo e movido para além da etapa de seleção de esquema, não poderá mais atualizar o esquema selecionado se retornar a uma etapa anterior. Para modificar seu esquema, você deve reiniciar o processo de configuração do fluxo de dados e começar a partir da etapa inicial.

Após selecionar uma tabela da origem Delta Sharing, o Experience Platform infere automaticamente o esquema relacional. Nesse estágio, é necessário fornecer um nome de esquema antes de continuar. Opcionalmente, você também pode especificar uma chave primária e um descritor de versão para definir melhor seu esquema.

Chave primária: defina uma chave primária, se a tabela tiver uma. Considere os seguintes fatores ao selecionar uma chave primária:

  • Selecione uma chave exclusiva por linha para a entidade lógica da qual você se importa (por exemplo, uma linha por pedido, por cliente, por transação).
  • Selecione uma chave que seja estável ao longo do tempo (não é alterada depois de gravada).
  • Selecione uma chave que não seja um substituto de alta cardinalidade e não comercial sem significado para governança (por exemplo, uma “row_id” aleatória regenerada pelo upstream).

Descritor de versão: o descritor de versão marca uma coluna que informa qual linha é o registro “mais recente” de determinada chave. Use isso como referência caso sua tabela mantenha várias versões da mesma entidade e você queira uma maneira bem definida de escolher a atual ou a mais recente. Considere os seguintes fatores ao selecionar um descritor de versão:

  • Um carimbo de data/hora como last_updated_at ou modified_ts.
  • Uma versão numérica crescente, como version_num ou sequence_number.

Você pode deixar o descritor de versão vazio se se enquadrar nos seguintes cenários:

  • A tabela é puramente transacional/nível de evento (isso significa que cada linha é um evento único e não representa uma “entidade” mutável com versões).
  • Não há coluna de indicador confiável “mais recente”.
  • Você não validou o que a coluna de carimbo de data e hora/versão realmente significa.
TIP
Se não tiver certeza, é possível optar por deixar o descritor de versão em branco. Você ainda pode consultar o conjunto de dados virtual e implementar a lógica "mais recente" diretamente no SQL.

A etapa de seleção de esquema com esquema relacional inferido, nome de esquema, chave primária opcional e campos de descritor de versão.

Fornecer detalhes do conjunto de dados e do fluxo de dados

Um conjunto de dados é uma construção de gerenciamento para uma coleção de dados, normalmente uma tabela, que contém um esquema com colunas ou campos. Em Compartilhamento de Dados, os dados selecionados são representados na Experience Platform como um conjunto de dados virtual. Os dados permanecem no sistema de origem e não são assimilados ou mantidos no data lake.

Depois que o conjunto de dados virtual for configurado, forneça detalhes para o fluxo de dados, incluindo um nome, uma descrição opcional e configurações de alerta.

Configurações de fluxo de dados
Descrição
Nome do fluxo de dados
O nome do fluxo de dados. Por padrão, esse campo usará o nome do arquivo que está sendo importado.
Descrição
(Opcional) Uma breve descrição do fluxo de dados.
Alertas

O Experience Platform pode produzir alertas baseados em eventos, nos quais os usuários podem assinar. Essas opções permitem que um fluxo de dados em execução acione esses alertas. Para obter mais informações, leia a visão geral dos alertas

  • Início da Execução do Fluxo de Dados de Fontes: selecione este alerta para receber uma notificação quando a execução do fluxo de dados começar.
  • Êxito na Execução do Fluxo de Dados de Fontes: selecione este alerta para receber uma notificação se o fluxo de dados terminar sem erros.
  • Falha na execução do fluxo de dados de fontes: selecione este alerta para receber uma notificação se a execução do fluxo de dados terminar com erros.

Os detalhes do conjunto de dados e do fluxo de dados fazem interface com as opções de nome do fluxo de dados, descrição e configuração de alerta.

Revisar seu fluxo de dados

A etapa Revisar é exibida, permitindo que você revise os detalhes do fluxo de dados antes que ele seja criado. Os detalhes são agrupados nas seguintes categorias:

  • Conexão: mostra o nome da conta, a plataforma de origem e o nome de origem.
  • Atribuir conjunto de dados e mapear campos: mostra o conjunto de dados de destino e o esquema ao qual o conjunto de dados pertence.

Depois de confirmar que os detalhes estão corretos, selecione Concluir.

A etapa de Revisão que resume a conexão e a atribuição do conjunto de dados antes de concluir o fluxo de dados.

Monitorar seu fluxo de dados

Após a criação do fluxo de dados, é possível monitorar o status e a atividade para exibir informações como status de execução, sucesso e erros. Para obter mais informações, consulte o tutorial sobre monitoramento de contas e fluxos de dados na interface.

recommendation-more-help
experience-platform-help-sources