使用psql执行INSERT语句未同步至Cloud SQL实例的问题排查

我的GCP项目中运行着一个Cloud SQL实例，通过本地机器使用psql执行以下INSERT语句[1]，操作无报错，但在Cloud控制台中无法找到插入的行。不过在psql命令行执行查询语句[2]时，能返回之前插入的数据。

为排查问题，登录项目查看Log Explorer，未发现权限相关或类似错误。进一步测试：通过控制台手动向Cloud SQL实例添加数据，再用psql执行查询[2]，结果仅包含通过[1]插入的数据。

疑问 #

1. 使用psql提交数据是否遗漏了额外命令或参数？已使用BEGIN;和COMMIT;，但结果依旧。
2. 为何本地插入的数据未同步至Cloud SQL实例？所用服务账号拥有实例的Admin权限。

相关信息 #

• 该Cloud SQL实例仅配置私有IP，本地使用Cloud SQL proxy进行连接。(知道本地保留代理并非最佳实践，目前仅用于测试)

[1] INSERT语句 #

INSERT INTO test (id, name) VALUES (11, 'Alice');
INSERT INTO test (id, name) VALUES (32, 'Bob');
INSERT INTO test (id, name) VALUES (13, 'Charlie');
INSERT INTO test (id, name) VALUES (41, 'David');
INSERT INTO test (id, name) VALUES (52, 'Eva');

[2] 查询语句 #

SELECT * FROM test;

核心原因 #

你遇到的是连接到不同数据库/ schema的问题：本地psql和Cloud控制台操作的不是同一个数据库或schema，导致两边的数据集完全隔离，并非数据未同步。

针对疑问的解答 #

1. psql提交数据无遗漏命令 #

你用BEGIN;和COMMIT;已经完成事务提交，psql的操作流程没有问题，数据已经在你连接的目标库中持久化，只是控制台没查对位置。

2. 数据“未同步”的本质 #

不存在数据未同步的情况——两边操作的是同一个Cloud SQL实例，但数据库/schema不匹配：

• 本地psql连接时可能通过-d <db_name>参数指定了某个自定义数据库，而Cloud控制台默认连接的是实例的默认数据库（通常是postgres）。
• 或者两边使用了不同的schema：比如本地操作的是自定义schema，而控制台默认查询的是public schema。

验证与修复步骤 #

1. 确认本地psql连接的数据库：在psql命令行执行SELECT current_database();，查看当前连接的数据库名称。
2. 确认控制台查询的目标：在Cloud控制台的Cloud SQL实例页面，进入“数据库”标签，检查你在控制台操作的数据库是否和本地一致；如果是schema问题，在本地执行SELECT current_schema();查看当前schema，然后在控制台查询时指定该schema（格式：SELECT * FROM <schema_name>.test;）。
3. 统一连接目标：要么让本地psql连接控制台使用的数据库，要么在控制台切换到本地操作的数据库/schema进行查询。

内容的提问来源于stack exchange，提问作者Jonalca