一个连接,每个表面
您的 Cloud SQL 数据可以放在哪里?
- 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、AI 助手(通过 MCP)和 REST 端点读取 Google Cloud SQL。一张卡即可支持 PostgreSQL、MySQL 和 SQL Server。网络代理运行在 VPC 内的虚拟机上,并通过实例的私有 IP 地址进行连接,仅向外拨号——因此实例无需公网 IP 地址,也无需任何授权网络条目。
Google Cloud SQL 实际上是 PostgreSQL / MySQL / Microsoft SQL Server 的网络版。 — 这是标准驱动程序,因此以下所有指南均适用。唯一与 Cloud SQL 相关的部分是连接字符串,详见下文。 连接详情.
- 为您的团队、供应商和合作伙伴
-
Cloud SQL 到 Excel 微软 Excel · Excel 加载项
将实时 Cloud SQL 结果直接提取到工作表中,并按需刷新——支持桌面版 Excel、Excel Online 和 Microsoft 365。
PostgreSQL 指南 -
Cloud SQL 到 Google Sheets 表格插件
从侧边栏运行已保存的 Cloud SQL 查询,并将结果行拖放到工作表中。共享协作者可以自行刷新工作表。
PostgreSQL 指南 -
向 Nova 咨询 Cloud SQL Nova AI · 文本转 SQL
用简单的英语提问。Nova 已经了解您的 Cloud SQL 表,会自动编写并运行 SQL 语句,解释答案并绘制图表——无需编写查询语句,也无需提供任何凭据。
Nova 的工作原理 -
Cloud SQL 到数据查看器 结果共享 · 团队、供应商、合作伙伴 · 手机、平板电脑、台式机
您可以与任何人(同事、供应商、合作伙伴)共享实时 Cloud SQL 查询结果,以可收藏的网格形式呈现,无论在手机、平板电脑还是台式机上打开,都会自动重新加载。他们看到的是查询结果,而不会看到 SQL 代码或凭据。
数据查看器的工作原理 - 对于应用程序和系统
-
Cloud SQL REST API HTTP 端点
将 Cloud SQL 查询发布为任何应用程序都可以调用的已认证 JSON 端点,符合 OpenAPI 3.1 规范,并预置了 Postman、Insomnia 和 Hoppscotch 集合。无需打开数据库端口。
PostgreSQL 指南 -
Cloud SQL 到 Power BI Power Query M
将生成的 Power Query M 粘贴到 Power BI 高级编辑器中,报表即可通过 HTTPS 读取实时 Cloud SQL 结果——无需 ODBC 驱动程序,也无需打开数据库端口。
Power BI 的工作原理 -
Cloud SQL 到 Airtable 自动化平台
按计划将 Cloud SQL 行同步到 Airtable,或者在 Airtable 自动化脚本中获取它们。
PostgreSQL 指南 -
Cloud SQL 到 Baserow 自动化平台
通过 REST 端点从 Cloud SQL 向 Baserow 表提供数据——无论是自托管还是 Baserow 云。
PostgreSQL 指南 -
Cloud SQL 到 SeaTable 自动化平台
无需导出文件或公开数据库,即可使用 Cloud SQL 数据保持 SeaTable 数据库的最新状态。
PostgreSQL 指南 -
Cloud SQL 到 Smartsheet 自动化平台
将 Cloud SQL 结果推送到 Smartsheet 网格中,以便计划和报告从源系统读取数据,而不是从上周的导出数据读取数据。
PostgreSQL 指南 -
Cloud SQL 到 Anvil Anvil Works · 应用平台
通过 REST 端点将数据库凭据嵌入到 Anvil Python 应用程序中,而不是将数据库凭据嵌入到应用程序中。
PostgreSQL 指南 - 人工智能工具
-
Cloud SQL MCP 服务器 Claude、Cursor 和 MCP 客户端
赋予 AI 助手对 Cloud SQL 的只读访问权限,并提供它编写正确 SQL 所需的架构——聊天中无需提供凭据。
PostgreSQL 指南 - 已送达
-
Cloud SQL 警报和报告 Slack · Discord · 电子邮件 · Webhook
将 Cloud SQL 查询设置为定时执行,并将查询结果发送到 Slack、Discord、电子邮件或签名 webhook,或者等到行数、阈值或百分比变化超过您设定的阈值时才发送消息。
警报和报告的工作原理
工作原理
5 个步骤,无需更改入站防火墙规则
在 Google Cloud VPC 内的虚拟机上安装网络代理。它只建立出站连接,因此该实例可以关闭其公网 IP 地址并清空其授权网络。
选择数据库引擎——PostgreSQL、MySQL 或 SQL Server。表单的其余部分将根据您选择的引擎而定。
请提供实例的私有 IP 地址。如果您已经通过公有 IP 地址访问该实例,则可以使用公有 IP 地址;如果您通过 Cloud SQL 身份验证代理访问,则可以使用 127.0.0.1。
添加一个数据库用户,并赋予其对要读取的内容的 SELECT 权限,以及数据库名称。
保存。Microsoft Excel、Google Sheets、Power BI、MCP 和 REST 都可以通过同一个连接读取该实例,或者在单个语句中将其与其他数据源连接起来。
专题深度解析
Cloud SQL 能为您带来什么?
私有 IP 是推荐方案,也是最简单的方案。
通常,将这些数据传输到任何地方的难点在于 Cloud SQL 的连接性。但如果读取数据的进程已经位于 VPC 内部,那么连接性就变得不再是问题了。
- 该代理仅建立出站连接,因此将其放在 VPC 中的虚拟机上不需要任何类型的入口规则。
- 该实例不保留任何公网 IP 地址,且授权网络列表为空。 — 办公室地址变更时无需更新任何内容。
- 由于没有主机名可供指向,Cloud SQL 通过 IP 地址进行寻址。这是该服务的特性,而非此处所指的限制。
- 如果您目前使用的是公网 IP 地址,那么它仍然有效。代理商并不在意 IP 地址位于边界的哪一侧。
已理解身份验证代理
许多团队通过 Cloud SQL 身份验证代理而不是直接通过 IP 地址访问 Cloud SQL,而该卡会注意到您是这样做的。
- 输入 127.0.0.1 或 localhost 会被识别为代理,卡片会显示相关信息,而不是让你猜测是否支持。
- 代理会对隧道本身进行加密,因此该路径的 SSL 选项应该关闭。 — 此卡会在 SSL 错误可能让你感到困惑的地方告诉你这一点。
- 对于直接 IP 连接,应该启用 SSL 选项,并且默认情况下是启用的。
- 代理是您需要运行和管理的进程;代理本身不包含任何相关功能。
三台引擎,以及防止选错引擎的保护装置
多引擎网卡容易出现一种特定错误:粘贴了与所选引擎不同的引擎的端口号。这种组合在连接时会失败,而且没有任何有用的信息,因此会在表单中被捕获。
- PostgreSQL 端口 5432,MySQL 端口 3306,SQL Server 端口 1433 — 已预先填充您选择的发动机所需的燃料。
- 输入 3306 并选择 PostgreSQL,但该卡会告诉你该端口属于 MySQL,并要求你检查引擎,而不是直接传递。
- 密码开头或结尾带有空格也会被标记出来,因为它几乎总是剪贴板的痕迹,并且会被视为不透明的身份验证错误。
- 无论您选择哪个引擎,连接都会以该引擎的名称保存。 — Cloud SQL 保留为卡片上的徽章,而不是连接类型。
-- 无论实例运行哪个引擎,读取结果都相同 SELECT c.name, COUNT(o.id) AS orders, SUM(o.amount) AS revenue FROM customers AS c JOIN orders AS o ON o.customer_id = c.id 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
将 Cloud SQL 与您的其余数据连接起来
一条语句可以同时跨越 Cloud SQL 和其他连接。每个数据源只运行它能够执行的部分,并将结果流式传输回来,连接操作则在中心位置集中完成——各个数据源之间互不通信,也不会复制任何数据。
3 个连接 · 3 个代理
一份声明
——没有任何复制、合并或安排操作。
选择 c.region,COUNT(*) AS orders,SUM(i.amount_due) AS invoiced
从 gcp_sales.公共.订单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 语句,并且对单个查询中每个数据源可以传输的数据量有限制。 联合查询的工作原理
连接详情
Cloud SQL 需要什么
- 发动机
- 一张卡即可支持 PostgreSQL、MySQL 和 SQL Server。
- 地址
- 实例的私有或公共 IP 地址,或者通过 Cloud SQL 身份验证代理访问 127.0.0.1——Cloud SQL 没有主机名可供指向。
- 港口
- 5432 个 PostgreSQL、3306 个 MySQL、1433 个 SQL Server——已预先填充每个引擎的数据,并与您选择的引擎进行交叉核对。
- TLS
- 默认情况下,直接 IP 连接启用此功能;通过认证代理时,禁用此功能才是正确的,因为认证代理会加密其自身的隧道。
- 已保存
- 您选择的引擎,其中 Cloud SQL 仅作为标识保留——实际上并没有名为 Cloud SQL 的连接类型。
- 认出
- 由于没有主机名,徽章信息来源于此卡上创建的连接;之前与同一实例建立的普通连接不会追溯显示该徽章。
- 权限
- 拥有对目标数据库进行 SELECT 操作的用户
- 网络
- 仅允许代理程序出站访问。无公网 IP 地址、无授权网络条目、无入站规则。
Cloud SQL 是该系列托管服务中唯一一个无需进行任何嗅探的。其他所有托管服务提供商都会提供一个带有可识别后缀的主机名;而 Cloud SQL 则提供一个 IP 地址,如果您使用身份验证代理,则会提供一个回环地址。这带来了一个值得明确说明的后果:Cloud SQL 的标识来源于您在此卡上创建的连接,因此,如果您之前使用普通的 PostgreSQL 连接到同一实例,它仍然会显示为普通的 PostgreSQL 连接。两种方式的工作方式完全相同——只是标识不同。
即使可以选择公网 IP,私有 IP 路径仍然值得采用。在 VPC 内的虚拟机上运行代理程序,就能彻底解决连接问题:实例上无需公网 IP,无需维护授权网络,无需设置入口规则,也无需任何人手动更新静态地址。代理程序会自动拨号连接;Cloud SQL 也无需处于可查找状态。
对于跨源查询,限定符位于引擎之后,因为连接就是以引擎名称保存的。例如,您在 Cloud SQL 中创建的名为 gcp_sales 的 PostgreSQL 连接,其格式为 gcp_sales.public.orders;而在 SQL Server 上,同一实例的格式为 gcp_sales.dbo.orders——只需一条只读语句,即可连接到 CSV 文件文件夹、本地记录系统或计费 API。
供应商文档: cloud.google.com
常问问题
关于 Google Cloud SQL 的问题
哪些工具可以通过查询流读取 Google Cloud SQL 数据?
所有这些工具,只需一次连接即可使用:Excel、Google Sheets、MCP、REST API、Airtable、Baserow、SeaTable、Smartsheet、Anvil、Power BI、定时提醒和报表。只需连接一次数据库,所有平台都使用同一个只读连接——无需为每个工具单独设置,也无需创建数据副本。
我是否需要为我的 Google Cloud SQL 数据库打开防火墙端口?
不。Query Streams 网络代理运行在您的网络内部,并打开一个单独的出站加密连接。它不会监听入站流量,无需 VPN,数据库也会保留其现有的防火墙规则。
查询流可以更改 Google Cloud SQL 中的数据吗?
不。代理在执行时强制执行只读模式——一次只执行一条语句,仅限 SELECT 及其相关语句。凭据保留在代理上,绝不会发送到查询流。
Query Streams 需要连接到 Google Cloud SQL 的哪些组件?
可访问的主机、角色及其密码——代理程序自带驱动程序,因此无需在数据库上安装任何软件。引擎:PostgreSQL、MySQL 和 SQL Server 集成在同一张卡上。地址:实例的私有或公共 IP 地址,或通过 Cloud SQL 身份验证代理使用 127.0.0.1——Cloud SQL 没有主机名可供指向。端口:PostgreSQL 为 5432,MySQL 为 3306,SQL Server 为 1433——每个引擎的端口号均已预先填充,并与您选择的引擎进行交叉验证。TLS:对于直接 IP 连接,默认启用;通过身份验证代理时,禁用 TLS 是正确的,因为身份验证代理会加密其自身的隧道。
我可以在同一个查询中将 Google Cloud SQL 连接到另一个数据库吗?
是的——这就是联合查询。一条语句可以同时引用 Google Cloud SQL 和其他连接,格式为 connection.schema.table。每个数据源只运行它能够执行的部分,并将结果流式传输回来;连接操作在中心进行,因此数据源之间不会相互连接,也不会进行任何复制或调度。所有部分(SELECT、WITH 和 EXPLAIN)都采用只读模式,并且单个数据源在单次查询中可以传输的数据量有限制。联合查询是一项计划功能;联合查询页面会显示当前的数据源和大小限制。
连接 Google Cloud SQL 与连接 PostgreSQL 有什么不同?
仅需连接字符串。Google Cloud SQL 使用 PostgreSQL 网络协议,因此筛选器、调度、共享、Excel 和 Google Sheets 插件以及 MCP 服务器的行为都完全相同。Cloud SQL 卡片会自动填充提供商所需的主机、端口和 SSL 设置。
是否有 Cloud SQL 到 Excel 的转换指南?
是的——这是 PostgreSQL 指南,而且就其内容而言,也适用于 Google Cloud SQL。Cloud SQL 使用 PostgreSQL 的网络协议,因此 Cloud SQL 连接到 Excel、Google Sheets 以及其他任何目标平台都遵循相同的步骤。唯一 Cloud SQL 特有的部分是连接字符串,Cloud SQL 卡片会自动为您填写。

