メインコンテンツへスキップ

Documentation Index

Fetch the complete documentation index at: https://docs.replit.com/llms.txt

Use this file to discover all available pages before exploring further.

DatabricksコネクタはEnterpriseプランでのみご利用いただけます。
TemplatesドロップダウンがオープンでDatabricks Appの組織テンプレートが表示されているReplitホームのプロンプトボックス
Databricksコネクタにより、Replit Agentはお客様のDatabricksワークスペースにクエリを実行できます。ビルダーは自然言語を使用してダッシュボード、レポートツール、データアプリケーションを作成できます。SQLの専門知識は不要です。 セットアップはDatabricks管理者とReplit組織管理者が関与する一度きりのプロセスです。設定が完了すると、アクセス権のあるビルダーはReplitからコネクタを使用できます。 このガイドでは3つの役割にわたる完全なセットアップを説明します:
  1. Databricks管理者:Databricksでサービスプリンシパルを作成して権限を付与します。
  2. Replit管理者:Replitでコネクタを設定します。
  3. ビルダー:Databricksデータを使って構築を開始します。

前提条件

開始する前に、以下を確認してください。 役割
  • 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 hostnameHTTP pathの値を見つけます。ReplitでDatabricksコネクタを作成する際にこれらの値が必要です。
サーバーホスト名とHTTPパスが表示されているDatabricks SQLウェアハウスの接続詳細ページ

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

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

Integrationsに移動する

組織のホームから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ページ

ステップ4:Agentで構築する

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

プロジェクトを開始する

Replitのホームからプロンプトボックスを開いて新しいプロジェクトを開始します。
プロンプトボックスとTemplatesドロップダウンが表示されているReplitホームページ
2

Databricks Appテンプレートを選択する

Templatesドロップダウンを開き、Org templatesの下のDatabricks Appを選択します。プロンプトにはAgentへのDatabricksコネクタの使用方法を伝える指示があらかじめ入力されています。
Org templatesの下にDatabricks Appテンプレートが表示されているTemplatesドロップダウン
事前入力された指示の後に、構築したいものを説明する独自のプロンプトを追加します。インスピレーションについては、Databricks Dev Hubテンプレートをご覧ください。
Databricks Appテンプレートが選択されて事前入力された指示が表示されているプロンプトボックス
3

レビューと反復

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

トラブルシューティング

Replitに入力されたサービスプリンシパルの詳細がDatabricksで作成されたサービスプリンシパルと一致していることを確認します。認証情報がローテーションされた場合は、Replitのコネクタを更新します。
サービスプリンシパルにはメタデータアクセス権はあるが、データの読み取り権限がない可能性があります。Databricksで必要なテーブル、スキーマ、またはカタログの権限を付与して再試行してください。
Server hostnameHTTP pathの値がDatabricksのSQLウェアハウス接続詳細と一致していることを確認します。

関連ドキュメント