Koyeb标志

无服务器Postgres 支持 PostgreSQL

连接 科耶布 适用于 Excel、Google Sheets、AI 和 REST

Koyeb 无服务器 Postgres 数据库位于 .pg.koyeb.app。这张卡片指出了每个人都会犯的一个错误——粘贴应用程序主机名而不是数据库主机名。

免费开始 13个目的地

一个连接，每个表面

你的 Koyeb 数据可以去哪里

科耶布 现场餐桌 · 只读
联合查询 + 任何其他连接器 · 一条 SQL 跨来源 · 每个计划
网络代理
  • 1 出站连接
  • 0 入境口岸
  • 只读 · 凭据保留

运行

Query Streams 通过一个只读连接，从 Microsoft Excel、Google Sheets、Power BI、AI 助手（通过 MCP）以及 REST 端点读取 Koyeb Postgres 数据库。Koyeb 将应用程序和数据库托管在相邻的主机名上，但其中一个是数据库：应用程序位于 .koyeb.app，Postgres 数据库位于 .pg.koyeb.app。混淆这两个主机名是连接失败的最常见原因，因此该卡片会检查这种混淆，并以清晰易懂的方式提示失败，而不是让连接超时。

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

  1. 为您的团队、供应商和合作伙伴

  2. 科耶布将超越 微软 Excel · Excel 加载项

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

    PostgreSQL 指南

  3. Koyeb 到 Google Sheets 表格插件

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

    PostgreSQL 指南

  4. 问问诺瓦关于科耶布的事 Nova AI · 文本转 SQL

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

    Nova 的工作原理

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

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

    数据查看器的工作原理
  6. 对于应用程序和系统

  7. Koyeb REST API HTTP 端点

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

    PostgreSQL 指南

  8. Koyeb 到 Power BI Power Query M

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

    Power BI 的工作原理

  9. Koyeb 到 Airtable 自动化平台

    按计划将 Koyeb 行同步到 Airtable 数据库，或者在 Airtable 自动化脚本中获取它们。

    PostgreSQL 指南

  10. 科耶布到巴塞罗 自动化平台

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

    PostgreSQL 指南

  11. Koyeb 到 SeaTable 自动化平台

    无需导出文件或公开数据库，即可使用 Koyeb 数据保持 SeaTable 数据库的最新状态。

    PostgreSQL 指南

  12. Koyeb 到 Smartsheet 自动化平台

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

    PostgreSQL 指南

  13. Koyeb 到 Anvil Anvil Works · 应用平台

    通过 REST 端点将 Koyeb 集成到 Anvil Python 应用中，而不是将数据库凭据嵌入到应用中。

    PostgreSQL 指南
  14. 人工智能工具

  15. Koyeb MCP 服务器 Claude、Cursor 和 MCP 客户端

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

    PostgreSQL 指南
  16. 已送达

  17. Koyeb警报和报告 Slack · Discord · 电子邮件 · Webhook

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

    警报和报告的工作原理

工作原理

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

01

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

02

在 Koyeb 控制台中打开数据库的“连接详细信息”选项卡，然后复制该字符串。请从数据库中复制，而不是从应用程序中复制。

03

粘贴进去。主机、端口、用户、密码和数据库信息都会被读取出来，并且主机名会检查是否以 .pg 结尾，以判断它是否是数据库端点。

04

Koyeb 的默认设置已经填写完毕——用户为 koyeb-adm，数据库为 koyebdb——因此，新服务通常只需要密码。

05

保存。Microsoft Excel、Google Sheets、Power BI、MCP 和 REST 都通过这一个连接读取数据，或者将其与其他数据源合并到一个只读语句中。

专题深度解析

科耶布给你什么

应用程序主机名不是数据库主机名。

Koyeb 是一个也运行 Postgres 的应用程序平台，两者仅相隔一个标签。这是一个很容易犯的错误，而且后果很严重，所以卡片会拦截它。

  • 应用程序通过 .koyeb.app 提供服务。数据库通过 .pg.koyeb.app 访问。区别在于中间的 .pg.。
  • 如果粘贴的主机名以 .koyeb.app 结尾，而没有加上 .koyeb.app，卡片会显示相应的解释，阻止你保存一个永远都会超时的连接。
  • 超时是最糟糕的症状，因为它看起来像是防火墙问题。人们会去检查网络规则，而这些规则根本就不是问题所在。
  • 数据库主机名遵循 ep-<name>-<id> 的格式。Koyeb 的 Postgres 数据库基于 Neon，这种格式就源于此。

除此之外，刻意保持普通

这里没有什么高深的机制，假装有只会误导消费者。这张卡的作用就是确保信息准确无误，并且不干扰用户正常使用。

  • 无论复选框的设置如何，所有 .pg.koyeb.app 主机都强制使用 TLS，因此即使剪贴板中丢失了 SSL 模式的字符串仍然会以加密形式传输。流量已加密，但证书链未进行验证。
  • 路径中没有连接池。某些无服务器 Postgres 服务会在前端放置一个事务模式连接池，并且需要预先配置好语句才能处理；Koyeb 不需要，因此代理直接连接并跳过所有这些步骤。
  • koyeb-adm 和 koyebdb 已预先填充，因为这是新建 Koyeb 数据库的初始配置。全新服务通常只需要密码即可。
  • 连接以 PostgreSQL 格式保存，徽章名称保留为 Koyeb。没有名为 Koyeb 的连接类型。 — 这也意味着，您之前建立的与 .pg.koyeb.app 主机的普通 Postgres 连接将立即识别出品牌标识。
-- 普通 Postgres，只读 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

