一个连接,每个表面
您的 IBM Cloud 数据可以去哪里
- 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 端点读取 IBM Cloud Databases for PostgreSQL 的数据。IBM 与大多数托管 Postgres 服务有两个不同之处:它为每个部署分配一个独立的端口,而不是使用 5432 端口;并且它使用 IBM 自有证书颁发机构颁发的证书来保护数据库。本文将介绍这两项细节,建议您在连接之前了解这些细节,而不是在测试失败之后才去了解。
IBM Cloud Databases for PostgreSQL 是 PostgreSQL 在线版本 — 这是标准驱动程序,因此以下所有指南均适用。唯一与 IBM Cloud 相关的部分是连接字符串,详见下文。 连接详情.
- 为您的团队、供应商和合作伙伴
-
IBM Cloud to Excel 微软 Excel · Excel 加载项
将 IBM Cloud 的实时结果直接导入工作表,并可按需刷新——支持桌面版 Excel、Excel Online 和 Microsoft 365。
PostgreSQL 指南 -
IBM Cloud 到 Google Sheets 表格插件
从侧边栏运行已保存的 IBM Cloud 查询,并将结果行拖放到工作表中。共享协作者可以自行刷新工作表。
PostgreSQL 指南 -
向 Nova 咨询 IBM 云 Nova AI · 文本转 SQL
用简单的英语提问。Nova 已经了解您的 IBM Cloud 表,会自动编写并运行 SQL 语句,解释答案并绘制图表——无需编写查询语句,也无需提供任何凭证。
Nova 的工作原理 -
IBM Cloud to Data Viewer 结果共享 · 团队、供应商、合作伙伴 · 手机、平板电脑、台式机
您可以与任何人(同事、供应商、合作伙伴)共享 IBM Cloud 的实时结果,将其以可收藏的网格形式呈现,无论在手机、平板电脑还是台式机上打开,结果都会立即重新显示。他们看到的是结果,而不是 SQL 语句或凭据。
数据查看器的工作原理 - 对于应用程序和系统
-
IBM Cloud REST API HTTP 端点
将 IBM Cloud 查询发布为任何应用程序都可以调用的已认证 JSON 端点,符合 OpenAPI 3.1 规范,并预置了 Postman、Insomnia 和 Hoppscotch 集合。无需打开数据库端口。
PostgreSQL 指南 -
IBM Cloud 到 Power BI Power Query M
将生成的 Power Query M 粘贴到 Power BI 高级编辑器中,报表即可通过 HTTPS 读取 IBM Cloud 的实时结果——无需 ODBC 驱动程序,也无需打开数据库端口。
Power BI 的工作原理 -
IBM Cloud 到 Airtable 自动化平台
按计划将 IBM Cloud 行同步到 Airtable,或者在 Airtable 自动化脚本中获取它们。
PostgreSQL 指南 -
IBM Cloud 到 Baserow 自动化平台
通过 REST 端点从 IBM Cloud 向 Baserow 表提供数据——无论是自托管还是 Baserow 云。
PostgreSQL 指南 -
IBM Cloud 到 SeaTable 自动化平台
无需导出文件或公开数据库,即可使 SeaTable 数据库与 IBM Cloud 数据保持最新状态。
PostgreSQL 指南 -
IBM Cloud 到 Smartsheet 自动化平台
将 IBM Cloud 的结果推送到 Smartsheet 网格中,以便计划和报告能够从源系统读取数据,而不是从上周的导出数据读取数据。
PostgreSQL 指南 -
IBM Cloud to Anvil Anvil Works · 应用平台
通过 REST 端点将 Anvil Python 应用程序备份到 IBM Cloud,而不是将数据库凭据嵌入到应用程序中。
PostgreSQL 指南 - 人工智能工具
-
IBM Cloud MCP 服务器 Claude、Cursor 和 MCP 客户端
赋予 AI 助手对 IBM Cloud 的只读访问权限,并提供它编写正确 SQL 所需的架构——聊天中不包含任何凭据。
PostgreSQL 指南 - 已送达
-
IBM Cloud 警报和报告 Slack · Discord · 电子邮件 · Webhook
将 IBM Cloud 查询安排到计划中,并将查询结果发送到 Slack、Discord、电子邮件或签名 webhook,或者等到行数、阈值或百分比变化超过您设定的界限时才发送消息。
警报和报告的工作原理
工作原理
5 个步骤,无需更改入站防火墙规则
将网络代理安装在可以访问部署位置的计算机上——如果是私有端点,则安装在您自己的网络中;如果是公共端点,则安装在任何位置。它会打开一个出站连接,但不会监听任何请求。
在 IBM Cloud 中打开服务,然后选择“端点”,并选择“公共”或“私有”选项卡,以匹配代理将如何访问它。
复制 PostgreSQL 连接字符串并将其粘贴到第一个字段中。主机、端口、数据库、用户名和密码将从中读取。
检查端口。IBM 会为每个部署分配一个端口——通常是 30000 多号——这个字段需要确认,而不是想当然,因为 5432 在这里几乎肯定是错误的。
启用 SSL,运行测试并保存。通过该连接,即可从 Microsoft Excel、Google Sheets、Power BI、MCP 或 REST API 读取数据。
专题深度解析
IBM Cloud 能为您带来什么?
每个部署都对应一个端口,而该卡特意将其留空。
这里几乎所有其他 Postgres 卡片都预先填充了 5432 字段,因为几乎所有其他服务都使用它。而这张卡片没有,空字段正是关键所在。
- IBM 会为每个部署分配一个端口,而不是所有程序都运行在同一个标准端口上。同一账户下的两个数据库不会共享同一个端口。
- 因此,该字段初始为空,卡片会明确要求填写。预先填写的 5432 出错的概率远大于正确概率,而且出错后看起来像是网络问题,而不是拼写错误。
- 从与主机名相同的“端点”面板中获取端口号。它位于 IBM 提供的连接字符串中,紧跟在主机名之后。
- 如果保存的连接超时而不是被拒绝,则首先要对照仪表板重新检查端口。
IBM 颁发自己的证书颁发机构,以及代理对此采取的措施。
这是实话实说的部分,而且比通常的TLS段落更具体。
- 连接已加密,并且代理程序会强制执行此操作。无论是否选中 SSL 复选框,IBM Cloud 主机名都需要 TLS 加密。
- 证书链未经验证。IBM 使用其自身颁发的证书进行部署,而代理程序无法获取该颁发机构的证书进行核对。
- IBM 自身的连接字符串通常包含 sslmode=verify-full 参数。该参数不会被读取。 — 代理从字符串中提取主机、端口、数据库、用户名和密码,并应用自己的 TLS 设置,该设置要求加密而不验证链。
- 请将其理解为防止任何人读取传输中的流量,而不是证明哪个服务器响应了请求。如果针对 IBM CA 的链验证对您的合规性至关重要,那么这一点就需要注意。
-- 普通 Postgres,只读,通过 TLS 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
将 IBM Cloud 与您的其他数据连接起来
一条语句可以同时跨越 IBM Cloud 和您的其他连接。每个数据源只运行其能够处理的部分,并将结果流式传输回来,连接操作在中心位置集中完成——数据源之间互不通信,也不会复制任何数据。
3 个连接 · 3 个代理
一份声明
——没有任何复制、合并或安排操作。
选择 c.region,COUNT(*) AS orders,SUM(i.amount_due) AS invoiced
从 ibm_prod.公共.订单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 语句,并且对单个查询中每个数据源可以传输的数据量有限制。 联合查询的工作原理
连接详情
IBM Cloud 需要什么
- 主持人
- 从服务的“端点”面板中获取 <id>.databases.appdomain.cloud。
- 港口
- 每次部署分配,通常为 30000 多个。不是 5432,也不是预先填写的。
- 司机
- Npgsql 由代理程序承载,无需在 IBM 云端安装任何内容。
- 粘贴格式
- 来自 Endpoints 的 PostgreSQL 连接字符串,格式为 postgres:// URI。
- TLS
- IBM Cloud 主机名必须使用此功能。已加密;未经验证 IBM 证书颁发机构,且不能提供自定义 CA。
- 池化
- 无。该代理未对 IBM Cloud 应用任何池化器适配。
- 默认值
- 数据库 ibmclouddb 和用户 admin 已预先填充,与 IBM 创建的内容相匹配。
- 已保存
- PostgreSQL,保留了 IBM Cloud 作为标志。
- 默认架构
- 公开的,也就是联邦引用所携带的。
端口字段为空是一个值得解释的小设计决策,因为它看起来像是一种疏忽。预设值用于预先填充提供商始终以相同方式执行的操作,而 IBM 的端口恰恰不属于此类。如果填充一个看似合理的默认值,则会导致连接验证通过但连接失败,这比填写一个空字段并提示用户进行验证更糟糕。
关于证书:关键在于区分加密和身份验证。代理程序和您的 IBM 部署之间的流量是加密的,传输过程中无法读取。代理程序不会向 IBM 的证书颁发机构验证提供该证书的服务器是否是您指定的服务器。对于大多数通过私有端点进行的报告工作负载而言,这种区别无关紧要;如果您认为这很重要,建议您提前了解,以免在审计过程中才发现。
对于跨源查询,IBM Cloud 就是普通的 Postgres。您创建的名为 ibm_prod 的连接实际上是 ibm_prod.public.orders,它可以通过一条只读语句连接到 CSV 文件文件夹、本地记录系统或计费 API——无需复制任何数据,也无需进行任何调度。
供应商文档: www.ibm.com
常问问题
关于 IBM Cloud Databases for PostgreSQL 的问题
哪些工具可以通过查询流读取 IBM Cloud Databases for PostgreSQL 数据?
所有这些工具,只需一次连接即可使用:Excel、Google Sheets、MCP、REST API、Airtable、Baserow、SeaTable、Smartsheet、Anvil、Power BI、定时提醒和报表。只需连接一次数据库,所有平台都使用同一个只读连接——无需为每个工具单独设置,也无需创建数据副本。
我是否需要为我的 IBM Cloud Databases for PostgreSQL 数据库打开防火墙端口?
不。Query Streams 网络代理运行在您的网络内部,并打开一个单独的出站加密连接。它不会监听入站流量,无需 VPN,数据库也会保留其现有的防火墙规则。
查询流能否更改 IBM Cloud Databases for PostgreSQL 中的数据?
不。代理在执行时强制执行只读模式——一次只执行一条语句,仅限 SELECT 及其相关语句。凭据保留在代理上,绝不会发送到查询流。
Query Streams 需要哪些组件才能连接到 IBM Cloud Databases for PostgreSQL?
可访问的主机、角色及其密码——代理程序自带驱动程序,因此无需在数据库上安装任何内容。主机:<id>.databases.appdomain.cloud,可从服务的“端点”面板获取。端口:根据部署情况分配,通常为 30000 多。不是 5432,且未预先填充。驱动程序:Npgsql,由代理程序携带——无需在 IBM Cloud 端安装任何内容。粘贴格式:从“端点”获取的 PostgreSQL 连接字符串,格式为 postgres:// URI。
我可以在同一个查询中将 IBM Cloud Databases for PostgreSQL 与其他数据库连接起来吗?
是的——这就是联合查询。一条语句可以同时引用 IBM Cloud Databases for PostgreSQL 和其他连接,格式为 connection.schema.table。每个数据源只运行它能够处理的部分,并将结果流式传输回来;连接操作在中心进行,因此数据源之间不会相互连接,也不会进行任何复制或调度。所有部分(SELECT、WITH 和 EXPLAIN)都采用只读模式,并且单个数据源在单次查询中可以传输的数据量有限制。联合查询是一项计划功能;联合查询页面会显示当前的数据源和大小限制。
连接 IBM Cloud Databases for PostgreSQL 与连接 PostgreSQL 有什么不同?
仅需连接字符串。IBM Cloud Databases for PostgreSQL 使用 PostgreSQL 网络协议,因此过滤器、调度、共享、Excel 和 Google Sheets 插件以及 MCP 服务器的行为都完全相同。IBM Cloud 卡会预先填充提供商所需的主机、端口和 SSL 设置。
是否有 IBM Cloud 到 Excel 的指南?
是的——这是 PostgreSQL 指南,而且就 IBM Cloud Databases for PostgreSQL 而言,指南内容完全正确。IBM Cloud 使用 PostgreSQL 通信协议,因此 IBM Cloud 连接到 Excel、IBM Cloud 连接到 Google Sheets 以及其他所有目标平台都遵循相同的步骤。唯一 IBM Cloud 特有的部分是连接字符串,而 IBM Cloud 卡片会自动为您填写这部分内容。

