PostgreSQL / 系统课时
盘点源库与目标库兼容性
盘点源库与目标库兼容性
低停机迁移最怕把问题留到订阅启动或切换窗口才暴露。本课先把源库与目标库的版本、扩展、类型、排序规则和对象依赖做成可执行清单,并把“能复制数据”与“能安全接管业务”分开验证。
学习目标
- 采集源库与目标库的关键兼容性事实,并识别必须逐项比对的差异
- 找出逻辑复制不会自动处理的对象,以及 UPDATE、DELETE 的复制前提
- 按阻塞级别整理迁移清单,明确需要在建订阅前和切换前完成的修复
先把兼容性拆成五类
版本决定协议、系统目录和功能边界;扩展决定目标端是否能创建同名对象;数据类型决定复制过来的值能否被目标列接受;排序规则会影响比较、排序和唯一约束语义;对象依赖则决定哪些内容必须靠 schema 迁移或切换脚本补齐。
| 检查维度 | 重点比对 | 典型处理 |
|---|---|---|
| PostgreSQL 版本 | 源、目标主版本与升级方向 | 跨大版本先做端到端回放,不只验证连接 |
| 扩展 | 名称、版本、目标端可安装性 | 先安装兼容版本,再导入依赖对象 |
| 数据类型 | enum、domain、range、自定义类型 | 在目标端预建兼容定义并验证边界值 |
| 排序规则 | 编码、LC_COLLATE、LC_CTYPE、ICU/libc 差异 | 对唯一索引和文本比较做专项验证 |
| 对象依赖 | 序列、视图、物化视图、大对象、函数、触发器 | 用 schema 迁移和切换脚本单独处理 |
逻辑复制传递的是表数据变化,不是“整库对象镜像”。因此目标库结构不需要逐字节相同,但参与复制的表和列必须能接住发布端发送的数据。
采集源库与目标库事实
下面的 SQL 分别在源库和目标库执行。先保存结果,再逐项比较;不要只记录 SELECT version(),因为很多迁移失败来自扩展、类型和复制标识,而不是版本号本身。
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;预期结果
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 迁移、哪些序列在切换前校准、哪些排序规则需要专项回归。只有这些结论明确后,后续逻辑复制链路才是在已知边界内运行,而不是用复制过程替代兼容性测试。