Connetti Azure Databricks ad Experience Platform utilizzando l'API Flow Service

Last update: Tue Jun 17 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Argomenti:

Creato per:

Sviluppatore

AVAILABILITY

L'origine Azure Databricks è disponibile nel catalogo delle origini per gli utenti che hanno acquistato Real-Time CDP Ultimate.
L'origine Azure Databricks è in versione beta. Leggi i termini e condizioni nella panoramica delle origini per ulteriori informazioni sull'utilizzo di origini con etichetta beta.

Leggi questa guida per scoprire come collegare il tuo account Azure Databricks a Adobe Experience Platform utilizzando Flow Service API.

Introduzione

Questa guida richiede una buona conoscenza dei seguenti componenti di Experience Platform:

Origini: Experience Platform consente di acquisire dati da varie origini e allo stesso tempo di strutturare, etichettare e migliorare i dati in arrivo tramite i servizi Experience Platform.
Sandbox: Experience Platform fornisce sandbox virtuali che suddividono una singola istanza Experience Platform in ambienti virtuali separati, utili per le attività di sviluppo e aggiornamento delle applicazioni di esperienza digitale.

Utilizzare le API di Experience Platform

Leggi la guida su come iniziare a utilizzare le API di Experience Platform per informazioni su come effettuare correttamente chiamate alle API di Experience Platform.

Configurare l’impostazione dei prerequisiti

Leggi la Databricks panoramica per scoprire le configurazioni dei prerequisiti che devono essere completate prima di poter connettere il tuo account ad Experience Platform.

Raccogli le credenziali richieste

Specificare i valori per le credenziali seguenti per connettere Databricks ad Experience Platform.

Credenziali

Descrizione

domain

URL dell'area di lavoro Databricks. Ad esempio, https://adb-1234567890123456.7.azuredatabricks.net.

clusterId

ID del cluster in Databricks. Questo cluster deve essere già un cluster esistente e deve essere un cluster interattivo.

accessToken

Il token di accesso che autentica l'account Databricks. È possibile generare il token di accesso utilizzando l'area di lavoro Databricks.

database

Il nome del database nel delta lake.

connectionSpec.Id

L'ID della specifica di connessione restituisce le proprietà del connettore di origine, incluse le specifiche di autenticazione relative alla creazione delle connessioni di base e di origine. ID della specifica di connessione per Databricks: e9d7ec6b-0873-4e57-ad21-b3a7c65e310b.

Per ulteriori informazioni, consulta la Azure Databricks panoramica.

Creare una connessione di base

Una connessione di base mantiene le informazioni tra l’origine e Experience Platform, incluse le credenziali di autenticazione dell’origine, lo stato corrente della connessione e l’ID univoco della connessione di base. L’ID della connessione di base consente di esplorare e navigare tra i file dall’interno dell’origine e identificare gli elementi specifici che desideri acquisire, comprese le informazioni relative ai tipi di dati e ai formati.

Per creare un ID connessione di base, effettuare una richiesta POST all'endpoint /connections e fornire le credenziali di autenticazione appropriate per l'account Databricks.

Formato API

POST /connections

Richiesta

La richiesta seguente crea una connessione di base per un'origine Databricks utilizzando l'autenticazione del token di accesso.

Esempio di richiesta View

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
Proprietà	Descrizione
`auth.params.domain`	URL dell'area di lavoro Databricks.
`auth.params.clusterId`	ID del cluster in Databricks. Questo cluster deve essere già esistente e deve essere un cluster interattivo
`auth.params.accessToken`	Il token di accesso che autentica l'account Databricks.
`auth.params.database`	Il nome del database nel delta lake.
`connectionSpec.id`	ID della specifica di connessione Databricks.

Risposta

In caso di esito positivo, la risposta restituisce la connessione appena creata, incluso l’ID connessione di base.

Visualizza esempio di risposta

code language-json
`{ "id": "f847950c-1c12-4568-a550-d5312b16fdb8", "etag": "\"0c0099f4-0000-0200-0000-67da91710000\"" }`

Passaggi successivi

Seguendo questa esercitazione, è stata creata una connessione tra l'account Databricks e Experience Platform. Puoi utilizzare l’ID connessione di base appena generato nelle seguenti esercitazioni:

recommendation-more-help

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