PostgreSQL / 系统课时

盘点源库与目标库兼容性

盘点源库与目标库兼容性

低停机迁移最怕把问题留到订阅启动或切换窗口才暴露。本课先把源库与目标库的版本、扩展、类型、排序规则和对象依赖做成可执行清单,并把“能复制数据”与“能安全接管业务”分开验证。

学习目标

  • 采集源库与目标库的关键兼容性事实,并识别必须逐项比对的差异
  • 找出逻辑复制不会自动处理的对象,以及 UPDATE、DELETE 的复制前提
  • 按阻塞级别整理迁移清单,明确需要在建订阅前和切换前完成的修复

先把兼容性拆成五类

版本决定协议、系统目录和功能边界;扩展决定目标端是否能创建同名对象;数据类型决定复制过来的值能否被目标列接受;排序规则会影响比较、排序和唯一约束语义;对象依赖则决定哪些内容必须靠 schema 迁移或切换脚本补齐。

检查维度 重点比对 典型处理
PostgreSQL 版本 源、目标主版本与升级方向 跨大版本先做端到端回放,不只验证连接
扩展 名称、版本、目标端可安装性 先安装兼容版本,再导入依赖对象
数据类型 enum、domain、range、自定义类型 在目标端预建兼容定义并验证边界值
排序规则 编码、LC_COLLATE、LC_CTYPE、ICU/libc 差异 对唯一索引和文本比较做专项验证
对象依赖 序列、视图、物化视图、大对象、函数、触发器 用 schema 迁移和切换脚本单独处理

逻辑复制传递的是表数据变化,不是“整库对象镜像”。因此目标库结构不需要逐字节相同,但参与复制的表和列必须能接住发布端发送的数据。

采集源库与目标库事实

下面的 SQL 分别在源库和目标库执行。先保存结果,再逐项比较;不要只记录 SELECT version(),因为很多迁移失败来自扩展、类型和复制标识,而不是版本号本身。

sql
SELECT
    current_setting('server_version') AS server_version,
    current_setting('server_encoding') AS server_encoding,
    current_setting('lc_collate') AS lc_collate,
    current_setting('lc_ctype') AS lc_ctype;

SELECT extname, extversion
FROM pg_extension
ORDER BY extname;

SELECT n.nspname AS schema_name,
       t.typname AS type_name,
       t.typtype AS type_kind
FROM pg_type AS t
JOIN pg_namespace AS n ON n.oid = t.typnamespace
WHERE n.nspname NOT IN ('pg_catalog', 'information_schema')
  AND t.typtype IN ('d', 'e', 'r', 'm')
ORDER BY 1, 2;

SELECT n.nspname AS schema_name,
       c.relname AS table_name,
       CASE c.relreplident
           WHEN 'd' THEN 'default'
           WHEN 'n' THEN 'nothing'
           WHEN 'f' THEN 'full'
           WHEN 'i' THEN 'index'
       END AS replica_identity,
       EXISTS (
           SELECT 1
           FROM pg_index AS i
           WHERE i.indrelid = c.oid
             AND i.indisprimary
       ) AS has_primary_key
FROM pg_class AS c
JOIN pg_namespace AS n ON n.oid = c.relnamespace
WHERE c.relkind IN ('r', 'p')
  AND n.nspname NOT IN ('pg_catalog', 'information_schema')
ORDER BY 1, 2;

SELECT count(*) AS large_object_count
FROM pg_largeobject_metadata;

预期结果

text
server_version | server_encoding | lc_collate | lc_ctype
<VALUE>        | UTF8            | <VALUE>    | <VALUE>

extname     | extversion
<EXTENSION> | <VALUE>

schema_name | type_name | type_kind
<SCHEMA>    | <TYPE>    | <VALUE>

schema_name | table_name | replica_identity | has_primary_key
<SCHEMA>    | <TABLE>    | default          | f

large_object_count
<VALUE>

实际版本、对象名和数量会不同。重点是把两端结果形成差异清单;如果候选复制表没有主键或合适的 replica identity,就要在发布 UPDATE、DELETE 前处理。

识别逻辑复制不会替你完成的工作

DDL 不会随逻辑复制自动同步,所以表、索引、约束、函数、触发器和其他 schema 对象必须提前建立并持续保持兼容。序列值也不会靠普通表变更自动追到最新位置,切换写流量前要单独校准。

大对象不属于逻辑复制的表数据通道。如果 large_object_count 非 0,应在方案中安排额外迁移路径,不能假设订阅会把它们带过去。视图、物化视图和外部表也不能当成普通发布表处理。

对于没有主键的更新型表,可以评估专用唯一索引或 REPLICA IDENTITY FULL。后者适合作为受控兜底,但会增加 WAL 和匹配成本,不应在大表上未经压测直接使用。

给差异定级再进入复制配置

把发现的问题分成三档最实用:建订阅前阻塞项、切换前阻塞项、可在迁移后修复项。扩展缺失、目标列类型不兼容、复制表缺少可用 replica identity 属于前两类;只影响只读报表的非关键视图通常可以后置。

最终清单至少应回答:哪些表可以直接发布、哪些对象靠 schema 迁移、哪些序列在切换前校准、哪些排序规则需要专项回归。只有这些结论明确后,后续逻辑复制链路才是在已知边界内运行,而不是用复制过程替代兼容性测试。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

盘点源库与目标库兼容性

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通