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
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"
}
}'
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
{
"id": "f847950c-1c12-4568-a550-d5312b16fdb8",
"etag": "\"0c0099f4-0000-0200-0000-67da91710000\""
}