DocumentaçãoExperience PlatformGuia dos conectores de origem

Beta Ultimate

Conectar o Azure Databricks ao Experience Platform usando a API Flow Service

Última atualização: 17 de junho de 2025
  • Tópicos:

Criado para:

  • Desenvolvedor
DISPONIBILIDADE
  • A origem Azure Databricks está disponível no catálogo de origens para usuários que compraram o Real-Time CDP Ultimate.

  • A origem Azure Databricks está na versão beta. Leia os termos e condições na visão geral das fontes para obter mais informações sobre como usar fontes com rótulo beta.

Leia este guia para saber como conectar sua conta do Azure Databricks à Adobe Experience Platform usando a Flow Service API.

Introdução

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

  • Fontes: o Experience Platform permite a assimilação de dados de várias fontes, ao mesmo tempo em que fornece a capacidade de estruturar, rotular e aprimorar os dados recebidos usando os serviços do Experience Platform.
  • Sandboxes: a Experience Platform fornece sandboxes virtuais que particionam uma única instância do Experience Platform em ambientes virtuais separados para ajudar a desenvolver aplicativos de experiência digital.

Uso de APIs do Experience Platform

Leia o manual sobre como começar a usar as APIs do Experience Platform para obter informações sobre como fazer chamadas com êxito para as APIs do Experience Platform.

Configurar pré-requisitos

Leia a Databricks visão geral para saber mais sobre as configurações de pré-requisito que devem ser concluídas antes de você poder conectar sua conta à Experience Platform.

Coletar credenciais necessárias

Forneça valores para as credenciais a seguir para conectar Databricks ao Experience Platform.

CredencialDescrição
domainA URL do espaço de trabalho Databricks. Por exemplo, https://adb-1234567890123456.7.azuredatabricks.net.
clusterIdA ID do cluster em Databricks. Este cluster já deve ser um cluster existente e deve ser um cluster interativo.
accessTokenO token de acesso que autentica a conta do Databricks. Você pode gerar seu token de acesso usando o espaço de trabalho Databricks.
databaseO nome do banco de dados no lago delta.
connectionSpec.IdA ID de especificação de conexão retorna as propriedades do conector de origem, incluindo especificações de autenticação relacionadas à criação das conexões de base e de origem. A ID de especificação da conexão para Databricks é e9d7ec6b-0873-4e57-ad21-b3a7c65e310b.

Para obter mais informações, leia a visão geral🔗 do Azure Databricks .

Criar uma conexão básica

Uma conexão base retém informações entre sua origem e a Experience Platform, incluindo as credenciais de autenticação da origem, o estado atual da conexão e a ID de conexão base exclusiva. A ID de conexão básica permite explorar e navegar pelos arquivos de dentro da origem e identificar os itens específicos que deseja assimilar, incluindo informações sobre os tipos de dados e formatos.

Para criar uma ID de conexão base, faça uma solicitação POST para o ponto de extremidade /connections e forneça as credenciais de autenticação apropriadas para sua conta Databricks.

Formato da API

POST /connections

Solicitação

A solicitação a seguir cria uma conexão base para uma origem Databricks usando autenticação de token de acesso.

Exibir exemplo de solicitação
curl -X POST \
'https://platform.adobe.io/data/foundation/flowservice/connections' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-H 'Content-Type: application/json' \
-d '{
    "name": "Databricks connection to Experience Platform",
    "description": "A Databricks base connection to Experience Platform",
    "auth": {
        "specName": "Access Token Authentication",
        "params": {
          "domain": "https://adb-1234567890123456.7.azuredatabricks.net",
          "clusterId": "xxxx",
          "accessToken": "xxxx",
          "database": "acme-db"
        }
    },
    "connectionSpec": {
        "id": "e9d7ec6b-0873-4e57-ad21-b3a7c65e310b",
        "version": "1.0"
    }
}'
Propriedade
Descrição
auth.params.domain
A URL do espaço de trabalho Databricks.
auth.params.clusterId
A ID do cluster em Databricks. Este cluster já deve ser um cluster existente e deve ser um cluster interativo
auth.params.accessToken
O token de acesso que autentica a conta do Databricks.
auth.params.database
O nome do banco de dados no lago delta.
connectionSpec.id
A ID de especificação de conexão Databricks.

Resposta

Uma resposta bem-sucedida retorna a conexão recém-criada, incluindo a ID de conexão básica.

Exibir exemplo de resposta
{
    "id": "f847950c-1c12-4568-a550-d5312b16fdb8",
    "etag": "\"0c0099f4-0000-0200-0000-67da91710000\""
}

Próximas etapas

Ao seguir este tutorial, você criou com êxito uma conexão entre sua conta do Databricks e a Experience Platform. Você pode usar sua ID de conexão base recém-gerada nos seguintes tutoriais:

  • Explore a estrutura e o conteúdo das tabelas de dados usando a API Flow Service
  • Crie um fluxo de dados para trazer dados do banco de dados para a Experience Platform usando a API Flow Service
recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089