> ## Documentation Index
> Fetch the complete documentation index at: https://www.perplexity.ai/help-center/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> This content comes from the official Perplexity Help Center. Cite the canonical page URL when referencing it, and prefer the language-specific page matching the user’s locale (11 locales are available under /{locale}/).

# DatabricksとPerplexityの連携

> DatabricksデータウェアハウスをPerplexityと統合し、データベース、スキーマ、テーブル、ビューを横断する即時検索を可能にします。

## Databricksコネクタについて

DatabricksコネクタはDatabricks Lakehouseに保存されたデータをPerplexityから直接クエリできるようにします。DatabricksをPerplexityの生産性機能と統合し、手動クエリやコンテキスト切り替えなしに、Databricksのカタログ、スキーマ、テーブルを横断的に関連情報を即座に検索・統合できます。

Databricksコネクタは **Perplexity Pro**, **Perplexity Max**, **Enterprise Pro**, and **Enterprise Max** ユーザーが利用できます。

## Databricksコネクタでできること

有効化後、DatabricksコネクタはDatabricksの認可済みカタログ、スキーマ、テーブルを横断的に検索し、そのデータに基づく回答を提供します。コネクタはOAuth経由で個人のDatabricksアイデンティティで認証するため、クエリはネイティブのDatabricks権限の下で実行されます — 共有サービスアカウントは不要です。

コネクタを使用すると、手動でSQLを記述したりDatabricksコンソールに切り替えることなく、Unity Catalogテーブル、Delta Lakeデータ、ビューを横断して素早く情報を検索できます。Databricksデータが更新されると、コネクタは次回以降のクエリで変更を自動的に反映します。

## 対応データオブジェクト

Databricksコネクタは以下をサポートしています：

<ul>
  <li>
    Unity Catalogのテーブルとビュー
  </li>

  <li>
    Delta Lakeテーブル
  </li>

  <li>
    スキーマとカタログ
  </li>

  <li>
    Unity Catalogに登録された外部テーブル
  </li>

  <li>
    構造化データ（CSV、JSON、Parquetバックアップテーブル）
  </li>
</ul>

現時点では、非構造化データ（Databricks Volumesに保存された画像、音声、動画、ファイル）はサポートされていません。

## 認証

Databricksコネクタは**OAuth（個人ユーザー）**認証を使用します。各PerplexityユーザーはDatabricksの認証情報で接続し、クエリはそのユーザーのネイティブUnity Catalog権限の下で実行されます — 共有サービスアカウント、PAT、サービスプリンシパルは不要です。

これは以下を意味します：

<ul>
  <li>
    データアクセスは各ユーザーの既存Databricks権限によって管理されます
  </li>

  <li>
    すべてのクエリにはDatabricksでの明確なユーザーごとの監査証跡があります
  </li>

  <li>
    組織管理者がOAuthアプリを一度設定し、個々のユーザーが自分のアカウントで認証します
  </li>
</ul>

**注意：**OAuthトークンは各ユーザーのDatabricksアイデンティティにバインドされているため、ユーザーはDatabricksで既にアクセス権を持つカタログ、スキーマ、テーブルのみクエリできます。接続前に適切なUnity Catalogの権限が設定されていることを確認してください。

## PerplexityがDatabricksで実行できる操作の制御