将 Koyeb 添加到您的其他数据中

一条语句可以同时连接 Koyeb 和其他连接。每个数据源只运行它能够处理的部分，并将结果流式传输回来，连接操作在中心进行——数据源之间互不通信，也不会复制任何数据。

3 个连接 · 3 个代理

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

一份声明

——没有任何复制、合并或安排操作。
选择   c.region，COUNT(*) AS orders，SUM(i.amount_due) AS invoiced
从     koyeb_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 语句，并且对单个查询中每个数据源可以传输的数据量有限制。 联合查询的工作原理

连接详情

科耶布需要什么

主持人
ep-<name>-<id>.<region>.pg.koyeb.app — 注意后缀 .pg.，正是它表明这是一个数据库而不是一个应用程序。
港口
5432
司机
由代理程序携带的 Npgsql——Koyeb 端无需安装任何软件。
数据库
koyebdb 正在运行一项新服务，并已预先填写完毕。
用户名
koyeb-adm 正在使用一项新服务，并已预先填写完毕。
TLS
代理程序强制要求每个 .pg.koyeb.app 主机都进行此操作。证书已加密；证书链未经验证。
池化
无 — Koyeb 不需要池化端点，因此代理直接连接。
连接超时
30秒，一次尝试
已保存
PostgreSQL，Koyeb 被保留为一个徽章——实际上并没有名为 Koyeb 的连接类型。
默认架构
公开的，也就是联邦引用所携带的。

有一位验证者持有这张卡片，值得用一个章节而非脚注来解释它为何如此重要。大多数连接错误都会有明显的提示：密码错误是身份验证错误，数据库名称错误则表示数据库不存在。但如果将 Postgres 客户端指向应用程序主机名，则不会出现这些提示。它会导致超时，因为另一端确实存在一个主机，但它根本没有监听 Postgres。超时会被误认为是网络问题，因此人们会去检查防火墙规则，询问平台团队关于出口流量的问题，然后浪费一下午的时间去解决主机名中缺少的 .pg. 后缀。在粘贴操作之前就发现这个问题，其价值远远超过它所需的两行代码。

除了以上这些，这个连接器的其他方面其实都平平无奇，页面上也如实说明了这一点，并没有夸大其词。Koyeb Postgres 基于 Neon，代理通过强制 TLS 使用 Npgsql 与其通信，而且没有使用任何连接池。这就是全部情况，简洁明了的事实胜过冗长的吹捧之词。

对于跨源查询，Koyeb 与普通的 Postgres 数据库并无二致。您创建的名为 koyeb_app 的连接实际上是 koyeb_app.public.orders，它可以通过一条只读语句连接到 CSV 文件文件夹、本地记录系统或计费 API——无需复制任何数据，也无需进行任何调度。

供应商文档： www.koyeb.com

常问问题

关于科耶布的问题

哪些工具可以通过查询流读取 Koyeb 数据？

所有这些工具，只需一次连接即可使用：Excel、Google Sheets、MCP、REST API、Airtable、Baserow、SeaTable、Smartsheet、Anvil、Power BI、定时提醒和报表。只需连接一次数据库，所有平台都使用同一个只读连接——无需为每个工具单独设置，也无需创建数据副本。

我是否需要为我的 Koyeb 数据库打开防火墙端口？

不。Query Streams 网络代理运行在您的网络内部，并打开一个单独的出站加密连接。它不会监听入站流量，无需 VPN，数据库也会保留其现有的防火墙规则。

Koyeb 中的查询流可以更改数据吗？

不。代理在执行时强制执行只读模式——一次只执行一条语句，仅限 SELECT 及其相关语句。凭据保留在代理上，绝不会发送到查询流。

Query Streams 需要通过什么连接到 Koyeb？

一个可访问的主机、一个角色及其密码——代理程序自带驱动程序，因此无需在数据库端安装任何内容。主机：ep-<name>-<id>.<region>.pg.koyeb.app——注意后缀 .pg.，它表明这是一个数据库而非应用程序。端口：5432。驱动程序：Npgsql，由代理程序携带——Koyeb 端无需安装任何内容。数据库：koyebdb，位于一个全新的服务上，并已预先填充数据。

我可以在同一个查询中将 Koyeb 数据库连接到另一个数据库吗？

是的——这就是联合查询。一条语句可以同时引用 Koyeb 和其他连接，格式为 connection.schema.table。每个数据源只运行它能够处理的部分，并将结果流式传输回来；连接操作在中心进行，因此数据源之间不会相互连接，也不会进行任何复制或调度。所有部分（SELECT、WITH 和 EXPLAIN）都采用只读模式，并且单个数据源在单次查询中可以传输的数据量有限制。联合查询是计划功能；联合查询页面会显示当前的数据源和大小限制。

连接 Koyeb 与连接 PostgreSQL 有什么不同？

仅需连接字符串。Koyeb 使用 PostgreSQL 网络协议，因此过滤器、调度、共享、Excel 和 Google Sheets 插件以及 MCP 服务器的行为都完全相同。Koyeb 卡会预先填充提供商所需的主机、端口和 SSL 设置。

有没有从Koyeb到Excel的教程？

是的——这是 PostgreSQL 指南，而且就 Koyeb 而言，指南中的内容是正确的。Koyeb 使用 PostgreSQL 的网络协议，因此 Koyeb 连接到 Excel、Google Sheets 以及其他任何目标平台都遵循相同的步骤。唯一 Koyeb 特有的部分是连接字符串，Koyeb 卡片会为您自动填写这部分。

把科耶布放在工作地点。

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

免费开始 所有连接器

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