Google AlloyDB 标志

兼容Postgres 支持 PostgreSQL

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

AlloyDB for PostgreSQL 可通过 VPC 内的私有 IP 地址或 AlloyDB 身份验证代理访问。无需公网 IP 地址,也无需设置入站规则。

一个连接,每个表面

AlloyDB 数据可以去哪里

Query Streams 通过一个只读连接,从 Microsoft Excel、Google Sheets、Power BI、AI 助手(通过 MCP)以及 REST 端点读取 AlloyDB 数据。AlloyDB 没有公网主机名,您可以通过 Google Cloud VPC 内的私有 IP 地址访问它,或者通过本地主机上的 AlloyDB 身份验证代理访问它。将网络代理部署在同一 VPC 中的小型虚拟机上,它就可以私下访问实例,并且只建立出站连接,因此 AlloyDB 不需要公网 IP 地址,您的 VPC 也不需要入口规则。

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

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

    将 AlloyDB 的实时结果直接提取到工作表中,并按需刷新——支持桌面版 Excel、Excel Online 和 Microsoft 365。

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

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

    PostgreSQL 指南
  4. 向 Nova 询问 AlloyDB 的相关事宜 Nova AI · 文本转 SQL

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    将 AlloyDB 查询添加到计划中,并将查询结果发送到 Slack、Discord、电子邮件或签名 webhook,或者等到行数、阈值或百分比变化超过您设定的界限时才发送消息。

    警报和报告的工作原理

工作原理

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

01

将网络代理放置在与 AlloyDB 实例位于同一 Google Cloud VPC 内的虚拟机上。这是整个设计所假定的部署方式。

02

请输入实例的私有 IP 地址。AlloyDB 没有主机名——地址就是您拥有的地址。

03

或者在代理的虚拟机上运行 AlloyDB 身份验证代理,并将卡指向 127.0.0.1。该卡可以识别 localhost 并提供正确的建议。

04

请填写数据库用户名和密码。AlloyDB 默认使用名为 postgres 的数据库,卡片上已预先填充了相关信息。

05

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

专题深度解析

AlloyDB 能为你提供什么

VPC 中的代理就是整个设计。

AlloyDB 的设计目标是私有化,而网络代理也仅建立出站连接。这两个特性完美契合,因此私有路径是默认选项,而非强化选项。

  • 在同一 VPC 内的虚拟机上运行代理,它可以通过实例的私有 IP 地址访问该实例。AlloyDB 的任何信息都不会被公开,也不需要公网 IP 地址。
  • 代理会拨出电话但从不监听,因此无需添加入口规则,VPC 外部的任何人都无法访问。
  • 由于 AlloyDB 使用 IP 地址而非主机名进行寻址,因此 Query Streams 无法识别地址中的任何信息。AlloyDB 徽章来自选择此卡,而非来自嗅探地址。 — 因此,与同一 IP 地址的普通 Postgres 连接仍会被标记为普通 Postgres。
  • AlloyDB 仅兼容 PostgreSQL,不支持其他数据库。与同时提供 MySQL 和 SQL Server 的 Cloud SQL 不同,AlloyDB 只有一个数据库引擎,没有引擎选择器。

通过身份验证代理关闭 SSL

另一种支持的途径是使用 Google 的 AlloyDB Auth Proxy,它会更改表单中的一个答案。

  • 在代理机器上运行代理,并将网卡指向 127.0.0.1。网卡会检测到 localhost,并指示下一步该怎么做。
  • 代理服务器会对隧道本身进行加密。如果要求 Postgres 驱动程序在此基础上协商自己的 TLS,就会产生用户遇到的 SSL 错误,因此请取消选中“使用代理连接”复选框。
  • 如果使用直接私有 IP 连接,请保持选中状态。AlloyDB 是托管服务提供商中一个例外。 — 该复选框真正控制是否使用 TLS,而不是被代理程序覆盖。
  • 启用 TLS 后,流量会被加密,但证书链不会被验证。

普通的Postgres连接后

