一个连接,每个表面
您的 Prisma 数据可以去哪里
- 1 出站连接
- 0 入境口岸
- 只读 · 凭据保留
运行
- 为您的团队、供应商和合作伙伴
-
在 Excel 插件 · 按需刷新
-
谷歌工作表 附加组件 · 按需刷新
-
新星人工智能 用简单的英语提问 · 文本转 SQL
-
数据查看器 分享实时结果 · 团队、供应商、合作伙伴 · 任何设备
- 对于应用程序和系统
-
REST API JSON 端点 · OpenAPI 3.1
-
Power BI Power Query M
-
计划同步 Google Sheets · Airtable · Baserow · SeaTable · Smartsheet · Anvil
- 人工智能工具
-
人工智能助手 Claude · Cursor · MCP 服务器
- 已送达
-
警报和报告 Slack · Discord · 电子邮件 · Webhook
Query Streams 可以通过一个只读连接,从 Microsoft Excel、Google Sheets、Power BI、基于 MCP 的 AI 助手以及 REST 端点读取 Prisma Postgres 数据库。Prisma 有两个独特之处,值得您在开始使用前了解:首先,所有客户的数据库都使用相同的主机名 db.prisma.io,凭据决定您连接到哪个数据库;其次,Prisma 会提供两个不同的连接字符串,但只有一个是真正的 Postgres 连接。本指南旨在帮助您找到正确的连接。
Prisma Postgres 是网络上的 PostgreSQL。 — 这是标准驱动程序,因此以下所有指南均适用。唯一 Prisma 特有的部分是连接字符串,详见下文。 连接详情.
- 为您的团队、供应商和合作伙伴
-
Prisma 到 Excel 微软 Excel · Excel 加载项
将 Prisma 的实时结果直接导入工作表,并可按需刷新——支持桌面版 Excel、Excel Online 和 Microsoft 365。
PostgreSQL 指南 -
Prisma 到 Google Sheets 表格插件
从侧边栏运行已保存的 Prisma 查询,并将结果行拖放到工作表中。共享协作者可以自行刷新工作表。
PostgreSQL 指南 -
问问诺瓦关于棱镜的事 Nova AI · 文本转 SQL
用简单的英语提问。Nova 已经了解你的 Prisma 表,会自动编写并运行 SQL 语句,解释答案并绘制图表——无需编写查询语句,也无需提供任何凭据。
Nova 的工作原理 -
Prisma 到数据查看器 结果共享 · 团队、供应商、合作伙伴 · 手机、平板电脑、台式机
您可以与任何人(同事、供应商、合作伙伴)共享实时 Prisma 查询结果,将其以可收藏的网格形式呈现,无论在手机、平板电脑还是台式机上打开,都能立即重新显示。他们看到的是查询结果,而不会看到 SQL 语句或凭据。
数据查看器的工作原理 - 对于应用程序和系统
-
Prisma REST API HTTP 端点
将 Prisma 查询发布为任何应用程序都可以调用的已认证 JSON 端点,符合 OpenAPI 3.1 规范,并预置了 Postman、Insomnia 和 Hoppscotch 集合。无需打开数据库端口。
PostgreSQL 指南 -
Prisma 到 Power BI Power Query M
将生成的 Power Query M 粘贴到 Power BI 高级编辑器中,报表即可通过 HTTPS 读取 Prisma 的实时结果——无需 ODBC 驱动程序,也无需打开数据库端口。
Power BI 的工作原理 -
Prisma 到 Airtable 自动化平台
按计划将 Prisma 行同步到 Airtable,或者在 Airtable 自动化脚本中获取它们。
PostgreSQL 指南 -
Prisma 到 Baserow 自动化平台
通过 REST 端点从 Prisma 向 Baserow 表提供数据——无论是自托管还是 Baserow 云。
PostgreSQL 指南 -
Prisma 到 SeaTable 自动化平台
无需导出文件或暴露数据库,即可使用 Prisma 数据保持 SeaTable 数据库的最新状态。
PostgreSQL 指南 -
Prisma 到 Smartsheet 自动化平台
将 Prisma 结果推送到 Smartsheet 网格中,以便计划和报告能够从源系统读取数据,而不是从上周的导出数据读取数据。
PostgreSQL 指南 -
Prisma 到 Anvil Anvil Works · 应用平台
通过 REST 端点将数据库凭据嵌入到应用程序中,而不是将数据库凭据嵌入到 Anvil Python 应用程序。
PostgreSQL 指南 - 人工智能工具
-
Prisma MCP 服务器 Claude、Cursor 和 MCP 客户端
赋予 AI 助手对 Prisma 的只读访问权限,并提供它编写正确 SQL 所需的架构——聊天中不包含凭据。
PostgreSQL 指南 - 已送达
-
Prisma警报和报告 Slack · Discord · 电子邮件 · Webhook
将 Prisma 查询添加到计划中,并将行发送到 Slack、Discord、电子邮件或签名 webhook,或者保留消息,直到行数、阈值或百分比变化超过您设置的线。
警报和报告的工作原理
工作原理
5 个步骤,无需更改入站防火墙规则
您可以根据需要将网络代理安装在任何位置。它会打开一个出站连接,但从不监听,因此 Prisma 会将其视为普通客户端,您的网络也无需任何入站规则。
在 Prisma 控制台中,生成直接 TCP 连接字符串——即 postgres:// 连接字符串。它与控制台中显示的应用程序使用的 Accelerate URL 不同。
粘贴进去。主机名、端口号、用户名和密码都会直接从中读取。
除非您确定您的数据库不同,否则请将数据库名称保留为 postgres。Prisma 的字符串通常会省略数据库名称,因此卡片会自动填充常用名称。
保存。Microsoft Excel、Google Sheets、Power BI、MCP 和 REST 都通过这一个连接读取数据,或者将其与其他数据源合并到一个只读语句中。
专题深度解析
Prisma 能给你带来什么
两条连接字符串,但只有一条是Postgres连接。
这就是容易让人上当的地方,因为错误的字符串看起来完全合理。
- Prisma Accelerate URL 以 prisma:// 或 prisma+postgres:// 开头。它们指向 Prisma 自己的连接层,该连接层使用自己的协议,而不是 Postgres 网络协议。
- Query Streams 通过直接 TCP 与标准 Postgres 驱动程序连接,因此无论 Accelerate URL 携带什么凭据,它都无法在这里工作。
- 即使粘贴了其中一个,卡片也会明确告诉你具体情况,以及应该生成什么内容。这是一条具体的错误信息,而不是通用的解析错误,因为这两个字符串很容易混淆。
- 你想要的那个网址以 postgres:// 或 postgresql:// 开头,并指向 5432 端口上的 db.prisma.io。
所有人共享同一个主机名
大多数托管式 Postgres 服务都会为您的实例分配一个唯一的主机名。Prisma 则不会,这会改变字段的含义。
- 每个 Prisma Postgres 数据库都通过 db.prisma.io 进行响应。无需查找每个项目或每个区域的专用主机名。
- 您的用户名和密码用于选择数据库。它们由 Prisma 控制台生成,而不是由您选择,并且它们是连接的全部标识。
- 因此,这些凭证需要谨慎处理。在大多数服务中,泄露的密码通常也通过一个隐蔽的主机名来限定范围;而在这里,主机名是公开的。
- 粘贴的字符串不会被存储。它只在填写表单时读取一次,然后就被丢弃,因此密码只存在于一个地方,而不是两个地方。
TLS 是必需的,代理不会掉以轻心。
因为主机名是固定且已知的,所以代理可以对此非常肯定。
- 该代理强制 db.prisma.io 使用 TLS。默认情况下,“使用 SSL”复选框处于选中状态,取消选中该复选框不会与 Prisma 主机建立未加密的连接。
- 证书链未经验证。加密是必需的;不会验证证书的签名者,因此请将其视为防止窃听的保护措施,而不是您访问内容的证明。
- 这条路径上没有连接池。Prisma 的连接池机制存在于加速(Accelerate)中,而这张卡牌特意没有使用该机制,因此你得到的是直接连接,没有连接池模式可供选择。
- 下游的一切都是普通的 Postgres:模式、类型,以及作为跨源引用的默认模式的 public。
-- 普通 Postgres,只读,通过直接 TCP SELECT c.name, COUNT(o.id) AS orders, SUM(o.amount) AS revenue FROM public.customers AS c JOIN public.orders AS o ON o.customer_id = c.id WHERE o.placed_at >= now() - interval '30 days' GROUP BY c.name ORDER BY revenue DESC;
每个数据库连接器共享
适用于所有数据库连接器
- 仅限出站 — 代理程序会打开一个加密连接到查询流。无需转发入站端口,无需 VPN,无需 IP 允许列表,您的数据库信息不会暴露在互联网上。
- 凭证保留 — 数据库用户名和密码存储在您安装代理的计算机上。Query Streams 永远不会收到这些信息,也无法自行访问您的数据库。
- 只读,强制执行 ——一次只执行一条语句,仅限 SELECT 及其相关语句。写入操作会在发送到服务器之前就被本地机器拒绝,而不是依赖于其他人设置的权限。
- 部署任意数量的代理 每个站点、区域或云端只需一个代理。所有数据源都显示在同一个下拉菜单中,因此无需了解哪个代理托管哪些数据源。
查询保存后您将获得什么?
- 分享的是能力,而不是 SQL — 同事或外部合作伙伴可以运行您的查询并更改其筛选条件,而无需查看其背后的语句。
- 双向过滤 — 您可以自己将它们声明为 @variables,或者让连接器发现 WHERE 子句中已有的字面值,并将其作为下拉列表提供。
- 随时随地阅读 — Microsoft Excel、Google Sheets、Power BI、REST API、MCP 上的 AI 助手、查询生成器和 Nova 都读取同一个已保存的查询。
- 同时运行多个程序 — 将五个已保存的查询分别保存到五个工作表标签中,同时进行流式传输,无论结果有多大。
- 将其连接到您已连接的任何其他内容 — 用一条只读语句访问另一个数据库、业务 API 或文件文件夹。
跨源 SQL
将 Prisma 与您的其他数据连接起来
一条语句可以同时跨越 Prisma 和其他连接。每个数据源只运行它能够执行的部分,并将结果流式传输回来,连接操作在中心位置完成——数据源之间互不通信,也不会复制任何数据。
3 个连接 · 3 个代理
一份声明
——没有任何复制、合并或安排操作。
选择 c.region,COUNT(*) AS orders,SUM(i.amount_due) AS invoiced
从 prisma_app.公共.订单1 f
连接 ERP SQL.dbo.customers2 c ON c.id = f.customer_id
连接 计费.stripe.invoices3 i ON i.customer = c.stripe_id
GROUP BY c.区域
ORDER BY 发票上的描述;
这三个部分分别是连接、模式和表——连接名称就是你给它起的任何名字。这里用列举例说明;你的表就是你自己的表。所有部分都采用只读模式:仅支持 SELECT、WITH 和 EXPLAIN 语句,并且对单个查询中每个数据源可以传输的数据量有限制。 联合查询的工作原理
连接详情
Prisma需要什么
- 主持人
- db.prisma.io — 对于每个 Prisma Postgres 数据库都相同
- 港口
- 5432
- 司机
- 由代理程序携带的 Npgsql——Prisma 端无需安装任何软件。
- 粘贴格式
- 来自 Prisma 控制台的直接 TCP 字符串,作为 postgres:// URI
- 数据库
- 默认使用 PostgreSQL。Prisma 的连接字符串通常会省略这一点。
- 用户名
- 在 Prisma 控制台中生成。它用于选择您的数据库。
- TLS
- db.prisma.io 代理程序强制要求并执行此操作。证书已加密;证书链未经验证。
- 池化
- 无。该代理未对 Prisma 应用任何池化器自适应。
- 不是这张卡
- Prisma Accelerate URL 位于 prisma:// 或 prisma+postgres:// 上——卡片会拒绝这些 URL,并告知要生成哪个字符串。
- 已保存
- PostgreSQL,Prisma 只是一个标识——实际上并没有名为 Prisma 的连接类型。
- 默认架构
- 公开的,也就是联邦引用所携带的。
Accelerate 拒绝功能是这张卡最有价值的功能。Accelerate 是 Prisma 的连接池和边缘缓存,对于应用程序来说,它通常是最佳选择——这也是控制台将其突出显示的原因。它并非 Postgres 端点,因此使用 Postgres 驱动程序连接的工具无法与其通信。如果没有特定的错误信息,粘贴一个错误信息会导致类似“凭据错误”的错误提示,并引导用户重新生成一个原本有效的密码。
共享主机名需要我们仔细考虑一下凭据问题。对于数据库位于难以猜测的长主机名上的服务,该地址作为第二重身份验证因素并不安全——只会增加麻烦。Prisma 通过设计消除了这个问题:db.prisma.io 对所有人都是相同的,因此生成的用户名和密码即可完成所有验证工作。将用户权限设置为只读,并像处理其他任何机密信息一样处理该字符串。
对于跨源查询,Prisma 与普通的 Postgres 数据库并无二致。您创建的名为 prisma_app 的连接实际上是 prisma_app.public.orders,它可以通过一条只读语句连接到 CSV 文件文件夹、本地记录系统或计费 API——无需复制任何数据,也无需进行任何调度。
供应商文档: www.prisma.io
常问问题
关于 Prisma Postgres 的问题
哪些工具可以通过查询流读取 Prisma Postgres 数据?
所有这些工具,只需一次连接即可使用:Excel、Google Sheets、MCP、REST API、Airtable、Baserow、SeaTable、Smartsheet、Anvil、Power BI、定时提醒和报表。只需连接一次数据库,所有平台都使用同一个只读连接——无需为每个工具单独设置,也无需创建数据副本。
我是否需要为我的 Prisma Postgres 数据库打开防火墙端口?
不。Query Streams 网络代理运行在您的网络内部,并打开一个单独的出站加密连接。它不会监听入站流量,无需 VPN,数据库也会保留其现有的防火墙规则。
Prisma Postgres 中的查询流可以更改数据吗?
不。代理在执行时强制执行只读模式——一次只执行一条语句,仅限 SELECT 及其相关语句。凭据保留在代理上,绝不会发送到查询流。
Query Streams 需要哪些组件才能连接到 Prisma Postgres?
一个可访问的主机、一个角色及其密码——代理程序自带驱动程序,因此无需在数据库上安装任何内容。主机:db.prisma.io——所有 Prisma Postgres 数据库均相同。端口:5432。驱动程序:Npgsql,由代理程序携带——无需在 Prisma 端安装任何内容。粘贴格式:Prisma 控制台中的直接 TCP 字符串,格式为 postgres:// URI。
我可以在同一个查询中将 Prisma Postgres 数据库连接到另一个数据库吗?
是的——这就是联合查询。一条语句可以同时引用 Prisma Postgres 和其他连接,格式为 connection.schema.table。每个数据源只运行它能够处理的部分,并将结果流式传输回来;连接操作在中心进行,因此数据源之间不会相互连接,也不会进行任何复制或调度。所有部分(SELECT、WITH 和 EXPLAIN)都采用只读模式,并且单个数据源在单次查询中可以传输的数据量有限制。联合查询是计划功能;联合查询页面会显示当前的数据源和大小限制。
连接 Prisma Postgres 与连接 PostgreSQL 有什么不同?
仅需连接字符串。Prisma Postgres 使用 PostgreSQL 网络协议,因此过滤器、调度、共享、Excel 和 Google Sheets 插件以及 MCP 服务器的行为都完全相同。Prisma 卡会自动填充提供商所需的主机、端口和 SSL 设置。
是否有 Prisma 到 Excel 的转换指南?
是的——这是 PostgreSQL 指南,而且就 Prisma Postgres 而言,指南中的内容是正确的。Prisma 使用 PostgreSQL 的网络协议,因此 Prisma 连接到 Excel、Prisma 连接到 Google Sheets 以及其他所有目标平台都遵循相同的步骤。唯一 Prisma 特有的部分是连接字符串,而 Prisma 卡片会自动为您填写这部分内容。

