CloudSQL PostgreSQL用pglogical添加表到复制集时出现OID 12303343错误

使用CloudSQL PostgreSQL并安装pglogical扩展实现逻辑复制时，在DBeaver执行以下SQL命令报错：

SELECT pglogical.replication_set_add_table(
    set_name := 'my_set', relation := 'public.table', 
    synchronize_data := TRUE
);

错误详情：

org.jkiss.dbeaver.model.sql.DBSQLException: SQL Error [XX000]: ERROR: could not open relation with OID 12303343
    at org.jkiss.dbeaver.model.impl.jdbc.exec.JDBCStatementImpl.executeStatement(JDBCStatementImpl.java:133)
    at org.jkiss.dbeaver.ui.editors.sql.execute.SQLQueryJob.executeStatement(SQLQueryJob.java:582)
    at org.jkiss.dbeaver.ui.editors.sql.execute.SQLQueryJob.lambda$1(SQLQueryJob.java:491)
    at org.jkiss.dbeaver.model.exec.DBExecUtils.tryExecuteRecover(DBExecUtils.java:189)
    at org.jkiss.dbeaver.ui.editors.sql.execute.SQLQueryJob.executeSingleQuery(SQLQueryJob.java:498)
    at org.jkiss.dbeaver.ui.editors.sql.execute.SQLQueryJob.extractData(SQLQueryJob.java:934)
    at org.jkiss.dbeaver.ui.editors.sql.SQLEditor$QueryResultsContainer.readData(SQLEditor.java:3919)
    at org.jkiss.dbeaver.ui.controls.resultset.ResultSetJobDataRead.lambda$0(ResultSetJobDataRead.java:123)
    at org.jkiss.dbeaver.model.exec.DBExecUtils.tryExecuteRecover(DBExecUtils.java:189)
    at org.jkiss.dbeaver.ui.controls.resultset.ResultSetJobDataRead.run(ResultSetJobDataRead.java:121)
    at org.jkiss.dbeaver.ui.controls.resultset.ResultSetViewer$ResultSetDataPumpJob.run(ResultSetViewer.java:5101)
    at org.jkiss.dbeaver.model.runtime.AbstractJob.run(AbstractJob.java:105)
    at org.eclipse.core.internal.jobs.Worker.run(Worker.java:63)
Caused by: org.postgresql.util.PSQLException: ERROR: could not open relation with OID 12303343
    at org.postgresql.core.v3.QueryExecutorImpl.receiveErrorResponse(QueryExecutorImpl.java:2676)
    at org.postgresql.core.v3.QueryExecutorImpl.processResults(QueryExecutorImpl.java:2366)
    at org.postgresql.core.v3.QueryExecutorImpl.execute(QueryExecutorImpl.java:356)
    at org.postgresql.jdbc.PgStatement.executeInternal(PgStatement.java:496)
    at org.postgresql.jdbc.PgStatement.execute(PgStatement.java:413)
    at org.postgresql.jdbc.PgStatement.executeWithFlags(PgStatement.java:333)
    at org.postgresql.jdbc.PgStatement.executeCachedSql(PgStatement.java:319)
    at org.postgresql.jdbc.PgStatement.executeWithFlags(PgStatement.java:295)
    at org.postgresql.jdbc.PgStatement.execute(PgStatement.java:290)
    at org.jkiss.dbeaver.model.impl.jdbc.exec.JDBCStatementImpl.execute(JDBCStatementImpl.java:330)
    at org.jkiss.dbeaver.model.impl.jdbc.exec.JDBCStatementImpl.executeStatement(JDBCStatementImpl.java:131)
    ... 12 more

1. 目标表不存在或名称有误 #

• 原因：指定的public.table不存在，或者schema/表名拼写错误（PostgreSQL对未加引号的标识符默认转为小写，若表名是大小写混合会匹配失败）。
• 修复：
  • 先执行以下SQL确认表是否存在：

    SELECT * FROM pg_class 
    WHERE relname = 'table' 
    AND relnamespace = (SELECT oid FROM pg_namespace WHERE nspname = 'public');
    

  • 如果表名包含特殊字符或大小写混合，需用双引号包裹标识符，例如：

    SELECT pglogical.replication_set_add_table(
        set_name := 'my_set', relation := '"public"."MyTable"', 
        synchronize_data := TRUE
    );
    

2. 执行用户权限不足 #

• 原因：执行命令的用户没有目标表的访问权限，或是缺少pglogical相关操作权限。
• 修复：
  • 授予用户目标表的SELECT权限：

    GRANT SELECT ON public.table TO your_exec_user;
    

  • 若使用角色管理，确保用户被授予pglogical角色：

    GRANT pglogical TO your_exec_user;
    

3. OID对应关系失效 #

• 原因：表可能被删除后重建，或出现极端OID冲突，导致pglogical无法通过OID找到对应表对象。
• 修复：
  • 先查询目标表的正确OID：

    SELECT oid FROM pg_class 
    WHERE relname = 'table' 
    AND relnamespace = (SELECT oid FROM pg_namespace WHERE nspname = 'public');
    

  • 用查询到的OID替换relation参数执行命令：

    SELECT pglogical.replication_set_add_table(
        set_name := 'my_set', relation := '替换为实际OID', 
        synchronize_data := TRUE
    );
    

4. CloudSQL扩展或配置异常 #

• 原因：CloudSQL对pglogical有特定配置要求，或是扩展未正确启用。
• 修复：
  • 执行以下SQL确认pglogical扩展已启用：

    SELECT * FROM pg_extension WHERE extname = 'pglogical';
    

  • 检查CloudSQL实例配置：确保实例为高可用/标准模式，且已开启逻辑复制选项（可在CloudSQL控制台的实例配置页查看）。
  • 若扩展启用后未生效，尝试重启CloudSQL实例。

5. DBeaver元数据缓存过期 #

• 原因：DBeaver的本地元数据缓存未更新，导致识别的表OID与数据库实际情况不符。
• 修复：
  • 在DBeaver中右键点击对应数据库连接，选择刷新元数据，等待缓存更新后重新执行命令。
  • 尝试使用psql客户端直接连接数据库执行该命令，排除DBeaver客户端的问题。

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