> ## 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}/).

# 将 Perplexity 与 Databricks 连接

> Databricks Connector 让你可以直接从 Perplexity 查询存储在 Databricks Lakehouse 中的数据。

## 关于 Databricks 连接器

Databricks Connector 让你可以直接从 Perplexity 查询存储在 Databricks Lakehouse 中的数据。它将 Databricks 与 Perplexity 的生产力功能集成在一起，使你无需手动查询或切换上下文，即可即时搜索并整合 Databricks 目录、模式和表中的相关信息。

Databricks Connector 适用于 **Perplexity Pro**, **Perplexity Max**, **Enterprise Pro**，以及 **Enterprise Max** users.

## Databricks 连接器有什么作用？

启用后，Databricks Connector 可让你跨已授权的 Databricks 目录、架构和表进行搜索，并基于这些数据提供答案。该连接器通过 OAuth 使用你的个人 Databricks 身份进行身份验证，这意味着查询会在你的原生 Databricks 权限下运行——无需共享服务帐户。

您可以使用该连接器，在 Unity Catalog 表、Delta Lake 数据和视图之间快速查找信息，而无需手动编写 SQL 或切换到 Databricks 控制台。当您的 Databricks 数据更新后，连接器会在后续查询中自动反映这些更改。

## 受支持的数据对象

Databricks Connector 支持：

<ul>
  <li>
    Unity Catalog 表和视图
  </li>

  <li>
    Delta Lake 表
  </li>

  <li>
    架构和目录
  </li>

  <li>
    在 Unity Catalog 中注册的外部表
  </li>

  <li>
    结构化数据（CSV、JSON、Parquet 支持的表）
  </li>
</ul>

目前不支持非结构化数据（图像、音频、视频以及存储在 Databricks Volumes 中的文件）。

## 身份验证

Databricks Connector 使用 **OAuth（单个用户）** 身份验证。每位 Perplexity 用户都使用自己的 Databricks 凭据连接，查询在该用户原生的 Unity Catalog 权限下运行——不涉及共享服务账户、PAT 或 service principal。

这意味着：

<ul>
  <li>
    数据访问受每位用户现有的 Databricks 权限管理
  </li>

  <li>
    每个查询在 Databricks 中都有清晰的按用户审计追踪记录
  </li>

  <li>
    组织管理员只需配置一次 OAuth 应用；之后各用户使用自己的账户进行身份验证
  </li>
</ul>

**注意：**由于 OAuth 令牌与每个用户的 Databricks 身份绑定，用户只能查询其在 Databricks 中已拥有访问权限的目录、模式和表。连接前请确保已授予适当的 Unity Catalog 权限。

## 控制 Perplexity 在 Databricks 中可以执行的操作

