> ## 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コネクタ

> DatabricksコネクタをセットアップしてReplit Agentがお客様のDatabricksワークスペースを基盤としたデータ駆動型アプリケーションを構築できるようにします。

<Info>
  DatabricksコネクタはEnterpriseプランでのみご利用いただけます。
</Info>

<Frame>
  <img src="https://mintcdn.com/replit/xfCoeTDIPMvB7evM/images/connectors/databricks/templates-dropdown-zoom.png?fit=max&auto=format&n=xfCoeTDIPMvB7evM&q=85&s=92d2df97ba167b7fd5b9dfe7509e7dfa" alt="TemplatesドロップダウンがオープンでDatabricks Appの組織テンプレートが表示されているReplitホームのプロンプトボックス" width="1680" height="300" data-path="images/connectors/databricks/templates-dropdown-zoom.png" />
</Frame>

Databricksコネクタにより、Replit Agentはお客様のDatabricksワークスペースにクエリを実行できます。ビルダーは自然言語を使用してダッシュボード、レポートツール、データアプリケーションを作成できます。SQLの専門知識は不要です。

セットアップはDatabricks管理者とReplit組織管理者が関与する一度きりのプロセスです。設定が完了すると、アクセス権のあるビルダーはReplitからコネクタを使用できます。

このガイドでは3つの役割にわたる完全なセットアップを説明します：

1. **Databricks管理者**：Databricksでサービスプリンシパルを作成して権限を付与します。
2. **Replit管理者**：Replitでコネクタを設定します。
3. **ビルダー**：Databricksデータを使って構築を開始します。

## 前提条件

開始する前に、以下を確認してください。

**役割**

