将PostgreSQL数据库迁移到香港服务器,怎样安排停写与数据校验?
把 PostgreSQL 迁移到香港服务器时,停写不应从“开始复制数据库”这一刻算起,而应安排在目标库已经完成初始化、持续同步并通过预检之后。较稳妥的路径是:先在源库保留业务运行,完成一次全量数据复制和增量追平;进入维护窗口后停止所有写入,等待未完成事务结束,确认目标库已追上最后变更,再进行数据校验和连接切换。
数据校验也不能只看数据库能否启动。至少要同时检查表结构、关键表行数、业务汇总值、外键关系、序列值、扩展和应用读写路径。切换后还要保留源库和回退配置,在约定的观察窗口内监控错误率、事务延迟、连接数和后台任务,避免因目标库已经接收新写入而无法简单切回。
一、先确认迁移目标和停写边界
这次变更的目标通常包括三部分:数据库运行位置切换到香港服务器、应用连接地址切换到目标 PostgreSQL,以及在不丢失已确认数据的前提下完成业务恢复。三者需要分别验收,不能只把 DNS 或连接字符串改掉就视为迁移完成。
生产变更负责人需要先回答以下问题:
- 目标 PostgreSQL 是否与源库保持同一大版本,还是同时进行版本升级?
- 是迁移整个实例,还是只迁移某个数据库、schema 或业务表?
- 应用服务器是否也位于香港,还是应用仍在其他地区访问香港数据库?
- 是否存在后台任务、报表、管理后台、消息消费者或脚本直接写入数据库?
- 允许的停写时间是多少,是否要求 RPO 为 0?
- 迁移后源库是否保留为只读回退节点,保留多长时间?
“停写”必须覆盖所有写入口,而不只是暂停网站下单接口。常见写入来源包括:
- Web、移动端和开放 API;
- 定时任务、队列消费者和批处理程序;
- 管理后台、财务或运营工具;
- 直接连接数据库的脚本;
- 触发器、存储过程和异步补偿任务。
如果只关闭主应用而没有暂停队列消费者,迁移期间仍可能有订单、库存、支付状态或日志写入源库,最终会形成两边数据不一致。

