Conectar o Databricks ao Experience Platform usando a API Flow Service

Last update: Wed Sep 24 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Tópicos:

Criado para:

Desenvolvedor

AVAILABILITY

A origem Databricks está disponível no catálogo de origens para usuários que compraram o Real-Time CDP Ultimate.
A origem 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 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.

Credencial

Descrição

domain

A URL do espaço de trabalho Databricks. Por exemplo, https://adb-1234567890123456.7.azuredatabricks.net.

clusterId

A ID do cluster em Databricks. Este cluster já deve ser um cluster existente e deve ser um cluster interativo.

accessToken

O token de acesso que autentica a conta do Databricks. Você pode gerar seu token de acesso usando o espaço de trabalho Databricks.

database

O nome do banco de dados no lago delta.

connectionSpec.Id

A 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 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

code language-shell

code language-shell
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" } }'

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"
    }
}'

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2
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

code language-json
`{ "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:

recommendation-more-help

337b99bb-92fb-42ae-b6b7-c7042161d089