PostgreSQL / 系统课时

验证扩展与类型兼容性

验证扩展与类型兼容性

逻辑复制只搬运表数据变化,不会替你安装扩展、创建自定义类型、同步函数或保证排序规则语义一致。跨版本迁移前应把这些依赖做成清单,在目标端逐项证明“对象存在、版本可用、输入输出语义兼容”,再开放订阅追平。

学习目标

  • 盘点扩展、自定义类型、函数和实际使用的排序规则
  • 区分“名字相同”和“行为兼容”,识别跨版本高风险对象
  • 建立目标端预创建、冒烟验证和复制参数检查顺序

先把非表对象列成兼容性清单

扩展需要同时检查服务器是否安装对应扩展文件、数据库内是否已 CREATE EXTENSION,以及目标版本是否支持源端使用的扩展版本或升级路径。只看到 pg_extension 里名字相同,不代表共享库、依赖包和 SQL 对象完全兼容。

自定义枚举、域、复合类型和范围类型必须在目标端提前定义。逻辑复制默认主要依靠类型的文本输入输出完成值转换,因此目标类型不一定要求物理布局相同,但必须能接受源端发送的表示;一旦订阅启用 binary = true,就要额外验证二进制发送与接收格式在两端版本间确实兼容。

函数通常不作为逻辑复制数据的一部分自动创建。特别是 C 语言函数、依赖外部共享库的函数和扩展提供的函数,需要同时检查目标操作系统、动态库和函数签名。排序规则则要检查 provider、locale 和实际版本,因为同名 collation 在不同 libc 或 ICU 版本上可能产生不同排序与唯一性结果。

用系统目录盘点源端对象

下面的 SQL 可以直接在源库执行,得到迁移前的核心依赖清单。查询只读取系统目录,不会修改数据库。

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;

预期结果

text
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 和运行时依赖问题拖到切换窗口里暴露。

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

目录与阅读设置

阅读设置

17

记录一个想法

验证扩展与类型兼容性

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

登录哪都通