Skip to main content
DatabricksコネクタはEnterpriseプランでのみご利用いただけます。
TemplatesドロップダウンがオープンでDatabricks Appの組織テンプレートが表示されているReplitホームのプロンプトボックス
Databricksコネクタにより、Replit Agentはお客様のDatabricksワークスペースにクエリを実行できます。ビルダーは自然言語を使用してダッシュボード、レポートツール、データアプリケーションを作成できます。SQLの専門知識は不要です。 Replitは2種類のDatabricks接続タイプをサポートしています。各クエリを実行するべきIDに基づいて選択してください。

​
接続タイプを選択する

ユーザーツーマシン（U2M）をセットアップする

各ビルダーのDatabricks ID、権限、監査の帰属を使用します。

サービスプリンシパル（M2M）をセットアップする

認可されたビルダー向けに、1つの共有Databricks IDと権限セットを使用します。

​
U2Mコネクタをセットアップする

U2Mのセットアップには3つの役割が関わります。
  1. Databricksアカウント管理者：OAuthアプリ接続を作成し、SQLウェアハウスの詳細を提供します。
  2. Replit組織管理者：OAuth認証情報でコネクタを設定します。
  3. ビルダー：自分のDatabricksアカウントでサインインし、構築を開始します。

​
U2Mの前提条件

開始する前に、以下を確認してください。
  • Databricksのアカウント管理者。アプリ接続はワークスペース管理設定ではなく、アカウントコンソールで設定します。
  • Replit組織管理者。
  • コネクタを使用するすべてのビルダーのDatabricksアカウント。
  • SQLウェアハウスのCan use権限と必要なUnity Catalog権限を含む、すべてのビルダーのワークスペースアクセス権。

​
ステップ1：OAuthアプリ接続を作成する

このステップを完了するにはDatabricksアカウント管理者である必要があります。
Databricksアカウント管理者は、ReplitをOAuthアプリケーションとして登録します。アプリ接続により、Replitの設定に使用するクライアントIDとクライアントシークレットが提供されます。
1

Databricksアカウントコンソールを開く

Databricksワークスペースで、右上隅のワークスペースピッカーを開き、Manage accountを選択します。
Manage accountが表示されているDatabricksワークスペースピッカー
2

App connectionsを開く

アカウントコンソールでSettingsを選択し、App connectionsタブを開きます。
App connectionsタブが選択され、Add connectionボタンが表示されているDatabricksアカウントのSettingsページ
3

Replit接続を設定する

Add connectionを選択します。Replitを識別できるアプリケーション名（例：replit-u2m）を入力します。Redirect URLsに以下を入力します。
Access scopesでAll APIsを選択します。これにより、AgentがDatabricks Appsの構築および管理に必要なDatabricks SQLとDatabricks APIを使用できるようになります。Generate a client secretを選択します。Databricksでは、この接続を作成した後にシークレットを追加することはできません。組織のセキュリティポリシーに従ってトークンの有効期間を設定してください。この例では、Databricksが表示する最大値であるAccess token TTL 1440分（24時間）とRefresh token TTL 129600分（90日間）を使用しています。リフレッシュトークンの有効期間を短くすると、ビルダーがより頻繁にサインインする必要が生じる場合があります。Addを選択します。
All APIsはSQL単独よりも広い範囲のアクセス権を付与します。各ビルダーのDatabricks権限でコネクタの実質的なアクセス権を制御してください。
Replitのアプリケーション名、リダイレクトURL、All APIsアクセス、クライアントシークレットの生成、トークンの有効期間が設定されたDatabricksのAdd connectionフォーム
4

OAuth認証情報を保存する

Client IDとClient Secretをコピーし、組織のシークレットマネージャーに保存します。
Databricksはクライアントシークレットを一度だけ表示します。有効期限を記録し、シークレットが期限切れになる前にアプリ接続をローテーションしてください。
クライアントIDとクライアントシークレットが伏せられ、ワンタイムシークレットの警告と有効期限が表示されているDatabricksのConnection createdダイアログ
新規または更新されたOAuthアプリ接続が利用可能になるまで最大30分かかる場合があります。

​
ステップ2：SQLウェアハウスの詳細を共有する

各ビルダーは、U2Mコネクタを認可する際にSQLウェアハウスの詳細を入力します。社内オンボーディングページなど、ビルダーがアクセスできる場所にこれらの値を公開してください。
1

SQL Warehousesを開く

DatabricksワークスペースでSQL Warehousesを選択し、ビルダーが使用するウェアハウスを開きます。
利用可能なウェアハウスが表示されているDatabricks SQLウェアハウスページ
2

接続詳細をコピーする

Connection detailsを選択し、Server hostnameとHTTP pathをコピーします。
サーバーホスト名とHTTPパスが表示されているDatabricks SQLウェアハウスの接続詳細ページ

​
ステップ3：ReplitでU2Mを有効にする

コネクタを設定するにはReplit組織管理者である必要があります。
1

