Linux pgAdmin如何执行数据迁移

Linux 上 pgAdmin 数据迁移实操指南

一 明确迁移范围

• 迁移 PostgreSQL 数据库内容：迁移的是业务数据本身，与 pgAdmin 工具无关。常用方式是备份与恢复（自定义格式、tar 或 SQL 脚本）。
• 迁移 pgAdmin 自身的配置与服务器清单：迁移的是你在 pgAdmin 中保存的服务器连接、用户偏好等元数据，便于在新环境快速复用连接。

二 迁移 PostgreSQL 数据库内容

• 方式 A GUI（pgAdmin）
  1. 在 pgAdmin 左侧连接到源服务器，右键目标数据库选择 Backup…，选择格式 .custom/.tar，生成备份文件。
  2. 在目标服务器创建同名空库（或按需新建），右键该库选择 Restore…，选择备份文件，按需勾选 Pre-data/Data/Post-data，执行恢复。
  3. 适合中小规模数据、需要可视化操作的场景。
• 方式 B 命令行（推荐用于生产与大库）
  1. 备份为自定义格式（支持并行与选择性恢复）：

     pg_dump -h 源主机 -U 用户名 -F c -b -v -f backup.custom 数据库名

  2. 传输到目标机器：

     scp backup.custom 用户名@目标IP:/路径/

  3. 在目标库恢复：

     pg_restore -h 目标主机 -U 用户名 -d 数据库名 -v backup.custom

  4. 纯 SQL 脚本方式（.sql）：

     # 导出pg_dump -h 源主机 -U 用户名 -f backup.sql 数据库名# 导入psql -h 目标主机 -U 用户名 -d 数据库名 -f backup.sql

  5. 常用选项：自定义格式可用 -j N 并行恢复；若目标库非空，先评估清空或使用新库名以避免冲突。

三 迁移 pgAdmin 自身的配置与服务器清单

• 迁移服务器连接与偏好（适合 Desktop 版）
  • 备份用户目录下的配置：通常为 ~/.pgadmin/（包含 servers.json 等）。
  • 在新机器安装同版本 pgAdmin 后，先启动一次生成配置目录，再用 rsync/scp 覆盖 ~/.pgadmin/，重启 pgAdmin 检查服务器列表。
• 迁移服务器端 pgAdmin（RPM/DEB 包部署，如系统包安装）
  • 备份配置与数据目录：常见为 /etc/pgadmin/ 与 /var/lib/pgadmin/。
  • 同步到新机器的相同路径，注意目录属主与权限（如 postgres 或 pgadmin 运行用户），然后重启服务（如 systemd 管理的 pgAdmin 服务）。
  • 完成后登录验证服务器连接、用户书签与偏好是否完整。

四 关键注意事项与常见问题

• 版本兼容
  • 尽量保持 PostgreSQL 版本与 pgAdmin 版本在源与目标环境一致；跨大版本恢复自定义格式可能遇到兼容性问题，必要时先用 SQL 脚本或按对象逐步迁移。
• 文件格式与工具匹配
  • .custom/.tar：用 pg_restore；支持并行与分节恢复。
  • .sql：用 psql 执行；适合跨平台与版本迁移，但大库执行时间与资源占用较高。
• 目标库状态与数据一致性
  • 恢复前确认目标库为空或采用新库名；若需覆盖，先做好备份与回滚方案。
  • 大数据集建议分批或并行恢复，并在低峰时段执行。
• 权限与编码
  • 执行恢复操作的数据库用户需具备足够权限（常见为超级用户或具备相应对象权限）。
  • 确保源与目标库 **编码（常见为 UTF8）**一致，避免导入后乱码。
• 传输与校验
  • 使用 scp/rsync 传输备份文件，完成后校验文件大小或哈希，确保一致性。