二、根据版本和迁移范围选择转换路径
迁移方式决定了全量复制是否可以提前完成,也决定最终停写窗口的长短。
| 迁移路径 | 适用条件 | 停写安排 | 主要注意事项 |
|---|---|---|---|
| 物理备份或物理复制 | PostgreSQL 大版本、操作系统架构和实例范围基本一致 | 通常需要较短的切换窗口,但需要整体接管实例 | 不能直接用于任意大版本升级,角色、扩展和磁盘布局要兼容 |
pg_dump 与 pg_restore | 数据库规模较小,或只迁移部分数据库和 schema | 停写期间完成导出、导入和校验,窗口较长 | 需要单独处理角色、权限、序列、扩展和大对象 |
| 全量导入加逻辑复制 | 跨大版本、跨服务器或需要缩短停写窗口 | 全量复制期间源库继续运行,最终只停写追平增量 | DDL、序列、无主键表和部分扩展对象不会自动按预期同步 |
| 应用双写 | 业务已经具备可靠的双写和补偿机制 | 理论上可缩短切换,但实施和校验复杂 | 容易出现部分成功、重复写入和顺序不一致,不宜临时引入 |
如果是 PostgreSQL 大版本升级,或只迁移单个业务数据库,逻辑复制通常比直接搬运数据目录更灵活。但逻辑复制并不等于完整实例复制,它主要处理表数据变更,角色、数据库级权限、扩展、函数、定时任务和序列需要单独核对。
如果数据库规模较小,直接使用逻辑备份可能更容易控制。比如待迁移数据约为 500 GB,实际持续传输速度为 100 MB/s,按十进制单位估算:
- 500 GB = 500,000 MB;
- 传输时间约为 500,000 ÷ 100 = 5,000 秒;
- 5,000 秒约为 83 分钟。
这里的 100 MB/s 等于约 800 Mbps,不能与 100 Mbps 混用。实际导入还会受到索引创建、WAL 写入、磁盘 I/O、约束检查和并发读取影响,因此停机预算不能只填写理论传输时间。对于大库,更合适的做法是提前完成全量导入,把最终停写窗口压缩为“排空写请求、追平增量、校验、切换”几个阶段。
三、现状核对:在源库建立可比较的基线
1. 核对版本、编码和数据库对象
在源库和目标库分别记录以下信息:
- PostgreSQL 版本和补丁版本;
- 数据库编码、排序规则和字符分类规则;
- 时区设置;
- schema、表、视图、物化视图和外键;
- 用户、角色、默认权限和连接限制;
- 已安装扩展及其版本;
- 函数、触发器、序列和大对象;
- 表空间、归档目录和备份策略。
可以先在源库执行只读检查:
SELECT version();
SELECT
current_database() AS database_name,
current_setting('server_encoding') AS server_encoding,
current_setting('lc_collate') AS lc_collate,
current_setting('lc_ctype') AS lc_ctype,
current_setting('TimeZone') AS timezone;
SELECT
extname,
extversion
FROM pg_extension
ORDER BY extname;
SELECT
schemaname,
count(*) AS table_count
FROM pg_tables
WHERE schemaname NOT IN ('pg_catalog', 'information_schema')
GROUP BY schemaname
ORDER BY schemaname;
目标库不应只检查“能否安装 PostgreSQL”。如果源库使用了 PostGIS、全文检索、加密、监控或其他扩展,需要确认目标版本存在对应扩展,并验证函数和索引类型可以正常创建。排序规则或时区不一致,可能导致排序结果、大小写比较和时间展示发生变化。
2. 识别长事务和实际写入者
迁移前要了解业务的事务特征。长事务会阻碍增量追平,也可能让最终停写阶段迟迟无法结束。
SELECT
pid,
usename,
application_name,
client_addr,
state,
xact_start,
query_start,
wait_event_type,
wait_event,
LEFT(query, 160) AS query_preview
FROM pg_stat_activity
WHERE datname = current_database()
AND xact_start IS NOT NULL
ORDER BY xact_start;
需要重点确认:
- 是否有长时间运行的报表查询;
- 是否存在
idle in transaction连接; - 应用连接池是否会自动重连到旧地址;
- 是否有未登记的管理脚本;
- 队列是否允许暂停、排空和重新消费。
不要在没有确认业务归属的情况下批量终止连接。若确实存在阻塞迁移的长事务,应先找到对应应用或负责人,再根据变更方案决定等待、取消查询或终止会话,并记录操作对象和回退方式。
3. 先做可恢复备份
迁移前至少保留一份可读出的源库备份,并验证备份文件能够在隔离环境恢复。备份不能只看命令返回成功,还要确认文件大小合理、恢复日志没有错误,关键表可以查询。
例如,逻辑备份可以采用自定义格式:
pg_dump \
--format=custom \
--file=/backup/appdb_before_migration.dump \
--dbname='postgresql://backup_user@SOURCE_HOST:5432/appdb'
恢复到测试数据库时,应先确认目标数据库为空或为专用测试库,避免覆盖现有数据。不要把生产库名、密码和真实地址直接写入公开脚本;连接密码应通过受控环境变量、密码文件或密钥系统提供。
四、变更准备:让全量复制和切换可以分开
1. 准备目标香港服务器
目标服务器至少要完成以下检查:
- PostgreSQL 大版本和所需扩展已经安装;
- 磁盘容量覆盖数据、索引、WAL、临时文件和增长余量;
- 数据目录权限属于正确的 PostgreSQL 系统用户;
- 源库到目标库的网络访问范围已经收紧;
- 应用到目标库的端口、TLS 和认证配置已经验证;
- 监控、备份、日志轮转和告警已接入;
- 服务器时间同步正常。
香港服务器的位置会改变应用到数据库之间的网络路径。即使迁移本身成功,也要测试应用实际访问目标库时的连接建立时间、查询延迟、连接池大小和跨地域网络稳定性。不能只在目标服务器本机执行一条 SELECT 1 就判断业务链路正常。
面向 PostgreSQL 迁移后的生产承载,A5数据提供中国香港物理服务器资源,覆盖 Xeon Gold、AMD EPYC 等处理器平台,并配备 SSD 或 NVMe 存储及不同内存配置,可用于数据库、业务后台和接口服务部署。香港产品同时提供 CN2 与国际带宽选项,能够结合应用访问地区、数据规模和网络路径,为目标库切换提供相应的硬件与线路基础。
2. 先做一次预导入和恢复演练
在非生产环境按计划做一次完整演练,至少记录:
- 全量导出耗时;
- 目标端导入耗时;
- 索引创建耗时;
- 目标端磁盘增长;
- 复制延迟的峰值;
- 应用启动和连接池重建时间;
- 数据校验耗时。
演练的价值不是追求一次成功,而是得到停写窗口的组成。最终停写时间通常可以按以下方式估算:
停写窗口 = 写入排空时间 + 最终增量追平时间 + 数据校验时间 + 应用切换时间 + 预留缓冲
如果采用全量导入加逻辑复制,全量导入和大部分校验可以在业务运行期间完成;如果采用停机后才开始 pg_dump,则导出和恢复都会进入停写窗口。
3. 预先冻结结构变更
从开始全量复制到最终切换期间,不宜随意增加字段、修改字段类型、重建关键索引或删除表。逻辑复制通常不会自动把所有 DDL 变化同步到目标库。
确需变更时,要明确它属于哪一侧:
- 在源库和目标库分别执行,并记录执行顺序;
- 通过迁移工具统一执行;
- 延后到切换完成后执行;
- 或暂时停止复制,重新规划全量和增量。
没有被纳入方案的 DDL 变更,是迁移失败后最常见的原因之一。
五、分步实施:把停写安排在最后追平阶段
1. 业务运行期间完成全量复制
如果使用 pg_dump,建议先导出 schema,再导入数据和索引,最后执行权限、触发器等对象恢复。使用逻辑复制时,先完成目标端表结构,再进行全量数据复制和持续增量同步。
发布逻辑复制前,需要确认:
- 需要同步的表都已纳入发布范围;
- 更新和删除涉及的表具备主键或明确的复制标识;
- 目标端没有不兼容的触发器或约束;
- 目标端写入不会反向覆盖源库;
- 复制账号权限只覆盖必要对象;
- 复制槽有磁盘增长监控和清理方案。
复制状态不能只看“订阅已创建”。应观察接收时间、最后接收位置、复制槽状态和目标端错误日志。不同 PostgreSQL 版本的统计字段可能有差异,可以先查看视图结构:
SELECT *
FROM pg_stat_subscription;
同时检查复制槽是否持续产生未消费的 WAL:
SELECT
slot_name,
slot_type,
active,
restart_lsn,
confirmed_flush_lsn
FROM pg_replication_slots;
如果复制长期落后,不能直接进入切换窗口。应先判断是网络、目标磁盘、索引维护、单表热点还是目标端资源不足。
2. 进入维护窗口前停止新增写请求
切换前按顺序暂停写入源:
- 通知相关负责人进入维护窗口,停止定时任务和批处理。
- 暂停队列消费者,等待已取出的消息完成或回到可重试状态。
- 将应用切换到维护模式,拒绝新的写操作。
- 保留必要的只读请求,但确认只读请求不会触发隐式写入。
- 对管理后台、脚本和人工操作通道加上临时限制。
- 记录当前源库 WAL 位置、连接数、活跃事务和关键业务计数。
应用层维护模式应作为第一道闸门。若需要增加数据库层保护,可针对专用应用角色设置新连接默认只读,但不能把它当作唯一保障,因为超级用户、其他角色和已经建立的连接可能不受该设置影响。执行任何角色权限变更前,都要记录原有配置,并准备对应的恢复语句。
3. 等待事务排空并确认没有遗漏写入
停写后不要立即切换。先检查:
- 是否仍有活跃写事务;
- 是否存在
idle in transaction; - 队列是否已经没有待消费写消息;
- 目标复制延迟是否降至可接受范围;
- 关键表的最后更新时间是否停止增长;
- 业务侧是否仍有 5xx、超时或重试。
如果要求 RPO 为 0,应在最终追平后再进行切换。若只能接受有限数据丢失,则必须明确允许的时间范围和数据补偿方式,不能用“复制基本同步”代替正式标准。
4. 执行最终同步和序列处理
目标库追平后,先处理逻辑复制无法自动覆盖的对象,例如序列。以订单表自增主键为例,只有在确认目标库不再接收并发写入时,才可以按目标表最大值校准序列:
SELECT setval(
'public.orders_id_seq',
COALESCE(MAX(id), 1),
MAX(id) IS NOT NULL
)
FROM public.orders;
这条语句只适用于序列确实服务于 public.orders.id,并且没有其他业务规则使用该序列的情况。其他表应逐一核对,不能把一个序列的处理结果套用到所有表。
序列之外,还要核对:
- 目标端函数和触发器是否已启用;
- 权限是否与源库一致;
- 物化视图是否需要重新刷新;
- 外部连接、通知、定时任务是否指向新地址;
- 备份和监控是否已经切换到目标库。
5. 切换应用连接并阻止旧库继续写入
应用切换优先使用配置中心、连接字符串或服务发现配置完成。若使用 DNS,需要注意 TTL 只影响后续解析,已有 TCP 连接和连接池不会立即切换,因此仍需主动重启或刷新应用连接池。
切换顺序建议为:
- 保持源库停止写入;
- 完成目标库结构和数据校验;
- 更新应用数据库连接配置;
- 重启或平滑刷新应用连接池;
- 验证目标库出现新的业务连接;
- 验证关键只读和受控写操作;
- 保持源库不可写,防止双主写入;
- 再逐步恢复队列消费者和定时任务。
在应用确认目标库正常前,不要同时开放源库和目标库写权限。出现双写后,即使两边初始数据完全一致,也可能因请求顺序、序列分配和异步任务造成不可逆分叉。