U2Mコネクタを開いて有効にする

ReplitアカウントホームからSettings、次にIntegrationsを開きます。Databricks U2Mを検索し、Databricks for Databricks Apps (U2M)を見つけてEnableを選択します。Databricksアプリ接続のClient IDとClient Secretを入力します。Replitに表示されるリダイレクトURLがDatabricksで設定されたURLと一致していることを確認します。
Connector Scopesでall-apisとoffline_accessを有効にします。offline_accessスコープにより、Replitは長期セッション用のリフレッシュトークンを取得します。Configureを選択します。
Databricks U2Mでフィルタリングされ、リダイレクトURL、OAuth認証情報フィールド、コネクタスコープが表示されているReplitのIntegrations設定の有効化パネル
2

コネクタが有効になっていることを確認する

Your integrationsの下に**Databricks for Databricks Apps (U2M)**が表示されていることを確認します。

​
ステップ4：ビルダーとしてサインインする

各ビルダーは、コネクタを使用する前に自分のDatabricksアカウントでサインインします。Replitはリフレッシュトークンが期限切れになるまでセッションを更新できます。
1

コネクタにサインインする

IntegrationsページでDatabricks for Databricks Apps (U2M)を見つけてSign inを選択します。接続の詳細を確認し、Continue to Databricks for Databricks Appsを選択します。
リダイレクト、プライバシー、権限制御について説明するConnect Databricks for Databricks Appsモーダル
2

SQLウェアハウスの詳細を入力する

Databricks管理者から提供されたSQLウェアハウスのHTTP pathを入力し、Nextを選択します。
2ステップ中の1で、SQLウェアハウスのHTTPパスを求めるConnect Databricks for Databricks Appsダイアログ
次に、ReplitはSQLウェアハウスのServer hostnameを求めます。入力してDatabricksに進みます。プロンプトが表示されたらサインインし、要求されたアクセス権を確認して、リクエストを承認します。この接続を通じてAgentが実行するすべてのクエリは、お客様のDatabricks権限を使用し、Databricksの監査ログでお客様に帰属します。承認後、DatabricksはReplitに戻り、コネクタが使用可能になります。

​
サービスプリンシパルコネクタをセットアップする

サービスプリンシパルのセットアップには3つの役割が関わります。
  1. Databricks管理者：Databricksでサービスプリンシパルを作成して権限を付与します。
  2. Replit組織管理者：Replitでコネクタとアクセス権を設定します。
  3. ビルダー：共有Databricks IDを使って構築を開始します。

​
サービスプリンシパルの前提条件

開始する前に、以下を確認してください。
  • Databricksアカウント管理者またはワークスペース管理者権限。
  • Replit組織管理者権限。

​
ステップ1：Databricksでサービスプリンシパルを作成する

このステップを完了するにはDatabricksアカウント管理者またはワークスペース管理者である必要があります。
Databricks管理者は、Replitがdatabricksへの接続に使用するマシン間のID（サービスプリンシパルと呼ばれる）を作成します。
1

設定を開く

Databricksで、右上隅のアバターを選択し、Settingsを選択します。
Settingsが選択されているDatabricksワークスペースメニュー
2

IDとアクセスを選択する

SettingsサイドバーでIdentity and accessを選択します。
サイドバーにIdentity and accessが表示されているDatabricks設定ページ
3

サービスプリンシパルを管理する

Management and permissionsの下でService principalsを見つけ、Manageを選択します。
Service principalsのManageボタンが表示されているIDとアクセス設定ページ
4

新しいサービスプリンシパルを追加する

Add service principalを選択し、Add newを選択します。
Add newボタンのあるサービスプリンシパルの追加ダイアログ
5

サービスプリンシパルに名前を付ける

サービスプリンシパルの明確な名前を入力し、Addを選択します。
サービスプリンシパル名が入力されたサービスプリンシパルの追加ダイアログ
6

サービスプリンシパルの詳細を確認する

Databricksがサービスプリンシパルを作成した後、アクティブであることを確認します。Replitコネクタを設定中にサービスプリンシパルの詳細が必要な場合は、このページを開いたままにしておきます。
Databricksサービスプリンシパルの詳細ページ
7

アクセスを付与する

Permissionsタブを開き、Grant accessを選択し、サービスプリンシパルを選択して、権限をManageに設定し、Saveを選択します。
Manage権限が選択されたDatabricksサービスプリンシパルのアクセス付与ダイアログ

​
ステップ2：SQLウェアハウスの接続詳細を取得する

Replitコネクタは、クエリを正しいコンピュートリソースにルーティングするためにDatabricks SQLウェアハウスの接続詳細が必要です。
1

SQLウェアハウスを開く

DatabricksサイドバーでSQL Warehousesを選択します。
利用可能なウェアハウスが表示されているDatabricks SQLウェアハウスページ
2

ウェアハウスを選択または作成する

