PostgreSQL / 系统课时
验证扩展与类型兼容性
验证扩展与类型兼容性
逻辑复制只搬运表数据变化,不会替你安装扩展、创建自定义类型、同步函数或保证排序规则语义一致。跨版本迁移前应把这些依赖做成清单,在目标端逐项证明“对象存在、版本可用、输入输出语义兼容”,再开放订阅追平。
学习目标
- 盘点扩展、自定义类型、函数和实际使用的排序规则
- 区分“名字相同”和“行为兼容”,识别跨版本高风险对象
- 建立目标端预创建、冒烟验证和复制参数检查顺序
先把非表对象列成兼容性清单
扩展需要同时检查服务器是否安装对应扩展文件、数据库内是否已 CREATE EXTENSION,以及目标版本是否支持源端使用的扩展版本或升级路径。只看到 pg_extension 里名字相同,不代表共享库、依赖包和 SQL 对象完全兼容。
自定义枚举、域、复合类型和范围类型必须在目标端提前定义。逻辑复制默认主要依靠类型的文本输入输出完成值转换,因此目标类型不一定要求物理布局相同,但必须能接受源端发送的表示;一旦订阅启用 binary = true,就要额外验证二进制发送与接收格式在两端版本间确实兼容。
函数通常不作为逻辑复制数据的一部分自动创建。特别是 C 语言函数、依赖外部共享库的函数和扩展提供的函数,需要同时检查目标操作系统、动态库和函数签名。排序规则则要检查 provider、locale 和实际版本,因为同名 collation 在不同 libc 或 ICU 版本上可能产生不同排序与唯一性结果。
用系统目录盘点源端对象
下面的 SQL 可以直接在源库执行,得到迁移前的核心依赖清单。查询只读取系统目录,不会修改数据库。
SELECT e.extname, e.extversion, n.nspname AS schema_name
FROM pg_extension AS e
JOIN pg_namespace AS n ON n.oid = e.extnamespace
ORDER BY e.extname;
SELECT n.nspname AS schema_name,
t.typname,
t.typtype
FROM pg_type AS t
JOIN pg_namespace AS n ON n.oid = t.typnamespace
LEFT JOIN pg_class AS c ON c.oid = t.typrelid
WHERE n.nspname NOT IN ('pg_catalog', 'information_schema')
AND n.nspname !~ '^pg_toast'
AND (
t.typtype IN ('d', 'e', 'r')
OR (t.typtype = 'c' AND c.relkind = 'c')
)
ORDER BY n.nspname, t.typname;
SELECT n.nspname AS schema_name,
t.typname,
string_agg(e.enumlabel, ',' ORDER BY e.enumsortorder) AS labels
FROM pg_type AS t
JOIN pg_namespace AS n ON n.oid = t.typnamespace
JOIN pg_enum AS e ON e.enumtypid = t.oid
WHERE n.nspname NOT IN ('pg_catalog', 'information_schema')
AND n.nspname !~ '^pg_toast'
GROUP BY n.nspname, t.typname
ORDER BY n.nspname, t.typname;
SELECT n.nspname AS schema_name,
p.proname,
pg_get_function_identity_arguments(p.oid) AS arguments,
pg_get_function_result(p.oid) AS result_type,
l.lanname AS language
FROM pg_proc AS p
JOIN pg_namespace AS n ON n.oid = p.pronamespace
JOIN pg_language AS l ON l.oid = p.prolang
WHERE n.nspname NOT IN ('pg_catalog', 'information_schema')
AND n.nspname !~ '^pg_toast'
ORDER BY n.nspname, p.proname, arguments;
SELECT DISTINCT
cn.nspname AS collation_schema,
coll.collname,
coll.collprovider,
coll.collversion,
pg_collation_actual_version(coll.oid) AS actual_version
FROM pg_attribute AS a
JOIN pg_class AS c ON c.oid = a.attrelid
JOIN pg_namespace AS n ON n.oid = c.relnamespace
JOIN pg_collation AS coll ON coll.oid = a.attcollation
JOIN pg_namespace AS cn ON cn.oid = coll.collnamespace
WHERE c.relkind IN ('r', 'p')
AND a.attnum > 0
AND NOT a.attisdropped
AND n.nspname NOT IN ('pg_catalog', 'information_schema')
AND n.nspname !~ '^pg_toast'
ORDER BY cn.nspname, coll.collname;预期结果
extname | extversion | schema_name
<EXTENSION> | <VERSION> | <SCHEMA>
schema_name | typname | typtype
<SCHEMA> | <TYPE_NAME> | e
schema_name | typname | labels
<SCHEMA> | <ENUM_TYPE> | <LABEL_1>,<LABEL_2>
schema_name | proname | arguments | result_type | language
<SCHEMA> | <FUNCTION> | <ARGS> | <TYPE> | <LANGUAGE>
collation_schema | collname | collprovider | collversion | actual_version
<SCHEMA> | <COLLATION> | <PROVIDER> | <VERSION> | <VERSION>实际行数和版本值取决于数据库。应在目标端执行同一组查询,并把差异逐项归类为“必须补齐”“允许升级但需验证”或“迁移中禁止使用”,而不是只做字符串级别的 schema diff。
重点验证类型与排序语义
枚举类型要比较标签集合及顺序;域类型要比较基础类型、默认值和约束;复合类型要比较字段名与字段类型。若目标端先升级了扩展或类型定义,至少选取真实业务值做显式 cast 或函数调用,确认目标输入函数能接受源端会发送的数据。
排序规则的风险更隐蔽。若 collversion 与 pg_collation_actual_version() 不一致,说明数据库记录的版本与当前操作系统或 ICU 实际版本发生偏差。涉及该排序规则的 B-tree 索引、唯一约束和依赖排序结果的查询都应重新验证;不要只执行 ALTER COLLATION ... REFRESH VERSION 就假定索引内容已经自动重建。
按依赖顺序准备目标端
目标端准备通常按“扩展运行时与扩展对象 → 自定义类型与排序规则 → 函数 → 表、索引和约束 → 订阅”推进。扩展管理的对象尽量通过目标版本支持的扩展安装与升级机制生成,不要把扩展内部对象拆散后手工复制。
完成后再做业务级冒烟验证:调用关键函数、插入一组包含枚举和域值的数据、用真实排序规则执行排序与唯一性测试,并确认订阅参数没有意外启用未验证的二进制传输。只有这些对象在目标端先稳定下来,逻辑复制追平才是在验证数据链路,而不是把 DDL 和运行时依赖问题拖到切换窗口里暴露。