在 Debian 上通过 pgAdmin 进行数据迁移
一 迁移目标与准备
- 明确迁移对象：迁移的是业务数据（PostgreSQL 数据库），而非 pgAdmin 自身的配置。pgAdmin 只是管理工具，可在迁移后重新建立服务器连接。
- 版本与兼容性：尽量保持源与目标 PostgreSQL 大版本一致；跨小版本通常可用 自定义格式（-F c） 的备份/恢复，但对象定义或扩展差异仍可能导致失败，需提前评估。
- 权限与网络：准备具有足够权限的数据库账号（如 SUPERUSER 或具备 pg_dump/pg_restore 权限），并打通源/目标主机的 5432 端口与防火墙策略。
- 工具与空间：在 Debian 上安装 pgAdmin 4（桌面/服务器模式均可），并为备份文件预留充足磁盘空间。
二 方法一 使用 pgAdmin 备份与恢复（图形化）
- 备份（源库）
- 在 pgAdmin 左侧对象树中右击目标数据库 → Backup…。
- 选择格式：
- Plain Text SQL（便于跨版本、跨平台查看与编辑）
- Custom/Tarball（-F c）（保留对象依赖与大对象，适合同版本或相近版本恢复）
- 指定输出文件路径与角色，开始备份。
- 传输备份文件
- 使用 scp/rsync 将备份文件从源机复制到目标机（保持文件完整性与权限）。
- 恢复（目标库）
- 在 pgAdmin 中右击目标数据库 → Restore…，选择上一步的备份文件与格式。
- 指定目标数据库（必要时先建空库）、角色与参数，开始恢复。
- 适用场景
- 同构或近构环境、需要跨服务器/跨云平台迁移、希望减少命令行操作。
三 方法二 使用 pg_dump 与 pg_restore（命令行，适合自动化与大规模）
- 逻辑备份（自定义格式，推荐）
- 源库导出：
- pg_dump -h 源主机 -U 用户名 -p 5432 -F c -b -v -f dbname.backup dbname
- 目标库恢复：
- 先创建空库（与源库同名或按规划命名）：createdb -h 目标主机 -U 用户名 -O 属主 dbname
- pg_restore -h 目标主机 -U 用户名 -d dbname -v dbname.backup
- 逻辑备份（纯 SQL 脚本）
- 源库导出：pg_dump -h 源主机 -U 用户名 -p 5432 -f dbname.sql dbname
- 目标库恢复：psql -h 目标主机 -U 用户名 -d dbname -f dbname.sql
- 适用场景
- 自动化脚本、CI/CD、批量迁移、需要细粒度控制恢复过程。
四 方法三 跨库复制与 CSV 导入导出（灵活适配不同结构）
- CSV 导出/导入
- 在 pgAdmin 的 SQL 编辑器中将查询结果导出为 CSV（或使用 COPY TO），在目标库用 COPY FROM 或 pgAdmin 的导入向导导入；适合表级迁移或抽取子集数据。
- PostGIS 场景
- 使用 PostGIS 的 Shapefile and DBF Loader 将空间数据导出为 Shapefile，再导入目标库；适合地理空间数据迁移。
- 适用场景
- 表结构差异较大、只需迁移部分表/数据、空间数据专项迁移。
五 验证与常见问题
- 迁移后验证
- 在 pgAdmin 中检查：表数量、数据量、主键/外键、索引、触发器、视图、函数、扩展（如 PostGIS）是否完整。
- 执行关键业务查询与回归测试，确认结果与性能符合预期。
- 常见问题与处理
- 版本不兼容：优先使用 -F c 备份并在目标库用 pg_restore；若失败，改用 纯 SQL 脚本并手动处理不兼容对象。
- 扩展/对象差异：在目标库提前 CREATE EXTENSION（如 postgis），必要时调整 DDL。
- 权限与属主：恢复后检查 OWNER/GRANT，确保应用账号权限正确。
- 大对象与性能：大数据量建议分表/分批恢复，或使用 并行/ jobs 参数加速（pg_restore 支持）。
- 字符集与本地化：CSV/Shapefile 导入时注意 编码（如 GBK/UTF-8） 与 几何坐标系 一致性。