六、验证:从数据库一致性到业务结果逐层检查
1. 结构校验
首先比较 schema 和对象状态:
- 表、列、数据类型和默认值;
- 主键、唯一约束、外键和索引;
- 视图、函数和触发器;
- 扩展及版本;
- 用户、角色和对象权限;
- 表空间和大对象。
可以分别生成 schema-only 文件进行人工或工具差异比较:
pg_dump \
--schema-only \
--no-owner \
--no-privileges \
--dbname='postgresql://readonly_user@SOURCE_HOST:5432/appdb' \
> /tmp/source_schema.sql
pg_dump \
--schema-only \
--no-owner \
--no-privileges \
--dbname='postgresql://readonly_user@TARGET_HOST:5432/appdb' \
> /tmp/target_schema.sql
这里只用于比较,不能把两个文件直接在生产数据库中互相覆盖。发现差异后,应判断是迁移遗漏、版本生成差异,还是有意调整。
2. 数据量和业务汇总校验
不建议只比较整个数据库大小。压缩、膨胀率、索引布局和统计信息不同,都会导致磁盘占用不同。更有价值的是对关键表做精确行数和业务汇总比较:
SELECT
COUNT(*) AS row_count,
MIN(id) AS min_id,
MAX(id) AS max_id,
COALESCE(SUM(amount), 0) AS amount_sum
FROM public.orders;
对于订单、库存、账户余额、支付流水等表,建议至少比较:
- 行数;
- 主键最小值和最大值;
- 按日期或状态分组的数量;
- 金额、数量等关键字段汇总;
- 最新一条记录的时间和主键;
- 随机抽取记录的关键字段。
汇总条件必须在源库和目标库完全一致,例如时间范围、时区、状态值和软删除条件都要相同。否则即使两边数据相同,也可能因为查询条件不同而得到不同结果。
3. 关系和序列校验
目标库应确认关键外键没有孤儿记录,约束状态没有被意外设置为未验证。对使用自增主键的表,要检查下一次序列值不会与现有主键冲突。
对于写入密集型表,可以在切换前记录一组主键和业务字段,切换后按同样主键抽查。对于金额、库存等不能接受误差的字段,优先使用精确汇总,不要用四舍五入后的展示值比较。
4. 应用级验证
数据库查询通过并不代表业务已经恢复。切换后要按真实业务路径执行低风险验证:
- 用户登录和会话读取;
- 查询列表和详情;
- 新建一笔可回收的测试业务;
- 修改状态并确认事务提交;
- 检查后台任务是否成功消费;
- 检查写入后的记录是否能被其他服务读取;
- 检查错误日志、慢查询和连接池等待。
如果测试写入会产生通知、扣款、发货或计费等外部副作用,不要直接在生产环境执行。可以使用只读链路、回滚事务或预先设计的测试数据,并让业务负责人确认验收方式。
七、观察窗口和回滚条件
切换完成后,建议至少设置三个观察阶段:
| 阶段 | 重点观察内容 | 处理方式 |
|---|---|---|
| 切换后 0~15 分钟 | 连接建立、认证失败、事务错误、接口超时、数据库 CPU 和磁盘 I/O | 逐步放量,优先处理阻断性错误 |
| 15~60 分钟 | 正常流量下的查询延迟、锁等待、连接池、队列消费和后台任务 | 与迁移前基线比较 |
| 一个完整业务周期 | 报表、结算、批处理、备份、归档和高峰时段表现 | 决定是否解除旧库保留和临时限制 |
观察时间应覆盖一次关键业务高峰或完整批处理周期,而不是固定等待几分钟就删除源库。源库至少应保留为不可写的回退参考,并继续保留可恢复备份。
以下情况应触发暂停放量或回滚评估:
- 目标端关键表校验不一致;
- 仍有未追平的增量或复制错误;
- 应用出现持续的数据库连接失败;
- 关键接口错误率明显高于迁移前;
- 查询延迟、锁等待或连接池排队超过业务阈值;
- 后台任务重复执行、漏执行或产生异常数据;
- 目标端扩展、权限或字符排序导致业务结果变化;
- 发现源库仍存在未受控写入。
在切换前发现问题,回滚相对简单:停止目标端准备工作,恢复应用指向源库,解除源库维护限制,并保留问题记录。在目标库尚未接收任何生产写入的情况下,通常可以直接恢复业务。
切换后如果目标库已经产生新写入,则不能简单把连接地址改回源库。此时需要先停止目标端写入,明确这些新增数据是反向同步、人工补录还是按业务规则舍弃,再决定是否回退。若没有预先设计反向复制或数据对账方案,强行切回可能造成订单重复、库存回退或流水缺失。

因此,最终回滚条件应在变更前写入方案,包括触发指标、负责人、最大观察时间和数据处理方式。只有当目标库已经完成校验、业务写入稳定、观察窗口覆盖关键任务,并且确认不存在双主写入风险后,才适合解除源库只读保留和迁移期间的临时限制。
本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/3966.html



