> ## 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 连接

> 了解如何将 Perplexity 与 Databricks 连接。

<h2 id="h_9fdf214577">关于 Databricks 连接器</h2>

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

<p>Databricks Connector 适用于 <b>Perplexity Pro</b>, <b>Perplexity Max</b>, <b>Enterprise Pro</b>，以及 <b>Enterprise Max</b> users.</p>

<h2 id="h_de83e708d8">Databricks 连接器有什么作用？</h2>

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

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

<h2 id="h_3bdac85b8e">受支持的数据对象</h2>

<p>Databricks Connector 支持：</p>

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

  <li>
    <p>Delta Lake 表</p>
  </li>

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

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

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

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

<h2 id="h_97357b500f">身份验证</h2>

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

<p>这意味着：</p>

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

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

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

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

<h2 id="h_4a8a4fad1a">控制 Perplexity 在 Databricks 中可以执行的操作</h2>

<p>Databricks Connector 通过工具界面执行 SQL（来源于 <a href="https://docs.merge.dev/merge-agent-handler/connectors/databricks" rel="nofollow noopener noreferrer" target="_blank">合并 Databricks 连接器</a>）其中包含一个通用 <code>execute\_sql\_statement</code> 工具。因为 <code>execute\_sql\_statement</code> 接受任意 SQL——包括 DDL 和 DML——的 <b>限制为只读或以其他方式限制 Perplexity 能执行操作的唯一可靠方法，是在 Unity Catalog 层级进行控制</b>，而不是在 Perplexity 界面中。</p>

<h3 id="h_61919d4fec"><b>推荐做法：通过 Unity Catalog 授权强制只读。</b></h3>

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

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

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

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

<p>并且明确地 <b>not</b> hold <code>MODIFY</code>, <code>CREATE</code>，或 <code>OWN</code> 对这些对象没有权限，且 <code>CAN MANAGE</code> 在 SQL 仓库上。通过这样配置 Unity Catalog，Databricks 会拒绝 Perplexity 尝试对用户没有写入权限的对象执行的任何写入操作，而不管调用了哪个工具。</p>

<p><b>注意：</b>Databricks 连接器设置中会显示一个列出可用工具的 <b>工具权限</b> 面板。目前，此面板 <b>并不能</b> 提供可靠的读/写/编辑强制执行——在 Unity Catalog 层级（上文）进行权限治理，才是控制 Perplexity 可执行操作的正确方式。</p>

<Frame>
  <a href="/help-center/help-center/assets/img/f8253d3110_image__2863_29.png" rel="noreferrer nofollow noopener" target="_blank">
    <img alt="" height="1080" src="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" width="1337" data-path="help-center/assets/img/f8253d3110_image__2863_29.png" />
  </a>
</Frame>

<h2 id="h_38bba94835">隐私和数据安全</h2>

<p>连接到 Perplexity 后，Databricks Connector 可以代表您执行以下操作：</p>

<ul>
  <li>
    <p>通过 SQL Warehouses 在 Databricks 数据上执行 SQL 查询</p>
  </li>

  <li>
    <p>查询 Unity Catalog 表、视图和架构</p>
  </li>

  <li>
    <p>读取 Delta Lake 表元数据和数据</p>
  </li>
</ul>

<p>如果您撤销访问权限或移除 Databricks 中的权限，该数据将立即无法从 Perplexity 访问。如果您在 Perplexity 中断开 Databricks 帐户连接，您可以选择保留或删除任何缓存数据。</p>

<h3 id="h_0de15062d8">企业级安全与控制</h3>

<p>对于 Enterprise 组织，Perplexity 提供 SOC 2 Type II 认证、端到端加密、严格的数据隐私措施以及细粒度的用户访问控制。您的 Databricks 数据绝不会用于 AI 训练。</p>

<p>将 Perplexity 连接到 Databricks 的操作在 <b>个人级别</b> — 你组织中的其他任何人都无法查询你的 Databricks 数据。不过，如果你将数据同步到共享项目，那么拥有该项目访问权限的任何人都可以搜索这些数据。</p>

<p>组织管理员可以在 <b>组织设置</b> 的 <a href="https://www.perplexity.ai/account/org/permissions" rel="nofollow noopener noreferrer" target="_blank">权限</a> 屏幕中为所有用户启用或禁用 Databricks Connector。读/写强制是在 Unity Catalog 级别处理的（参见 <a href="#h_4a8a4fad1a">控制 Perplexity 在 Databricks 中可以执行的操作</a> 上文）。</p>

<h2 id="h_d4c0ba6ef0">如何激活它</h2>

<p>设置 Databricks Connector 是一个两步流程：管理员为组织一次性配置 OAuth 应用，然后每个用户使用自己的 Databricks 账号进行身份验证。</p>

