Azure Postgres Flexible Server 12升16无停机迁移方案咨询

核心实施方案步骤 #

• 创建并配置目标实例：部署Postgres 16版本的Flexible Server，对齐源实例的VNet、防火墙规则、存储配置等网络和基础参数；同时调整目标实例的max_replication_slots、max_wal_senders参数（建议设为10以上，根据负载调整），确保支持订阅同步。
• 同步数据库结构：使用pg_dump的仅schema模式导出源库结构，避免导出数据：

  pg_dump -s -d source_database -U admin_user -h source-server.postgres.database.azure.com -p 5432 -f schema.sql
  

  将导出的schema文件在目标实例执行，完成结构初始化：

  psql -d target_database -U admin_user -h target-server.postgres.database.azure.com -p 5432 -f schema.sql
  

  注意：需确保序列、函数、触发器等对象与源库完全一致，避免后续数据同步冲突。
• 启用源实例逻辑复制（CDC）：
  1. 修改源实例参数：将wal_level设为logical，调整max_replication_slots和max_wal_senders至合理值，重启源实例（此为唯一短暂停机点，建议提前规划低峰窗口）。
  2. 为所有需要迁移的表开启全量复制标识：

     ALTER TABLE your_table_name REPLICA IDENTITY FULL;
     

     若需批量处理，可生成批量执行脚本：

     SELECT 'ALTER TABLE ' || schemaname || '.' || tablename || ' REPLICA IDENTITY FULL;' FROM pg_tables WHERE schemaname = 'public';
     

  3. 创建逻辑发布，覆盖需迁移的表：

     CREATE PUBLICATION pub_full_sync FOR ALL TABLES; -- 或指定特定表：FOR TABLE table1, table2
     

• 建立目标实例订阅：连接目标数据库，创建订阅指向源实例的发布：

  CREATE SUBSCRIPTION sub_full_sync 
  CONNECTION 'host=source-server.postgres.database.azure.com port=5432 dbname=source_database user=admin_user password=your_password sslmode=require' 
  PUBLICATION pub_full_sync;
  

• 验证同步状态：通过以下SQL查看订阅同步进度，确认初始全量同步完成：

  SELECT subname, sync_state, latest_end_lsn FROM pg_stat_subscription;
  

  同步完成后，需手动校验关键表的数据一致性（比如对比行数、随机抽样字段值、聚合函数结果等）。
• 业务流量切换：
  1. 将应用切换至只读模式（或暂停写入），等待订阅同步最后一批增量数据，确保延迟趋近于0。
  2. 将应用连接字符串切换至目标Postgres 16实例，恢复写入操作。
• 清理冗余资源：确认业务稳定运行后，删除源实例的pub_full_sync发布和目标实例的sub_full_sync订阅，若无需保留源实例，可后续按需销毁。

关键注意事项 #

• 网络连通性：源与目标实例需处于同一VNet，或通过VNet peering、防火墙规则打通5432端口，确保订阅能建立稳定连接。
• Postgres版本兼容性：提前验证应用对Postgres 16的兼容性，比如废弃的语法（如pg_stat_user_tables的seq_scan字段已移除）、新增特性的适配，避免切换后出现业务异常。
• CDC覆盖范围：必须确保所有需要同步的表都设置了REPLICA IDENTITY FULL，否则UPDATE/DELETE操作的同步会失败或丢失数据。
• 同步延迟监控：同步过程中持续监控pg_stat_subscription的latest_end_lsn与源实例pg_current_wal_lsn()的差值，确保切换前延迟在可接受范围内。
• 权限配置：源实例的操作用户需拥有REPLICATION权限，目标实例的操作用户需拥有CREATE SUBSCRIPTION权限。
• 大表与高负载场景：若源库存在超大表，初始全量同步耗时较长，建议在低峰期启动；高负载场景下，可临时调大源实例的wal_buffers参数，提升同步效率。

内容的提问来源于stack exchange，提问作者Waseem Mir