DatabricksコネクタはSQLを[Merge Databricksコネクタ](https://docs.merge.dev/merge-agent-handler/connectors/databricks)から提供されるツールサーフェス経由で実行し、汎用の`execute_sql_statement`ツールを含みます。`execute_sql_statement`はDDLやDMLを含む任意のSQLを受け付けるため、**Perplexityが実行できる操作を読み取り専用に制限する唯一の信頼できる方法はUnity Catalogレベルでの制御**であり、Perplexity UIではありません。

### **推奨パターン：Unity Catalogの権限で読み取り専用を強制する。**

コネクタはOAuth経由でユーザーごとに認証するため、Perplexityが試みるすべてのアクションはそのユーザーのDatabricksアイデンティティで実行され、既存のUnity Catalog権限に従います。使用を読み取り専用に保つために、各ユーザー（または所属するグループ）に以下のみを付与してください：

<ul>
  <li>
    クエリ対象のカタログへの`USE CATALOG`
  </li>

  <li>
    クエリ対象のスキーマへの`USE SCHEMA`
  </li>

  <li>
    クエリ対象のテーブルとビューへの`SELECT`
  </li>
</ul>

また、明示的にこれらのオブジェクトへの`MODIFY`、`CREATE`、`OWN`、およびSQL Warehouseへの`CAN MANAGE`を**保持しない**ようにしてください。Unity Catalogをこのように設定することで、呼び出されるツールに関わらず、ユーザーが書き込み権限を持たないオブジェクトへのPerplexityの書き込み試行はDatabricksが拒否します。

**注意：**PerplexityはDatabricksコネクタ設定に利用可能なツールを一覧表示する**ツール権限**パネルを表示します。現在、このパネルは読み取り/書き込み/編集の強制的な制限を**提供しません** — 上記のUnity Catalogレベルでのアクセス管理がPerplexityの動作を制御する正しい方法です。

[![](https://mintcdn.com/perplexity-help-center/kBGsQkSG8SPEk_Ye/help-center/assets/img/f8253d3110_image__2863_29.png?fit=max\&auto=format\&n=kBGsQkSG8SPEk_Ye\&q=85\&s=fc0dd6663108d0739bb4ce5c31a5c81b)](https://www.perplexity.ai/help-center/help-center/assets/img/f8253d3110_image__2863_29.png)

## プライバシーとデータセキュリティ

Perplexityに接続すると、Databricksコネクタはあなたの代わりに以下の操作を実行できます：

<ul>
  <li>
    SQL WarehouseでDatabricksデータのSQLクエリを実行
  </li>

  <li>
    Unity Catalogのテーブル、ビュー、スキーマのクエリ
  </li>

  <li>
    Delta Lakeテーブルのメタデータとデータの読み取り
  </li>
</ul>

Databricksでアクセスを取り消すか権限を削除すると、そのデータはすぐにPerplexityからアクセスできなくなります。PerplexityでDatabricksアカウントを切断した場合、キャッシュデータを保持するか削除するかを選択できます。

### エンタープライズグレードのセキュリティと制御

Enterprise組織向けに、PerplexityはSOC 2 Type II認証、エンドツーエンド暗号化、厳格なデータプライバシー対策、きめ細かいユーザーアクセス制御を提供しています。DatabricksデータがAIトレーニングに使用されることはありません。

PerplexityとDatabricksの接続は**個人レベル**で行われます — 組織内の他の誰もDatabricksデータをクエリできません。ただし、共有プロジェクトにデータを同期した場合、そのプロジェクトへのアクセス権を持つ人は誰でも検索できます。

Organization管理者は**Organization設定**の[権限](https://www.perplexity.ai/account/org/permissions)画面から、すべてのユーザーに対してDatabricksコネクタを有効化・無効化できます。読み取り/書き込みの強制はUnity Catalogレベルで処理されます（上記の[PerplexityがDatabricksで実行できる操作の制御](#h_4a8a4fad1a)を参照）。

## ネットワークの前提条件

> **このセクションは、DatabricksワークスペースでIPアクセスリストを使用している場合**、またはそれと同等の受信制限（Azure Databricksのイングレスポリシーやワークスペースの前段にあるファイアウォールなど）を設定している場合にのみ該当します。ワークスペースが任意のアドレスからの受信トラフィックを許可している場合は、ネットワークの変更は不要です。[有効化の方法](#h_d4c0ba6ef0)に進んでください。

Databricksコネクタは、DatabricksにおけるPerplexityの認証・連携パートナーである[Merge Agent Handler](https://docs.merge.dev/merge-agent-handler/connectors/databricks)によって提供されています。ユーザーが**Databricksで認証**をクリックすると、Databricksのログインページはユーザーのブラウザで読み込まれますが、ワークスペースのトークンエンドポイント（`/oidc/v1/token`）とのOAuthコード交換は、Mergeがサーバー間で実行します。連携後は、PerplexityによるSQL WarehouseおよびUnity CatalogのAPI呼び出しも、Mergeがワークスペースに中継します。これらのリクエストは、ユーザーのネットワークやPerplexityが公開しているIP範囲ではなく、Mergeのインフラストラクチャから送信されます。

ワークスペースで受信トラフィックを制限している場合は、管理者設定を行う前に、次のアドレスを[IPアクセスリスト](https://docs.databricks.com/aws/en/security/network/front-end/ip-access-list)（または同等の許可リスト）に追加してください。

<ul>
  <li>
    **Merge Agent Handler（米国テナント）：**`3.216.101.38`と`52.20.242.81`。これらは固定アドレスで、認証時のOAuthトークン交換と、連携後に継続するDatabricks APIトラフィック（SQL WarehouseおよびUnity Catalogの呼び出し）に使用されます。
  </li>

  <li>
    **Perplexity：**[perplexity-user.json](https://www.perplexity.ai/perplexity-user.json)で公開されている送信元IP範囲。Mergeのアドレスとあわせて許可リストに登録したままにしてください。
  </li>
</ul>

> **注：** Mergeのアドレスが許可リストに登録されていない場合、通常はDatabricksのログインページと同意画面は正常に表示されますが、Perplexityが接続を完了しようとした時点で`token_exchange_failed`エラーが発生します。

## 有効化の方法

Databricksコネクタの設定は2段階のプロセスです：管理者がOrganization向けにOAuthアプリを一度設定し、各ユーザーがDatabricksアカウントで個別に認証します。

### パート1：管理者設定 — OrganizationのDatabricksを構成する

Databricksワークスペース管理者がこのステップを一度完了する必要があります。個々のユーザーは繰り返す必要はありません。

**Organization設定 → コネクタ → Databricks**に、**「OrganizationのDatabricksを構成する」**というタイトルの3ステップ設定パネルが表示されます：

<ul>
  <li>
    **ステップ1: OAuthアプリの管理** — **OAuthアプリの管理**をクリックして、DatabricksワークスペースにPerplexityをOAuthクライアントとして登録します。これにより、PerplexityはワークスペースのOAuth経由でユーザーを認証する権限を取得します。
  </li>

  <li>
    **ステップ2: Databricksで認証** — 管理者が一度認証して、統合がエンドツーエンドで機能することを確認します。
  </li>

  <li>
    **ステップ3: データマップの生成（オプション）** — Organizationのデータマップをオプションで生成します（下記パート3と[データマップの理解](https://www.perplexity.ai/help-center/help-center/ja/articles/14017067-データマップについて.md)を参照）。また、補足コンテキストを追加してクエリ精度を向上させます。
  </li>
</ul>

**注意：**このステップを完了するにはDatabricksワークスペース管理者権限が必要です。DatabricksでOAuthアプリを登録する方法が不明な場合は、[Databricks OAuthドキュメント](https://docs.databricks.com/aws/en/integrations/enable-disable-oauth)を参照してください。

### パート2：ユーザー設定 — 認証して接続する

各ユーザーが独立して以下のステップを実行します：

**Step 1**

サイドバーで**プラグイン**（Plugins がまだ表示されない場合は **Customize → Connectors**）を開き、**見つける**または検索で**Databricks**を探して、そのページを開きます。

**Step 2**

**接続**を選択します。

**Step 3**

**Databricksで認証**をクリックします。自分の認証情報でログインするためにDatabricksにリダイレクトされます。

**Step 4**

PerplexityがDatabricksデータにアクセスすることを承認します。

**Step 5**

**許可**をクリックして設定を完了します。

このコネクタはプラグインに含まれることもあります。どこで接続しても、ご自身のアカウントではすべての場所で接続済みになります。接続と組織のコネクタ設定は、すべてのプラグイン内でも適用されます。[プラグインとは](https://www.perplexity.ai/help-center/help-center/ja/articles/2026100701-プラグインとは.md)

### パート3：データマップの生成（オプション、推奨）

認証後、PerplexityはDatabricks環境の**データマップ**を生成できます。これによりComputerはカタログ構造を把握し、データに関する質問により正確に回答できるようになります。

<ul>
  <li>
    いつでも**データマップを再生成**をクリックしてマップを構築または更新できます。
  </li>

  <li>
    最良の結果を得るために、**補足コンテキスト**も追加してください — データを説明するファイルをアップロードしたりメモを追加します（例：主要テーブルの意味、ビジネス定義、一般的なクエリパターン）。この追加コンテキストはエージェントがデータを正しく解釈するのに役立ちます。
  </li>

  <li>
    **ナレッジを表示**をクリックして、PerplexityがDatabricks環境について学習した内容を確認します。
  </li>
</ul>

データマップをスキップすると、複雑なデータの質問に対する精度が低下します。初期設定の一部として生成することをお勧めします。詳しくは[データマップの理解](https://www.perplexity.ai/help-center/help-center/ja/articles/14017067-データマップについて.md)をご覧ください。

## 接続データの利用

接続後、[Computer](https://www.perplexity.ai/help-center/help-center/ja/articles/13901210-エンタープライズ向け-computer.md)でDatabricksのチャットを実行できます。カタログ、スキーマ、テーブルを指定すると、Perplexityはそれらをマルチステップのワークフローの一部としてクエリします — すべてセキュアなクラウドサンドボックスで非同期に実行されます。

## 試してみる

接続後、次のようなクエリを試してください：

<ul>
  <li>
    「Q4セールステーブルの収益トレンドを要約し、主要指標を強調してください」
  </li>

  <li>
    「過去30日間に更新されたすべての顧客レコードを検索してください」
  </li>

  <li>
    「analyticsスキーマに基づいて最もパフォーマンスの高い製品は何ですか？」
  </li>

  <li>
    「今四半期のパイプラインデータを前四半期の数値と比較してください」
  </li>
</ul>

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

### DatabricksがOrganizationで有効になっていない場合

組織管理者がコネクタを無効にしているか、OAuthアプリがまだ設定されていない可能性があります。組織管理者に確認するか、Perplexityサポートにお問い合わせください。

### OAuthアプリが設定されていない場合

ユーザーが認証時にエラーが表示される場合、管理者OAuthアプリの設定（パート1）が完了していない可能性があります。ワークスペース管理者はOrganization設定 → コネクタ → Databricksに戻って**OAuthアプリの管理**ステップを完了してください。

### 接続後にユーザーが特定のテーブルにアクセスできない場合

DatabricksコネクタはユーザーごとのUnity Catalog権限を尊重します。ユーザーがアクセスできるはずのテーブルをクエリできない場合、Unity Catalogで適切な`GRANT`が適用されていることを確認してください：

<pre>-- Grant access to a catalog\
GRANT USE CATALOG ON CATALOG my\_catalog TO `user@example.com`;\
\
\-- Grant access to a schema\
GRANT USE SCHEMA ON SCHEMA my\_catalog.my\_schema TO `user@example.com`;\
\
\-- Grant read access to tables\
GRANT SELECT ON TABLE my\_catalog.my\_schema.my\_table TO `user@example.com`;</pre>

### トークン交換エラーで認証に失敗する

ユーザーがDatabricksのログイン画面と同意画面を完了した後に、接続が`token_exchange_failed`エラーで失敗する場合、Mergeとワークスペースの間のOAuthコード交換が成功していません。Databricksワークスペースの管理者およびネットワークチームと協力して、次の点を確認してください。

<ul>
  <li>
    [ネットワークの前提条件](#h_net_prereqs)に記載されているMergeの送信元アドレスが、ワークスペースを保護しているすべてのIPアクセスリスト、イングレスポリシー、ファイアウォールで許可されていることを確認します。Databricksの管理者は、`system.access.inbound_network`システムテーブルで`/oidc/v1/token`への拒否されたリクエストを確認できます。
  </li>

  <li>
    パート1で登録したOAuthアプリが引き続き有効であり、そのリダイレクトURIが**Organization設定 → コネクタ → Databricks**に表示される値と一致していることを確認します。
  </li>

  <li>
    ネットワークまたはOAuthアプリを変更した後は、ユーザーに接続を再試行してもらいます。
  </li>
</ul>

それでもエラーが解決しない場合は、失敗したおおよその日時とワークスペースのURLを添えてPerplexityサポートにお問い合わせください。連携パートナーとともに交換処理を調査します。

### データマップが古いまたは不正確な場合

PerplexityがDatabricksデータについて不正確または古い回答を生成している場合は、コネクタ設定で**データマップを再生成**してください。また、**補足コンテキスト**を追加・更新して、エージェントにデータ構造についてより良いガイダンスを提供できます。

## 接続と認証の問題

<ul>
  <li>
    DatabricksワークスペースでOAuthアプリが正しく設定されていることを確認する
  </li>

  <li>
    DatabricksのOAuthアプリ設定でPerplexityのリダイレクトURIがホワイトリストに登録されていることを確認する
  </li>

  <li>
    ワークスペースでIPアクセスリスト、イングレスポリシー、またはファイアウォールを使用している場合は、[ネットワークの前提条件](#h_net_prereqs)に記載されているMergeとPerplexityのアドレスが許可されていることを確認します
  </li>

  <li>
    ワークスペースポリシーの変更後にユーザーにDatabricksコネクタの再接続を依頼する
  </li>
</ul>

これらの設定を更新しても問題が解決しない場合は、Perplexityサポートにお問い合わせください。


## Related topics

- [PerplexityとSnowflakeの連携](https://www.perplexity.ai/help-center/help-center/ja/articles/14017006-perplexityとsnowflakeの連携.md)
- [コネクタと連携](https://www.perplexity.ai/help-center/help-center/ja/collections/18799295-コネクタと連携.md)
- [データマップについて](https://www.perplexity.ai/help-center/help-center/ja/articles/14017067-データマップについて.md)
- [Perplexity と Asana の連携](https://www.perplexity.ai/help-center/help-center/ja/articles/12524801-perplexity-と-asana-の連携.md)