<h3 id="h_9699718b8e">第 1 部分：管理员设置 — 为您的组织配置 Databricks</h3>

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

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

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

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

  <li>
    <p><b>步骤 3：生成数据映射（可选）</b> — 可选地为组织生成一张数据映射图（参见下方第 3 部分，以及 <a href="https://www.notion.so/Understanding-the-Data-Map-31f6172b229b817eab63d72703a23efb?pvs=21" rel="nofollow noopener noreferrer" target="_blank">了解数据映射</a>）并添加补充上下文以提高查询准确性。</p>
  </li>
</ul>

<p><b>注意：</b>完成此步骤需要 Databricks workspace 管理员权限。如果您不确定如何在 Databricks 中注册 OAuth 应用，请参阅 <a href="https://docs.databricks.com/aws/en/integrations/enable-disable-oauth" rel="nofollow noopener noreferrer" target="_blank">Databricks OAuth 文档</a>。</p>

<h3 id="h_57b32014db">第 2 部分：用户设置 — 进行身份验证并连接</h3>

<p>每位用户独立完成以下步骤：</p>

<Steps>
  <Step>
    <p>前往 <b>设置</b> 中的 <b>连接器</b>，找到 <b>Databricks Connector</b>。</p>
  </Step>

  <Step>
    <p>点击 <b>启用</b> → <b>添加连接器</b>。</p>
  </Step>

  <Step>
    <p>点击 <b>使用 Databricks 进行身份验证</b>。您将被重定向到 Databricks，以使用您自己的凭据登录。</p>
  </Step>

  <Step>
    <p>授权 Perplexity 访问您的 Databricks 数据。</p>
  </Step>

  <Step>
    <p>点击 <b>允许</b> 完成设置。</p>
  </Step>
</Steps>

<h3 id="h_f8dbc73afe">第 3 部分：生成数据地图（可选，但推荐）</h3>

<p>完成身份验证后，Perplexity 可以生成一个 <b>数据映射</b> 的 Databricks 环境。这有助于 Computer 了解你的目录结构，并更准确地回答数据问题。</p>

<ul>
  <li>
    <p>点击 <b>重新生成数据映射</b> 随时构建或刷新地图。</p>
  </li>

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

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

<p>跳过数据映射会降低复杂数据问题的准确性。我们建议将其作为初始设置的一部分生成。了解更多，请参见 <a href="https://www.notion.so/Understanding-the-Data-Map-31f6172b229b817eab63d72703a23efb?pvs=21" rel="nofollow noopener noreferrer" target="_blank">了解数据映射</a>.</p>

<h2 id="h_90cb062c2d">使用 Connected Data</h2>

<p>连接后，你可以在中引用你的 Databricks 数据 <a href="/help-center/help-center/zh-CN/articles/13901210-mianxiang-enterprise-de-computer">Computer</a> 对话。提及目录、架构或表，Perplexity 就会将它们作为多步工作流的一部分进行查询——全部在安全的云端沙箱中异步执行。</p>

<h2 id="h_8085e2db43">试用体验</h2>

<p>连接后，尝试运行如下查询：</p>

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

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

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

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

<h2 id="h_077a84461e">故障排除</h2>

<h3 id="h_44e12ccb92">您的组织未启用 Databricks</h3>

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

<h3 id="h_040f6f5bd0">OAuth 应用未配置</h3>

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

<h3 id="h_9e728cb8e0">连接后，用户无法访问某些表</h3>

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

<pre>-- 授予对目录的访问权限<br />GRANT USE CATALOG ON CATALOG my\_catalog TO `user@example.com`;<br /><br />-- 授予对架构的访问权限<br />GRANT USE SCHEMA ON SCHEMA my\_catalog.my\_schema TO `user@example.com`;<br /><br />-- 授予对表的读取权限<br />GRANT SELECT ON TABLE my\_catalog.my\_schema.my\_table TO `user@example.com`;</pre>

<h3 id="h_35144f7c87">数据映射已过期或不准确</h3>

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

<h2 id="h_4dedc48e59">连接和身份验证问题</h2>

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

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

  <li>
    <p>如果您的工作区使用 IP 访问列表，请确保将 Perplexity 的 IP 加入允许列表</p>
  </li>

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

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


## Related topics

- [连接器与集成](/help-center/help-center/zh-CN/collections/18799295-连接器与集成.md)
- [将 Perplexity 与 Confluence 连接](/help-center/help-center/zh-CN/articles/12524852-jiang-perplexity-yu-confluence-lian-jie.md)
- [将 Perplexity 与 Notion 连接](/help-center/help-center/zh-CN/articles/12167654-jiang-perplexity-yu-notion-lianjie.md)
- [将 Perplexity 与 Linear 连接](/help-center/help-center/zh-CN/articles/12167711-适用于企业的-linear-连接器.md)
- [将 Perplexity 与 Asana 连接](/help-center/help-center/zh-CN/articles/12524801-jiang-perplexity-yu-asana-lianjie.md)