Replit Agentに使用させるSQLウェアハウスを選択します。まだウェアハウスがない場合は、Create SQL warehouseを選択して新しいウェアハウスを作成します。
3

接続詳細をコピーする

ウェアハウスを開いてConnection detailsを選択します。Server hostnameとHTTP pathの値を見つけます。ReplitでDatabricksコネクタを作成する際にこれらの値が必要です。
サーバーホスト名とHTTPパスが表示されているDatabricks SQLウェアハウスの接続詳細ページ

​
ステップ3：ReplitでDatabricksコネクタを作成する

コネクタを設定するにはReplit組織管理者である必要があります。
Replit管理者がDatabricksの接続詳細をReplitに追加することで、ビルダーがコネクタを使用できるようになります。
1

Integrationsに移動する

ReplitアカウントホームからIntegrationsページを開きます。Connectorsの下で**Databricks (Service Principal)**を見つけ、Sign inを選択します。
DatabricksでフィルタリングされたReplit IntegrationsページにSign inボタン付きのDatabricks (Service Principal)コネクタが表示
2

接続を確認する

Replitは認証のためにDatabricksにリダイレクトする前に確認ダイアログを表示します。詳細を確認し、Continue to Databricksを選択します。
OAuthリダイレクト、データ使用、権限を説明するDatabricksの接続ダイアログ
3

SQLウェアハウスのHTTPパスを入力する

DatabricksのSQLウェアハウス接続詳細のHTTP pathを貼り付け（例：/sql/1.0/warehouses/abcdef1234567890）、Nextを選択します。
SQLウェアハウスのHTTPパスを求めるDatabricks接続ダイアログのステップ1/2
4

SQLウェアハウスのサーバーホスト名を入力する

同じ接続詳細のServer hostnameを貼り付け（例：abc-12345678-wxyz.cloud.databricks.com）、Continue to Databricksを選択して認証を完了します。
SQLウェアハウスのサーバーホスト名を求めるDatabricks接続ダイアログのステップ2/2
5

アクセスを設定する

ロールベースのアクセス制御を使用して、組織内のどのメンバーまたはグループがこのコネクタを使用できるかを選択します。
6

コネクタがアクティブであることを確認する

Integrationsページに戻り、Databricks (Service Principal)がConnectorsの下にActive接続ステータスで表示されていることを確認します。
Active接続ステータスのDatabricks (Service Principal)コネクタが表示されているReplit Integrationsページ

​
Agentで構築する

いずれかの方法で接続した後、ビルダーはAgentを使用してDatabricksデータを使用したアプリケーションを作成できます。
1

デプロイ用にDatabricks Appテンプレートを選択する

完成したアプリをDatabricks環境にデプロイしたい場合は、Databricks Appテンプレートを選択します。設定済みのコネクタを使用してDatabricksのデータやアセットにアクセスするだけであれば、このテンプレートは不要です。Replitホームページからテンプレートセレクターを開き、Databricks Appを選択します。
プロンプトボックスの上にDatabricks Appテンプレートが選択されているReplitホームページ
2

アプリケーションを説明する

事前入力された指示の後に、プロンプトを追加します。インスピレーションについては、Databricks Dev Hubテンプレートをご覧ください。
3

レビューと反復

Agentが生成するSQL、クエリするテーブル、アプリケーション構造をレビューします。自然言語で変更を依頼できます。

​
トラブルシューティング

クエリを実行しているIDのDatabricks権限を確認してください。U2Mの場合は個々のビルダー、サービスプリンシパルコネクタの場合は共有サービスプリンシパルです。IDにはメタデータへのアクセス権はあるが、データの読み取り権限がない場合があります。必要なカタログ、スキーマ、またはテーブルの権限を付与して再試行してください。
Server hostnameとHTTP pathの値がDatabricksのSQLウェアハウス 接続詳細と一致していることを確認します。U2Mの場合は、該当するビルダーが 入力した値を確認してください。また、ウェアハウスが実行中であり、クエリを 実行するIDにそれを使用する権限があることも確認してください。
U2Mの場合、Databricksアプリ接続のRedirect URLsに、末尾にスラッシュの ないhttps://replit.com/connectors/oauth/callbackが記載されていることを 確認してください。すべてのビルダーで認証が失敗する場合は、共有のClient IDと Client Secretを確認し、シークレットが期限切れになっていないことを確認し、 Replitのスコープが Databricksアプリ接続と一致していることを確認してください。サービスプリンシパルコネクタの場合は、Replitに入力されたサービスプリンシパルの 詳細がDatabricksで作成されたサービスプリンシパルと一致していることを確認して ください。認証情報がローテーションされた場合は、Replitのコネクタを更新して ください。
これは、U2Mでリフレッシュトークンが期限切れになったか失効した場合に発生する ことがあります。Databricksの認可フローを再度完了してください。ビルダーが セキュリティポリシーで求められる頻度よりも頻繁に再接続する必要がある場合は、 アプリ接続のトークンの有効期間を見直してください。

​
関連ドキュメント