Databricks Connector 通过工具界面执行 SQL（来源于 [合并 Databricks 连接器](https://docs.merge.dev/merge-agent-handler/connectors/databricks)）其中包含一个通用 `execute_sql_statement` 工具。因为 `execute_sql_statement` 接受任意 SQL——包括 DDL 和 DML——的 **限制为只读或以其他方式限制 Perplexity 能执行操作的唯一可靠方法，是在 Unity Catalog 层级进行控制**，而不是在 Perplexity 界面中。

### **推荐做法：通过 Unity Catalog 授权强制只读。**

由于该连接器通过 OAuth 进行按用户身份验证，Perplexity 尝试执行的每个操作都将使用该用户的 Databricks 身份运行，并受其现有 Unity Catalog 权限约束。为保持只读使用，请确保每个用户（或其所属组）仅具有：

<ul>
  <li>
    `USE CATALOG` 在你希望其查询的 catalog 上
  </li>

  <li>
    `USE SCHEMA` 在你希望其查询的 schema 上
  </li>

  <li>
    `SELECT` 在你希望其查询的表和视图上
  </li>
</ul>

并且明确地 **not** hold `MODIFY`, `CREATE`，或 `OWN` 对这些对象没有权限，且 `CAN MANAGE` 在 SQL 仓库上。通过这样配置 Unity Catalog，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 Connector 可以代表您执行以下操作：

<ul>
  <li>
    通过 SQL Warehouses 在 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 数据。不过，如果你将数据同步到共享项目，那么拥有该项目访问权限的任何人都可以搜索这些数据。

组织管理员可以在 **组织设置** 的 [权限](https://www.perplexity.ai/account/org/permissions) 屏幕中为所有用户启用或禁用 Databricks Connector。读/写强制是在 Unity Catalog 级别处理的（参见 [控制 Perplexity 在 Databricks 中可以执行的操作](#h_4a8a4fad1a) 上文）。

## 网络先决条件

> **本节仅适用于 Databricks 工作区使用 IP 访问列表的情况**，或使用了同等入站限制的情况（例如 Azure Databricks 入口策略，或部署在工作区前面的防火墙）。如果您的工作区接受来自任何地址的入站流量，则无需更改网络，可以直接跳到[如何激活它](#h_d4c0ba6ef0)。

Databricks Connector 由 [Merge Agent Handler](https://docs.merge.dev/merge-agent-handler/connectors/databricks) 提供支持，它是 Perplexity 在 Databricks 方面的身份验证和集成合作伙伴。用户点击**使用 Databricks 进行身份验证**时，Databricks 登录页面由用户的浏览器加载，但与您工作区令牌端点（`/oidc/v1/token`）之间的 OAuth 授权码交换由 Merge 在服务器之间完成。完成关联后，Merge 还会将 Perplexity 对 SQL Warehouse 和 Unity Catalog 的 API 调用转发到您的工作区。这些请求来自 Merge 的基础设施，而不是来自用户的网络或 Perplexity 公布的 IP 范围。

如果您的工作区限制入站流量，请在进行管理员设置之前，将以下内容添加到您的[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 Connector 是一个两步流程：管理员为组织一次性配置 OAuth 应用，然后每个用户使用自己的 Databricks 账号进行身份验证。

### 第 1 部分：管理员设置 — 为您的组织配置 Databricks

Databricks 工作区管理员需要完成此步骤一次。单个用户无需重复执行。

在 **组织设置 → 连接器 → Databricks** 中，您将看到一个标题为 **“为你的组织配置 Databricks”** 的三步设置面板：

<ul>
  <li>
    **步骤 1：管理 OAuth 应用** — 点击 **管理 OAuth 应用** 在你的 Databricks 工作区中将 Perplexity 注册为 OAuth 客户端。这将授予 Perplexity 通过 OAuth 针对你的工作区对用户进行身份验证的权限。
  </li>

  <li>
    **步骤 2：通过 Databricks 进行身份验证** — 管理员进行一次身份验证，以确认集成端到端正常工作。
  </li>

  <li>
    **步骤 3：生成数据图（可选）** — 可选地为组织生成一张数据图（参见下方第 3 部分，以及 [了解数据图](https://www.perplexity.ai/help-center/help-center/zh-CN/articles/14017067-liaojie-data-map.md)）并添加补充上下文以提高查询准确性。
  </li>
</ul>

**注意：**完成此步骤需要 Databricks workspace 管理员权限。如果您不确定如何在 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/zh-CN/articles/2026100701-shenme-shi-chajian.md)

### 第 3 部分：生成数据图（可选，但推荐）

完成身份验证后，Perplexity 可以为你的 Databricks 环境生成一张**数据图**。这有助于 Computer 了解你的目录结构，并更准确地回答数据问题。

<ul>
  <li>
    点击 **重新生成数据图** 随时构建或刷新数据图。
  </li>

  <li>
    为获得最佳效果，也请添加 **补充上下文** — 上传文件或添加备注，说明你的数据（例如，关键表代表什么、业务定义、常见查询模式）。这些额外上下文有助于 agent 正确解读你的数据。
  </li>

  <li>
    点击 **查看知识** 查看 Perplexity 了解的有关你的 Databricks 环境的信息。
  </li>
</ul>

跳过数据图会降低复杂数据问题的准确性。我们建议将其作为初始设置的一部分生成。了解更多，请参见 [了解数据图](https://www.perplexity.ai/help-center/help-center/zh-CN/articles/14017067-liaojie-data-map.md).

## 使用 Connected Data

连接后，你可以在中引用你的 Databricks 数据 [Computer](https://www.perplexity.ai/help-center/help-center/zh-CN/articles/13901210-mianxiang-enterprise-de-computer.md) 对话。提及目录、架构或表，Perplexity 就会将它们作为多步工作流的一部分进行查询——全部在安全的云端沙箱中异步执行。

## 试用体验

连接后，尝试运行如下查询：

<ul>
  <li>
    "总结 Q4 销售表中的收入趋势，并突出关键指标"
  </li>

  <li>
    "查找过去 30 天内更新的所有客户记录"
  </li>

  <li>
    "根据分析 schema，哪些产品表现最佳？"
  </li>

  <li>
    "将本季度的 pipeline 数据与上一季度的数据进行比较"
  </li>
</ul>

## 故障排除

### 您的组织未启用 Databricks

组织管理员可能已禁用连接器，或者 OAuth 应用可能尚未配置。请联系您的组织管理员确认，或联系 Perplexity 支持。

### OAuth 应用未配置

如果用户在尝试身份验证时看到错误，管理员 OAuth 应用设置（第 1 部分）可能尚未完成。工作区管理员应返回 **组织设置 → 连接器 → Databricks**，并完成 **管理 OAuth 应用** 步骤。

### 连接后，用户无法访问某些表

Databricks Connector 会尊重每位用户现有的 Unity Catalog 权限。如果用户无法查询其预期可访问的表，请验证相应的 `GRANT` 已在 Unity Catalog 中应用：

<pre>-- 授予对目录的访问权限\
GRANT USE CATALOG ON CATALOG my\_catalog TO `user@example.com`;\
\
\-- 授予对架构的访问权限\
GRANT USE SCHEMA ON SCHEMA my\_catalog.my\_schema TO `user@example.com`;\
\
\-- 授予对表的读取权限\
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 与**组织设置 → 连接器 → Databricks** 中显示的值一致。
  </li>

  <li>
    在对网络或 OAuth 应用进行任何更改后，请用户重新尝试连接。
  </li>
</ul>

如果错误仍然存在，请联系 Perplexity 支持团队，并提供失败尝试的大致时间和工作区 URL，以便我们与集成合作伙伴一起调查交换过程。

### 数据图已过期或不准确

如果 Perplexity 正在就你的 Databricks 数据生成不正确或过时的答案，请尝试在连接器设置中点击**重新生成数据图**。你还可以添加或更新**补充上下文**，为智能体提供有关你数据结构的更好指导。

## 连接和身份验证问题

<ul>
  <li>
    验证 Databricks 工作区中的 OAuth 应用是否已正确配置
  </li>

  <li>
    确认已将 Perplexity 的重定向 URI 添加到 Databricks OAuth 应用设置的允许列表中
  </li>

  <li>
    如果您的工作区使用 IP 访问列表、入口策略或防火墙，请确保[网络先决条件](#h_net_prereqs)中列出的 Merge 和 Perplexity 地址已获得允许
  </li>

  <li>
    在工作区策略发生任何更改后，要求用户重新连接 Databricks Connector
  </li>
</ul>

如果更新这些设置后问题仍然存在，请联系 Perplexity 支持获取帮助。


## Related topics

- [将 Perplexity 与 Snowflake 连接](https://www.perplexity.ai/help-center/help-center/zh-CN/articles/14017006-jiang-perplexity-yu-snowflake-lianjie.md)
- [连接器与集成](https://www.perplexity.ai/help-center/help-center/zh-CN/collections/18799295-连接器与集成.md)
- [了解 Data Map](https://www.perplexity.ai/help-center/help-center/zh-CN/articles/14017067-liaojie-data-map.md)
- [将 Perplexity 与 Linear 连接](https://www.perplexity.ai/help-center/help-center/zh-CN/articles/12167711-适用于企业的-linear-连接器.md)