Databricks APIを使用してFlow ServiceをExperience Platformに接続します

Last update: Tue Apr 14 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

トピック：

作成対象：

開発者

AVAILABILITY

Databricks ソースは、Real-Time CDP Ultimateを購入したユーザーがソースカタログで利用できます。

このガイドでは、DatabricksAPIFlow Service を使用してアカウントをAdobe Experience Platformに接続する方法について説明します。

基本を学ぶ

このガイドは、Adobe Experience Platform の次のコンポーネントを実際に利用および理解しているユーザーを対象としています。

ソース : Experience Platformを使用すると、様々なソースからデータを取り込むことができますが、Experience Platform サービスを使用して着信データを構造化、ラベル付け、強化することができます。
サンドボックス : Experience Platformは、1つのExperience Platform インスタンスを個別のバーチャル環境に分割して、デジタルエクスペリエンスアプリケーションの開発と進化に役立つバーチャルサンドボックスを提供します。

Experience Platform APIの使用

Experience Platform APIを正常に呼び出す方法について詳しくは、Experience Platform APIの使い方に関するガイドを参照してください。

前提条件の設定

アカウントをExperience Platformに接続する前に完了する必要がある前提条件の設定については、Databricks 概要を参照してください。

必要な資格情報の収集

DatabricksをExperience Platformに接続するために、次の資格情報の値を指定してください。

資格情報

説明

domain

Databricks ワークスペースのURL。例：https://adb-1234567890123456.7.azuredatabricks.net

clusterId

DatabricksのクラスターのID。このクラスターは既に既存のクラスターである必要があり、インタラクティブクラスターである必要があります。

accessToken

Databricks アカウントを認証するアクセストークン。 Databricks ワークスペースを使用してアクセストークンを生成できます。

database

差分レイク内のデータベースの名前。

catalog

差分レイク内のカタログの名前。デフォルトカタログの値を指定する必要はありません。

connectionSpec.Id

接続仕様IDは、ベース接続とソース接続の作成に関連する認証仕様を含む、ソースのコネクタプロパティを返します。 Databricksの接続仕様IDはe9d7ec6b-0873-4e57-ad21-b3a7c65e310bです。

詳しくは、Databricks 概要を参照してください。

ベース接続の作成

ベース接続は、ソースの認証情報、接続の現在の状態、一意のベース接続IDなど、ソースとExperience Platform間の情報を保持します。ベース接続 ID により、ソース内からファイルを参照および移動し、データタイプやフォーマットに関する情報を含む、取り込みたい特定の項目を識別することができます。

ベース接続IDを作成するには、/connections エンドポイントにPOST リクエストを行い、Databricks アカウントに適切な認証情報を提供します。

API 形式

POST /connections

リクエスト

次のリクエストは、アクセストークン認証を使用してDatabricks ソースのベース接続を作成します。

リクエストの例を表示

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
プロパティ	説明
`auth.params.domain`	Databricks ワークスペースのURL。
`auth.params.clusterId`	DatabricksのクラスターのID。このクラスターは既に既存のクラスターである必要があり、インタラクティブクラスターである必要があります
`auth.params.accessToken`	Databricks アカウントを認証するアクセストークン。
`auth.params.database`	差分レイク内のデータベースの名前。
`connectionSpec.id`	Databricks接続仕様ID。

応答

応答が成功すると、新しく作成した接続（ベース接続IDを含む）が返されます。

応答の例を表示

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

次の手順

このチュートリアルに従うことで、Databricks アカウントとExperience Platformの間の接続が正常に作成されました。新しく生成したベース接続IDは、次のチュートリアルで使用できます。

recommendation-more-help

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