DatabricksコネクタはEnterpriseプランでのみご利用いただけます。
- Databricks管理者：Databricksでサービスプリンシパルを作成して権限を付与します。
- Replit管理者：Replitでコネクタを設定します。
- ビルダー：Databricksデータを使って構築を開始します。
前提条件
開始する前に、以下を確認してください。 役割- Databricksアカウント管理者またはワークスペース管理者
- Replit組織管理者
ステップ1：Databricksでサービスプリンシパルを作成する
このステップを完了するにはDatabricksアカウント管理者またはワークスペース管理者である必要があります。
1
設定を開く
Databricksで、右上隅のアバターを選択し、Settingsを選択します。
2
IDとアクセスを選択する
SettingsサイドバーでIdentity and accessを選択します。
3
サービスプリンシパルを管理する
Management and permissionsの下でService principalsを見つけ、Manageを選択します。
4
新しいサービスプリンシパルを追加する
Add service principalを選択し、Add newを選択します。
5
サービスプリンシパルに名前を付ける
サービスプリンシパルの明確な名前を入力し、Addを選択します。
6
サービスプリンシパルの詳細を確認する
Databricksがサービスプリンシパルを作成した後、アクティブであることを確認します。Replitコネクタを設定中にサービスプリンシパルの詳細が必要な場合は、このページを開いたままにしておきます。
7
アクセスを付与する
Permissionsタブを開き、Grant accessを選択し、サービスプリンシパルを選択して、権限をManageに設定し、Saveを選択します。
ステップ2：SQLウェアハウスの接続詳細を取得する
Replitコネクタは、クエリを正しいコンピュートリソースにルーティングするためにDatabricks SQLウェアハウスの接続詳細が必要です。1
SQLウェアハウスを開く
DatabricksサイドバーでSQL Warehousesを選択します。
2
ウェアハウスを選択または作成する
Replit Agentに使用させるSQLウェアハウスを選択します。まだウェアハウスがない場合は、Create SQL warehouseを選択して新しいウェアハウスを作成します。
3
接続詳細をコピーする
ウェアハウスを開いてConnection detailsを選択します。Server hostnameとHTTP pathの値を見つけます。ReplitでDatabricksコネクタを作成する際にこれらの値が必要です。
ステップ3：ReplitでDatabricksコネクタを作成する
コネクタを設定するにはReplit組織管理者である必要があります。
1
Integrationsに移動する
組織のホームからIntegrationsページを開きます。Connectorsの下で**Databricks (Service Principal)**を見つけ、Sign inを選択します。
2
接続を確認する
Replitは認証のためにDatabricksにリダイレクトする前に確認ダイアログを表示します。詳細を確認し、Continue to Databricksを選択します。
3
SQLウェアハウスのHTTPパスを入力する
DatabricksのSQLウェアハウス接続詳細のHTTP pathを貼り付け（例：
/sql/1.0/warehouses/abcdef1234567890）、Nextを選択します。4
SQLウェアハウスのサーバーホスト名を入力する
同じ接続詳細のServer hostnameを貼り付け（例：
abc-12345678-wxyz.cloud.databricks.com）、Continue to Databricksを選択して認証を完了します。5
アクセスを設定する
ロールベースのアクセス制御を使用して、組織内のどのメンバーまたはグループがこのコネクタを使用できるかを選択します。
6
コネクタがアクティブであることを確認する
Integrationsページに戻り、Databricks (Service Principal)がConnectorsの下にActive接続ステータスで表示されていることを確認します。
ステップ4：Agentで構築する
接続後、ビルダーはAgentを使用してDatabricksデータを使用したアプリケーションを作成できます。1
プロジェクトを開始する
Replitのホームからプロンプトボックスを開いて新しいプロジェクトを開始します。
2
Databricks Appテンプレートを選択する
Templatesドロップダウンを開き、Org templatesの下のDatabricks Appを選択します。プロンプトにはAgentへのDatabricksコネクタの使用方法を伝える指示があらかじめ入力されています。
3
レビューと反復
Agentが生成するSQL、クエリするテーブル、アプリケーション構造をレビューします。自然言語で変更を求めることで反復できます。
トラブルシューティング
サービスプリンシパルの作成後に認証に失敗する
サービスプリンシパルの作成後に認証に失敗する
Replitに入力されたサービスプリンシパルの詳細がDatabricksで作成されたサービスプリンシパルと一致していることを確認します。認証情報がローテーションされた場合は、Replitのコネクタを更新します。
Agentはスキーマを確認できるがクエリが空の結果を返す
Agentはスキーマを確認できるがクエリが空の結果を返す
サービスプリンシパルにはメタデータアクセス権はあるが、データの読み取り権限がない可能性があります。Databricksで必要なテーブル、スキーマ、またはカタログの権限を付与して再試行してください。
コネクタがSQLウェアハウスに到達できない
コネクタがSQLウェアハウスに到達できない
Server hostnameとHTTP pathの値がDatabricksのSQLウェアハウス接続詳細と一致していることを確認します。
関連ドキュメント
- ウェアハウスコネクタ概要：サポートされているすべてのウェアハウスコネクタ。
- Snowflakeに接続：Snowflakeのステップバイステップセットアップ。
- コネクタの管理：コネクタの管理と設定。
- Databricksサービスプリンシパル：サービスプリンシパルに関するDatabricksドキュメント。
- Databricks SQLウェアハウス：SQLウェアハウスコンピュートに関するDatabricksドキュメント。