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.

CredenzialiDescrizione
domainURL dell'area di lavoro Databricks. Ad esempio, https://adb-1234567890123456.7.azuredatabricks.net.
clusterIdID del cluster in Databricks. Questo cluster deve essere già un cluster esistente e deve essere un cluster interattivo.
accessTokenIl token di accesso che autentica l'account Databricks. È possibile generare il token di accesso utilizzando l'area di lavoro Databricks.
databaseIl nome del database nel delta lake.
connectionSpec.IdL'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.domainURL dell'area di lavoro Databricks.
auth.params.clusterIdID del cluster in Databricks. Questo cluster deve essere già esistente e deve essere un cluster interattivo
auth.params.accessTokenIl token di accesso che autentica l'account Databricks.
auth.params.databaseIl nome del database nel delta lake.
connectionSpec.idID 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\""
}