除了地址和代理之外,没有其他 AlloyDB 特有的机制。最终到达的是 Postgres 数据库。

  • 连接保存为 PostgreSQL,但标记保留为 AlloyDB。实际上并不存在名为 AlloyDB 的连接类型。
  • 身份验证需要数据库用户名和密码。此卡片不支持 Google Cloud IAM 数据库身份验证。
  • 没有连接池配置,也没有可供选择的连接池端点。代理直接连接。
  • public 是默认模式,也是跨源引用所携带的模式。
-- 普通 Postgres,只读,通过私有 IP 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

将 AlloyDB 连接到您的其余数据

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

3 个连接 · 3 个代理

Google AlloyDB 兼容Postgres
微软 SQL 服务器 关系引擎
条纹 付款与账单

一份声明

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

连接详情

AlloyDB需要什么

地址
实例的私有 IP 地址。AlloyDB 没有公共主机名——或者在使用身份验证代理时使用 127.0.0.1。
港口
5432
司机
Npgsql 由代理程序携带——AlloyDB 端无需安装任何程序。
代理安排
同一 VPC 中的虚拟机。仅限出站流量,因此没有入站规则,也没有公开访问。
数据库
默认情况下是postgres,并已预先填充。
验证
数据库用户名和密码。不支持 IAM 数据库身份验证。
TLS
可通过复选框控制,默认启用。已加密;证书链未经验证。通过身份验证代理时,请将其关闭,身份验证代理会对隧道本身进行加密。
池化
无需配置——代理直接连接。
发动机
仅支持 PostgreSQL。与 Cloud SQL 不同,它不提供 MySQL 或 SQL Server 选项。
默认架构
公开的,也就是联邦引用所携带的。

在本目录中,AlloyDB 是最能体现代理结构与数据库结构完美匹配的案例。AlloyDB 希望运行在私有 IP 地址上,不涉及任何公共接口;代理只建立出站连接,从不监听任何网络。将两者置于同一 VPC 内,无需进行任何妥协——无需启用公共 IP 地址,无需维护授权网络列表,也无需日后进行审计的入口规则。访问私有数据库通常会产生一定的网络开销,而在这里,它只需要一台小型虚拟机。

建议您在遇到错误之前阅读身份验证代理脚注,而不是之后。谷歌的代理已经对隧道进行了加密,因此当 Postgres 驱动程序尝试在其内部协商 TLS 时,连接测试会失败,并出现一个看似证书问题的 SSL 错误,但实际上并非如此。解决方法是取消代理连接的 SSL 复选框,并且卡片会在检测到本地主机地址时立即提示这一点。在直接的私有 IP 连接中,该复选框应保持选中状态——与大多数托管服务提供商不同,在 AlloyDB 中,决定是否启用 SSL 的不是代理,而是复选框本身。

对于跨源查询,AlloyDB 与普通的 Postgres 数据库并无二致。您创建的名为 alloy_core 的连接实际上是 alloy_core.public.orders,它通过一条只读语句即可连接到包含 CSV 文件的文件夹、本地记录系统或计费 API——无需复制任何数据,也无需进行任何调度。连接操作在代理所在的任何位置运行,对于 AlloyDB 而言,这意味着在您的 VPC 内部运行。

供应商文档: cloud.google.com

常问问题

关于 Google AlloyDB 的问题

哪些工具可以通过查询流读取 Google AlloyDB 数据?

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

我是否需要为我的 Google AlloyDB 数据库打开防火墙端口?

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

查询流能否更改 Google AlloyDB 中的数据?

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

Query Streams 需要连接到 Google AlloyDB 的什么组件?

一个可访问的主机、一个角色及其密码——代理程序自带驱动程序,因此无需在数据库端安装任何内容。地址:实例的私有 IP 地址。AlloyDB 没有公共主机名——或者在使用身份验证代理时使用 127.0.0.1。端口:5432。驱动程序:Npgsql,由代理程序携带——AlloyDB 端无需安装任何内容。代理程序放置位置:同一 VPC 中的虚拟机。仅限出站访问,因此没有入站规则,也不会暴露给公共网络。

我可以在同一个查询中将 Google AlloyDB 连接到另一个数据库吗?

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

连接 Google AlloyDB 与连接 PostgreSQL 有什么不同?

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

是否有 AlloyDB 到 Excel 的转换指南?

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

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

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

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