* [Databricks](https://www.databricks.com/)アカウント管理者またはワークスペース管理者
* [Replit](https://replit.com/)組織管理者

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

<Note>
  このステップを完了するにはDatabricksアカウント管理者またはワークスペース管理者である必要があります。
</Note>

Databricks管理者は、Replitがdatabricksへの接続に使用するマシン間のID（[サービスプリンシパル](https://docs.databricks.com/aws/en/admin/users-groups/service-principals)と呼ばれる）を作成します。

<Steps>
  <Step title="設定を開く">
    Databricksで、右上隅のアバターを選択し、**Settings**を選択します。

    <Frame>
      <img src="https://mintcdn.com/replit/xfCoeTDIPMvB7evM/images/connectors/databricks/settings-menu.png?fit=max&auto=format&n=xfCoeTDIPMvB7evM&q=85&s=4179d36f68585cf88af24ab86d960694" alt="Settingsが選択されているDatabricksワークスペースメニュー" width="3438" height="1984" data-path="images/connectors/databricks/settings-menu.png" />
    </Frame>
  </Step>

  <Step title="IDとアクセスを選択する">
    Settingsサイドバーで**Identity and access**を選択します。

    <Frame>
      <img src="https://mintcdn.com/replit/xfCoeTDIPMvB7evM/images/connectors/databricks/settings-page.png?fit=max&auto=format&n=xfCoeTDIPMvB7evM&q=85&s=8e22324831c8804b135a3b5e550e7f45" alt="サイドバーにIdentity and accessが表示されているDatabricks設定ページ" width="3438" height="1984" data-path="images/connectors/databricks/settings-page.png" />
    </Frame>
  </Step>

  <Step title="サービスプリンシパルを管理する">
    **Management and permissions**の下で**Service principals**を見つけ、**Manage**を選択します。

    <Frame>
      <img src="https://mintcdn.com/replit/xfCoeTDIPMvB7evM/images/connectors/databricks/identity-and-access.png?fit=max&auto=format&n=xfCoeTDIPMvB7evM&q=85&s=4c502716a573596cbe0550644036654d" alt="Service principalsのManageボタンが表示されているIDとアクセス設定ページ" width="3438" height="1984" data-path="images/connectors/databricks/identity-and-access.png" />
    </Frame>
  </Step>

  <Step title="新しいサービスプリンシパルを追加する">
    **Add service principal**を選択し、**Add new**を選択します。

    <Frame>
      <img src="https://mintcdn.com/replit/xfCoeTDIPMvB7evM/images/connectors/databricks/add-service-principal.png?fit=max&auto=format&n=xfCoeTDIPMvB7evM&q=85&s=ca1c2ec068049bd48b2c590d9cae4b3f" alt="Add newボタンのあるサービスプリンシパルの追加ダイアログ" width="3438" height="1984" data-path="images/connectors/databricks/add-service-principal.png" />
    </Frame>
  </Step>

  <Step title="サービスプリンシパルに名前を付ける">
    サービスプリンシパルの明確な名前を入力し、**Add**を選択します。

    <Frame>
      <img src="https://mintcdn.com/replit/xfCoeTDIPMvB7evM/images/connectors/databricks/add-service-principal-name.png?fit=max&auto=format&n=xfCoeTDIPMvB7evM&q=85&s=f2490e64e7bb1516e153f7690da5c9a2" alt="サービスプリンシパル名が入力されたサービスプリンシパルの追加ダイアログ" width="3438" height="1984" data-path="images/connectors/databricks/add-service-principal-name.png" />
    </Frame>
  </Step>

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

    <Frame>
      <img src="https://mintcdn.com/replit/xfCoeTDIPMvB7evM/images/connectors/databricks/service-principal-details.png?fit=max&auto=format&n=xfCoeTDIPMvB7evM&q=85&s=ffdb270b49e7b6a330c3691358b8234b" alt="Databricksサービスプリンシパルの詳細ページ" width="3438" height="1984" data-path="images/connectors/databricks/service-principal-details.png" />
    </Frame>
  </Step>

  <Step title="アクセスを付与する">
    **Permissions**タブを開き、**Grant access**を選択し、サービスプリンシパルを選択して、権限を**Manage**に設定し、**Save**を選択します。

    <Frame>
      <img src="https://mintcdn.com/replit/xfCoeTDIPMvB7evM/images/connectors/databricks/grant-access.png?fit=max&auto=format&n=xfCoeTDIPMvB7evM&q=85&s=ee85ab8f1741b86f830efcd80427a596" alt="Manage権限が選択されたDatabricksサービスプリンシパルのアクセス付与ダイアログ" width="3438" height="1984" data-path="images/connectors/databricks/grant-access.png" />
    </Frame>
  </Step>
</Steps>

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

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

<Steps>
  <Step title="SQLウェアハウスを開く">
    Databricksサイドバーで**SQL Warehouses**を選択します。

    <Frame>
      <img src="https://mintcdn.com/replit/xfCoeTDIPMvB7evM/images/connectors/databricks/sql-warehouses.png?fit=max&auto=format&n=xfCoeTDIPMvB7evM&q=85&s=8610ede28b6a723fd5774fb9e97c7485" alt="利用可能なウェアハウスが表示されているDatabricks SQLウェアハウスページ" width="3438" height="1984" data-path="images/connectors/databricks/sql-warehouses.png" />
    </Frame>
  </Step>

  <Step title="ウェアハウスを選択または作成する">
    Replit Agentに使用させるSQLウェアハウスを選択します。まだウェアハウスがない場合は、**Create SQL warehouse**を選択して新しいウェアハウスを作成します。
  </Step>

  <Step title="接続詳細をコピーする">
    ウェアハウスを開いて**Connection details**を選択します。**Server hostname**と**HTTP path**の値を見つけます。ReplitでDatabricksコネクタを作成する際にこれらの値が必要です。

    <Frame>
      <img src="https://mintcdn.com/replit/xfCoeTDIPMvB7evM/images/connectors/databricks/connection-details.png?fit=max&auto=format&n=xfCoeTDIPMvB7evM&q=85&s=b2e51207eb945f4e9e939caa093c2b23" alt="サーバーホスト名とHTTPパスが表示されているDatabricks SQLウェアハウスの接続詳細ページ" width="3438" height="1984" data-path="images/connectors/databricks/connection-details.png" />
    </Frame>
  </Step>
</Steps>

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

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

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

<Steps>
  <Step title="Integrationsに移動する">
    組織のホームから**Integrations**ページを開きます。**Connectors**の下で\*\*Databricks (Service Principal)\*\*を見つけ、**Sign in**を選択します。

    <Frame>
      <img src="https://mintcdn.com/replit/xfCoeTDIPMvB7evM/images/connectors/databricks/integrations-databricks-signin.png?fit=max&auto=format&n=xfCoeTDIPMvB7evM&q=85&s=f3b1558a4d4afc021fd7b2be96004ea7" alt="DatabricksでフィルタリングされたReplit IntegrationsページにSign inボタン付きのDatabricks (Service Principal)コネクタが表示" width="3436" height="1978" data-path="images/connectors/databricks/integrations-databricks-signin.png" />
    </Frame>
  </Step>

  <Step title="接続を確認する">
    Replitは認証のためにDatabricksにリダイレクトする前に確認ダイアログを表示します。詳細を確認し、**Continue to Databricks**を選択します。

    <Frame>
      <img src="https://mintcdn.com/replit/xfCoeTDIPMvB7evM/images/connectors/databricks/connect-databricks-intro.png?fit=max&auto=format&n=xfCoeTDIPMvB7evM&q=85&s=d1bd23f4bb71d62a555993b106f4596e" alt="OAuthリダイレクト、データ使用、権限を説明するDatabricksの接続ダイアログ" width="3436" height="1978" data-path="images/connectors/databricks/connect-databricks-intro.png" />
    </Frame>
  </Step>

  <Step title="SQLウェアハウスのHTTPパスを入力する">
    DatabricksのSQLウェアハウス接続詳細の**HTTP path**を貼り付け（例：`/sql/1.0/warehouses/abcdef1234567890`）、**Next**を選択します。

    <Frame>
      <img src="https://mintcdn.com/replit/xfCoeTDIPMvB7evM/images/connectors/databricks/connector-http-path.png?fit=max&auto=format&n=xfCoeTDIPMvB7evM&q=85&s=c68fa0868bed7dbd56c46f3be3bbc4b3" alt="SQLウェアハウスのHTTPパスを求めるDatabricks接続ダイアログのステップ1/2" width="3436" height="1978" data-path="images/connectors/databricks/connector-http-path.png" />
    </Frame>
  </Step>

  <Step title="SQLウェアハウスのサーバーホスト名を入力する">
    同じ接続詳細の**Server hostname**を貼り付け（例：`abc-12345678-wxyz.cloud.databricks.com`）、**Continue to Databricks**を選択して認証を完了します。

    <Frame>
      <img src="https://mintcdn.com/replit/xfCoeTDIPMvB7evM/images/connectors/databricks/connector-server-hostname.png?fit=max&auto=format&n=xfCoeTDIPMvB7evM&q=85&s=0b8210206a0941725aa1eb71a2b1d99e" alt="SQLウェアハウスのサーバーホスト名を求めるDatabricks接続ダイアログのステップ2/2" width="3436" height="1978" data-path="images/connectors/databricks/connector-server-hostname.png" />
    </Frame>
  </Step>

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

  <Step title="コネクタがアクティブであることを確認する">
    **Integrations**ページに戻り、**Databricks (Service Principal)**が**Connectors**の下に**Active**接続ステータスで表示されていることを確認します。

    <Frame>
      <img src="https://mintcdn.com/replit/xfCoeTDIPMvB7evM/images/connectors/databricks/integrations-page.png?fit=max&auto=format&n=xfCoeTDIPMvB7evM&q=85&s=f2bb0eac84b4d08e7d7213f5aa5e1a9f" alt="Active接続ステータスのDatabricks (Service Principal)コネクタが表示されているReplit Integrationsページ" width="1680" height="1199" data-path="images/connectors/databricks/integrations-page.png" />
    </Frame>
  </Step>
</Steps>

## ステップ4：Agentで構築する

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

<Steps>
  <Step title="プロジェクトを開始する">
    Replitのホームからプロンプトボックスを開いて新しいプロジェクトを開始します。

    <Frame>
      <img src="https://mintcdn.com/replit/xfCoeTDIPMvB7evM/images/connectors/databricks/home-default.png?fit=max&auto=format&n=xfCoeTDIPMvB7evM&q=85&s=36baeac209507cbe0cb8a0f5a14a7c5d" alt="プロンプトボックスとTemplatesドロップダウンが表示されているReplitホームページ" width="1680" height="1199" data-path="images/connectors/databricks/home-default.png" />
    </Frame>
  </Step>

  <Step title="Databricks Appテンプレートを選択する">
    **Templates**ドロップダウンを開き、**Org templates**の下の**Databricks App**を選択します。プロンプトにはAgentへのDatabricksコネクタの使用方法を伝える指示があらかじめ入力されています。

    <Frame>
      <img src="https://mintcdn.com/replit/xfCoeTDIPMvB7evM/images/connectors/databricks/templates-dropdown.png?fit=max&auto=format&n=xfCoeTDIPMvB7evM&q=85&s=707bf8f7247ef849e1064d33dfa09d3a" alt="Org templatesの下にDatabricks Appテンプレートが表示されているTemplatesドロップダウン" width="1680" height="1199" data-path="images/connectors/databricks/templates-dropdown.png" />
    </Frame>

    事前入力された指示の後に、構築したいものを説明する独自のプロンプトを追加します。インスピレーションについては、[Databricks Dev Hubテンプレート](https://www.databricks.com/devhub/templates)をご覧ください。

    <Frame>
      <img src="https://mintcdn.com/replit/xfCoeTDIPMvB7evM/images/connectors/databricks/agent-prompt-filled.png?fit=max&auto=format&n=xfCoeTDIPMvB7evM&q=85&s=edc9c3d4e326a265ce3a20dfd5d2bc00" alt="Databricks Appテンプレートが選択されて事前入力された指示が表示されているプロンプトボックス" width="1680" height="1199" data-path="images/connectors/databricks/agent-prompt-filled.png" />
    </Frame>
  </Step>

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

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

<AccordionGroup>
  <Accordion title="サービスプリンシパルの作成後に認証に失敗する">
    Replitに入力されたサービスプリンシパルの詳細がDatabricksで作成されたサービスプリンシパルと一致していることを確認します。認証情報がローテーションされた場合は、Replitのコネクタを更新します。
  </Accordion>

  <Accordion title="Agentはスキーマを確認できるがクエリが空の結果を返す">
    サービスプリンシパルにはメタデータアクセス権はあるが、データの読み取り権限がない可能性があります。Databricksで必要なテーブル、スキーマ、またはカタログの権限を付与して再試行してください。
  </Accordion>

  <Accordion title="コネクタがSQLウェアハウスに到達できない">
    **Server hostname**と**HTTP path**の値がDatabricksのSQLウェアハウス接続詳細と一致していることを確認します。
  </Accordion>
</AccordionGroup>

## 関連ドキュメント

* [ウェアハウスコネクタ概要](/connectors/warehouses/overview)：サポートされているすべてのウェアハウスコネクタ。
* [Snowflakeに接続](/connectors/warehouses/snowflake)：Snowflakeのステップバイステップセットアップ。
* [コネクタの管理](/replitai/managing-connectors)：コネクタの管理と設定。
* [Databricksサービスプリンシパル](https://docs.databricks.com/en/admin/users-groups/service-principals.html)：サービスプリンシパルに関するDatabricksドキュメント。
* [Databricks SQLウェアハウス](https://docs.databricks.com/en/compute/sql-warehouse/index.html)：SQLウェアハウスコンピュートに関するDatabricksドキュメント。
