Prisma Postgres 标志

无服务器Postgres 支持 PostgreSQL

连接 Prisma Postgres 适用于 Excel、Google Sheets、AI 和 REST

Prisma 通过直接 TCP 连接访问 Postgres。所有数据库都使用相同的主机名,因此凭据用于识别您的数据库。

一个连接,每个表面

您的 Prisma 数据可以去哪里

Query Streams 可以通过一个只读连接,从 Microsoft Excel、Google Sheets、Power BI、基于 MCP 的 AI 助手以及 REST 端点读取 Prisma Postgres 数据库。Prisma 有两个独特之处,值得您在开始使用前了解:首先,所有客户的数据库都使用相同的主机名 db.prisma.io,凭据决定您连接到哪个数据库;其次,Prisma 会提供两个不同的连接字符串,但只有一个是真正的 Postgres 连接。本指南旨在帮助您找到正确的连接。

Prisma Postgres 是网络上的 PostgreSQL。 — 这是标准驱动程序,因此以下所有指南均适用。唯一 Prisma 特有的部分是连接字符串,详见下文。 连接详情.

  1. 为您的团队、供应商和合作伙伴
  2. Prisma 到 Excel 微软 Excel · Excel 加载项

    将 Prisma 的实时结果直接导入工作表,并可按需刷新——支持桌面版 Excel、Excel Online 和 Microsoft 365。

    PostgreSQL 指南
  3. Prisma 到 Google Sheets 表格插件

    从侧边栏运行已保存的 Prisma 查询,并将结果行拖放到工作表中。共享协作者可以自行刷新工作表。

    PostgreSQL 指南
  4. 问问诺瓦关于棱镜的事 Nova AI · 文本转 SQL

    用简单的英语提问。Nova 已经了解你的 Prisma 表,会自动编写并运行 SQL 语句,解释答案并绘制图表——无需编写查询语句,也无需提供任何凭据。

    Nova 的工作原理
  5. Prisma 到数据查看器 结果共享 · 团队、供应商、合作伙伴 · 手机、平板电脑、台式机

    您可以与任何人(同事、供应商、合作伙伴)共享实时 Prisma 查询结果,将其以可收藏的网格形式呈现,无论在手机、平板电脑还是台式机上打开,都能立即重新显示。他们看到的是查询结果,而不会看到 SQL 语句或凭据。

    数据查看器的工作原理
  6. 对于应用程序和系统
  7. Prisma REST API HTTP 端点

    将 Prisma 查询发布为任何应用程序都可以调用的已认证 JSON 端点,符合 OpenAPI 3.1 规范,并预置了 Postman、Insomnia 和 Hoppscotch 集合。无需打开数据库端口。

    PostgreSQL 指南
  8. Prisma 到 Power BI Power Query M

    将生成的 Power Query M 粘贴到 Power BI 高级编辑器中,报表即可通过 HTTPS 读取 Prisma 的实时结果——无需 ODBC 驱动程序,也无需打开数据库端口。

    Power BI 的工作原理
  9. Prisma 到 Airtable 自动化平台

    按计划将 Prisma 行同步到 Airtable,或者在 Airtable 自动化脚本中获取它们。

    PostgreSQL 指南
  10. Prisma 到 Baserow 自动化平台

    通过 REST 端点从 Prisma 向 Baserow 表提供数据——无论是自托管还是 Baserow 云。

    PostgreSQL 指南
  11. Prisma 到 SeaTable 自动化平台

    无需导出文件或暴露数据库,即可使用 Prisma 数据保持 SeaTable 数据库的最新状态。

    PostgreSQL 指南
  12. Prisma 到 Smartsheet 自动化平台

    将 Prisma 结果推送到 Smartsheet 网格中,以便计划和报告能够从源系统读取数据,而不是从上周的导出数据读取数据。

    PostgreSQL 指南
  13. Prisma 到 Anvil Anvil Works · 应用平台

    通过 REST 端点将数据库凭据嵌入到应用程序中,而不是将数据库凭据嵌入到 Anvil Python 应用程序。

    PostgreSQL 指南
  14. 人工智能工具
  15. Prisma MCP 服务器 Claude、Cursor 和 MCP 客户端

    赋予 AI 助手对 Prisma 的只读访问权限,并提供它编写正确 SQL 所需的架构——聊天中不包含凭据。

    PostgreSQL 指南
  16. 已送达
  17. Prisma警报和报告 Slack · Discord · 电子邮件 · Webhook

    将 Prisma 查询添加到计划中,并将行发送到 Slack、Discord、电子邮件或签名 webhook,或者保留消息,直到行数、阈值或百分比变化超过您设置的线。

    警报和报告的工作原理

工作原理

5 个步骤,无需更改入站防火墙规则

01

您可以根据需要将网络代理安装在任何位置。它会打开一个出站连接,但从不监听,因此 Prisma 会将其视为普通客户端,您的网络也无需任何入站规则。

02

在 Prisma 控制台中,生成直接 TCP 连接字符串——即 postgres:// 连接字符串。它与控制台中显示的应用程序使用的 Accelerate URL 不同。

03

粘贴进去。主机名、端口号、用户名和密码都会直接从中读取。

04

除非您确定您的数据库不同,否则请将数据库名称保留为 postgres。Prisma 的字符串通常会省略数据库名称,因此卡片会自动填充常用名称。

05

保存。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 个代理

Prisma Postgres 无服务器Postgres
微软 SQL 服务器 关系引擎
条纹 付款与账单

一份声明

——没有任何复制、合并或安排操作。
选择   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 卡片会自动为您填写这部分内容。

将 Prisma 部署到工作发生的地方

安装代理,将其指向您的数据库,然后选择目标位置。

只读 仅限出站 凭证保留在代理人身上。