Snowflake 连接器让您可以直接在 Perplexity 中查询 Snowflake 数据仓库中的数据。您可以跨 Snowflake 数据库、其他已连接的应用以及网页搜索并整合信息——无需手动编写 SQL，也无需切换到 Snowflake 控制台。
可在以下平台使用 Perplexity Pro、Perplexity Max、Enterprise Pro，以及 Enterprise Max。连接 Snowflake 是按用户进行的——除非你将数据同步到共享项目，否则组织中的其他任何人都无法查询你的数据。
本指南介绍该连接器的工作方式、如何选择身份验证方法、如何配置角色和只读访问，以及分步设置流程。如果你只想走最快路径：大多数组织应使用 用户 OAuth — 跳转到 设置指南。
启用后，连接器会安全地连接到你的 Snowflake 账户，并允许你搜索你有权查看的数据库、模式、表和视图。当你的 Snowflake 数据发生变化时，连接器会在你下次查询时自动反映这些变化。
支持的数据对象：
表格
视图和物化视图
模式
数据库
结构化数据（由 CSV、JSON 和 Parquet 支持的表格）
不支持非结构化数据（存储在 Snowflake stage 中的图片、音频和视频）。
Snowflake 身份验证有两个独立维度： 谁 查询以（身份）运行，并 如何 该身份通过凭据进行验证。Perplexity 在目录中提供了两个连接器，每个都对应一组推荐的组合：
Snowflake（用户 OAuth） — 每位 Perplexity 用户都使用各自的 Snowflake 账户登录（TYPE = PERSON）通过 OAuth。 适用于大多数组织。
Snowflake — 所有 Perplexity 用户都通过一个共享服务帐户进行查询（TYPE = SERVICE）使用密钥对。对于没有各自 Snowflake 账户的终端用户，请使用此方式。
使用用户 OAuth 后，每个人都会使用自己的凭据进行身份验证，查询会在其原生 Snowflake 权限下运行，并且你可以获得清晰的按用户审计轨迹——无需共享服务账号，也无需在 Perplexity 中重新创建你的基于角色的访问控制（RBAC）。这也与 Snowflake 自身的方向一致：其托管 MCP server 仅支持 OAuth 2.0。
“注意：” 使用 OAuth 时，访问令牌在登录时会绑定到一个主角色——用户的 DEFAULT\_ROLE。为确保用户能够访问其已获授权的所有内容，请配置次要角色（参见 用户 OAuth 角色配置）。
共享服务账户（TYPE = SERVICE + 键对）适用于以下情况：
你的终端用户没有各自的 Snowflake 账户（例如，通过 Perplexity 进行查询但没有直接 Snowflake 访问权限的企业用户）。
您希望所有 Perplexity 查询都以单一共享身份运行，以便更轻松地进行审计。
您正在设置内部或测试环境，在此环境中不需要按用户身份进行识别。
使用专用的、范围受限的角色配置服务账户——请参见 服务账号角色配置。
关于程序访问令牌（PAT）的说明： Snowflake 也支持 PAT 凭据，并且连接器可以接受这些凭据。我们 不 为新配置推荐使用 PAT —— 令牌会按较短周期过期，并且在创建时就硬绑定到单一角色，因此本指南中的所有示例都使用密钥对。如果必须使用 PAT，请设置 ROLE\_RESTRICTION 在创建时分配给您的专属 Perplexity 角色。
OAuth 会话以用户的…开始 DEFAULT\_ROLE 作为主要角色；当前会话内不支持切换角色，且 Perplexity 不会显示角色选择器。因此，无论每位用户已设置了什么 DEFAULT\_ROLE 和 DEFAULT\_SECONDARY\_ROLES 正是他们的 Perplexity 会话所使用的内容。
在安全集成级别一次性设置此项：
OAUTH\_USE\_SECONDARY\_ROLES = IMPLICIT
Snowflake 的 该参数的默认值为 NONE，这意味着 OAuth 会话仅使用主角色处于激活状态。将其设置为 IMPLICIT 会通知 Snowflake 也为每位用户启用其 DEFAULT\_SECONDARY\_ROLES 自动地。没有它，用户只能看到通过他们的 DEFAULT\_ROLE — 这很少是你想要的。
然后处理以下两种情况之一：
情况 A — 用户已经有角色默认设置。 如果你的用户的 DEFAULT\_ROLE 和 DEFAULT\_SECONDARY\_ROLES 如果已经按你的要求设置好了，就无需再做任何操作。IMPLICIT 只需进行设置——每位用户现有的默认设置就是其 Perplexity 会话所使用的设置。
情况 B — 用户尚未设置角色默认值。 通过设置，为每个会话授予该用户所有已授予角色的并集 DEFAULT\_ROLE 至 PUBLIC 和 DEFAULT\_SECONDARY\_ROLES 至 ALL：
ALTER USER \SET DEFAULT\_ROLE = PUBLIC, DEFAULT\_SECONDARY\_ROLES = ('ALL');
“注意：” 自 Snowflake 于 2024 年 8 月的变更以来， DEFAULT\_SECONDARY\_ROLES = ('ALL') 是新创建用户的默认设置，因此许多组织已经将其设为此项。运行 DESC USER \ 在更改任何内容之前先检查。
服务账号是一个专用用户，运行在某个特定角色下——通常 PERPLEXITY\_ROLE。PUBLIC + ('ALL') OAuth 使用的模式 不 在此处应用。相反，请设置服务用户的 DEFAULT\_ROLE 将您分配到专属角色，并仅授予该角色 Perplexity 所需的权限。这遵循 Snowflake 的 服务账号最佳实践。
用于创建此用户的完整 SQL 位于 设置指南。
要限制用户可通过 Perplexity OAuth 集成进行身份验证的 Snowflake 角色，请在安全集成级别进行范围控制：
PRE\_AUTHORIZED\_ROLES\_LIST — 通过此集成允许的角色白名单。
BLOCKED\_ROLES\_LIST — 此集成中被阻止的角色黑名单。
ALTER SECURITY INTEGRATION PERPLEXITY\_OAUTH
SET PRE\_AUTHORIZED\_ROLES\_LIST = ('ANALYST\_ROLE', 'READ\_ONLY\_ROLE');
使用此功能可保留敏感角色（例如 ACCOUNTADMIN）完全移出 OAuth 流程。
连接器通过工具界面执行 SQL（来源于 Merge Snowflake 连接器）。Snowflake（用户 OAuth） 连接器提供细粒度的命名工具——包括一个专用的只读查询工具（execute\_sql\_readonly）只接受 SELECT, WITH, SHOW, DESCRIBE, EXPLAIN, VALUES，以及 LIST，并拒绝 DDL/DML 以及多语句输入。该服务账号 Snowflake 连接器提供一个通用的 execute\_sql 可接受任意 SQL 的工具，包括 DDL 和 DML。
Snowflake RBAC 是权威控制机制。 无论调用哪个工具，查询都会在您配置允许的角色下运行，因此在 Snowflake 角色级别强制只读是可靠的最后防线——也是服务账户连接器的唯一强制边界。
推荐模式——使用专用角色强制只读。 提供诸如以下角色： PERPLEXITY\_READ\_ONLY 仅授予 USAGE 和 SELECT 在你希望 Perplexity 查询的数据库、模式和表上，并且会 不 授权 INSERT, UPDATE, DELETE, CREATE, DROP, OWNERSHIP，或仓库 MODIFY。然后确保用户以该角色进行身份验证：
将其设为用户的 DEFAULT\_ROLE，或
将 OAuth 集成的作用范围限定为 PRE\_AUTHORIZED\_ROLES\_LIST 和/或排除具有写入权限的角色，使用 BLOCKED\_ROLES\_LIST （见 通过 OAuth 限制可使用的角色）。
采用这种方式配置 RBAC 后，Snowflake 会拒绝 Perplexity 的任何写入尝试，无论调用的是哪种工具。
“注意：” 连接器设置包括一个 工具权限 可用工具列表面板。在 Snowflake（用户 OAuth） 连接器，您可以缩小可暴露的工具范围——对于只读设置，请仅启用读取工具（例如 execute\_sql\_readonly, list\_\*, describe\_\*, get\_\*）以将写入/DDL 工具从界面中移除。请将其视为纵深防御，而不是权威边界：真正可靠地强制访问控制的是 Snowflake RBAC（如上）。
连接后，Snowflake 连接器可以代表您执行以下操作：
在你的 Snowflake 数据上执行 SQL 查询
查询 Cortex Search 和 Cortex Analyst
运行自定义 UDF 和存储过程
如果您在 Snowflake 中撤销访问权限或移除角色，这些数据将立即无法从 Perplexity 访问。如果您在 Perplexity 中断开 Snowflake 连接，您可以选择保留或删除任何缓存数据。
对于 Enterprise 组织，Perplexity 提供 SOC 2 Type II 认证、端到端加密、严格的数据隐私措施以及精细的用户访问控制。您的 Snowflake 数据绝不会用于 AI 训练。
连接 Snowflake 是按用户进行的——组织中的其他任何人都无法查询你的数据。不过，如果你将数据同步到共享项目，任何有该项目访问权限的人都可以搜索这些数据。
组织管理员可以从以下位置为所有用户启用或禁用该连接器： 权限 组织设置中的屏幕。读/写强制由 Snowflake 角色级别处理（参见 控制 Perplexity 可执行的操作）。
选择与您的身份验证方式匹配的路径：
用户 OAuth（推荐）： 组织管理员只需配置一次 OAuth 应用，然后用户各自单独登录。直接跳转到 将 Snowflake 连接到 Perplexity — 步骤 1–6 中的 SQL 仅适用于服务账号设置。
服务账号（密钥对）： 按照步骤 1–6 运行 SQL 设置，然后在第 7 步连接。
ACCOUNTADMIN 角色（或具有 CREATE USER 和 GRANT 特权）
已在本地安装 OpenSSL（macOS 预装）— 仅适用于服务账号设置
在终端中生成 RSA 私钥：
openssl genrsa 2048 | openssl pkcs8 -topk8 -inform PEM -out snowflake\_computer\_key.p8 -nocrypt
然后生成对应的公钥：
openssl rsa -in snowflake\_computer\_key.p8 -pubout -out snowflake\_computer\_key.pub
USE ROLE ACCOUNTADMIN;
-- Create a dedicated role
CREATE ROLE IF NOT EXISTS PERPLEXITY\_ROLE
COMMENT = 'Role for Perplexity service account';
-- Create a warehouse (or use an existing one)
CREATE WAREHOUSE IF NOT EXISTS PERPLEXITY\_WAREHOUSE
WAREHOUSE\_SIZE = 'XSMALL'
AUTO\_SUSPEND = 60
AUTO\_RESUME = TRUE
COMMENT = 'Warehouse for Perplexity queries';
-- Grant warehouse usage to the role
GRANT USAGE ON WAREHOUSE PERPLEXITY\_WAREHOUSE TO ROLE PERPLEXITY\_ROLE;
以以下身份运行 ACCOUNTADMIN。替换 RSA\_PUBLIC\_KEY 你的内容中的值 snowflake\_computer\_key.pub 文件（不包括页眉和页脚行）。
USE ROLE ACCOUNTADMIN;
CREATE USER PERPLEXITY\_USER
TYPE = SERVICE
DEFAULT\_ROLE = PERPLEXITY\_ROLE
DEFAULT\_WAREHOUSE = PERPLEXITY\_WAREHOUSE
COMMENT = 'Service account for Perplexity'
RSA\_PUBLIC\_KEY = 'MIIBIjANBgkqhki...your\_public\_key\_here...IDAQAB';
-- Grant the dedicated role to the service account
GRANT ROLE PERPLEXITY\_ROLE TO USER PERPLEXITY\_USER;
“注意：” TYPE = SERVICE 这会将其标记为非人工账户——请不要设置密码。 DEFAULT\_ROLE = PERPLEXITY\_ROLE 将其限定为一个专用角色，仅授予 Perplexity 所需的权限。
-- Grant access to a specific database
GRANT USAGE ON DATABASE MY\_DATABASE TO ROLE PERPLEXITY\_ROLE;
-- Grant access to all schemas in a database (current and future)
GRANT USAGE ON ALL SCHEMAS IN DATABASE MY\_DATABASE TO ROLE PERPLEXITY\_ROLE;
GRANT USAGE ON FUTURE SCHEMAS IN DATABASE MY\_DATABASE TO ROLE PERPLEXITY\_ROLE;
-- Grant read access to all tables and views (current and future)
GRANT SELECT ON ALL TABLES IN DATABASE MY\_DATABASE TO ROLE PERPLEXITY\_ROLE;
GRANT SELECT ON FUTURE TABLES IN DATABASE MY\_DATABASE TO ROLE PERPLEXITY\_ROLE;
GRANT SELECT ON ALL VIEWS IN DATABASE MY\_DATABASE TO ROLE PERPLEXITY\_ROLE;
GRANT SELECT ON FUTURE VIEWS IN DATABASE MY\_DATABASE TO ROLE PERPLEXITY\_ROLE;
如需更有选择性的访问，请参阅 Snowflake GRANT 文档。
Perplexity 在以下两个视图中使用 SNOWFLAKE.ACCOUNT\_USAGE 用于构建 数据图 以实现准确查询生成的 schema：
|
查看 |
用途 |
|
|
查询元数据、性能和使用模式 |
|
|
对象级审计日志（仅限 Enterprise 版） |
USE ROLE ACCOUNTADMIN;
GRANT IMPORTED PRIVILEGES ON DATABASE SNOWFLAKE TO ROLE PERPLEXITY\_ROLE;
“注意：” ACCESS\_HISTORY 仅适用于 Snowflake Enterprise Edition 或更高级别；Perplexity 会回退到 QUERY\_HISTORY 在 Standard Edition 上自动执行。跳过此步骤会降低查询准确性。有关 Perplexity 如何使用这些视图，请参见 了解数据地图。