Ubuntu 下使用 pgAdmin 进行数据库迁移的实用技巧
一、先明确迁移对象与总体流程
- 迁移对象通常包含两类：一是实际的 PostgreSQL 数据库（表、索引、数据、大对象等），二是 pgAdmin 自身的配置与服务器书签（连接信息、布局等）。前者用 pg_dump/pg_restore 或 pgAdmin 的 Backup/Restore 完成；后者通过拷贝配置目录（如 ~/.pgadmin、/etc/pgadmin、/var/lib/pgadmin）在新环境复用。总体流程建议：准备与评估 → 备份源库 → 传输备份 → 在目标库恢复 → 校验与切换。对于大对象与一致性要求，优先使用自定义或目录归档格式；跨版本或跨平台时，注意版本兼容与编码一致。
二、数据库迁移的三种常用方式
- 方式 A｜pgAdmin GUI（适合中小规模、可视化操作）
- 备份：在左侧树中右键数据库 → Backup…，选择格式（.custom/.tar/.plain）、文件路径，按需勾选“Pre-data/Data/Post-data”，执行备份。
- 恢复：在目标数据库上右键 → Restore…，选择备份文件与恢复选项（可按需只恢复结构或数据），执行恢复并查看日志。
- 方式 B｜命令行（适合自动化与大数据库）
- 备份为自定义归档（便于并行与包含大对象）：
- pg_dump -U username -W -F c -b -v -f backup_file.backup dbname
- 恢复到目标库：
- pg_restore -U username -W -d dbname /path/backup_file.backup
- 仅导出/导入结构或数据：
- 仅结构：pg_dump -U username -W -s dbname > structure.sql
- 仅数据：pg_dump -U username -W -a dbname > data.sql
- 纯文本 SQL 脚本导入（适合版本不兼容自定义归档的场景）：
- psql -U username -d dbname -f backup.sql
- 方式 C｜仅迁移部分数据或表
- 导出指定表/模式：
- pg_dump -U username -W -t schema.table -F p dbname > table.sql
- pg_dump -U username -W -n schema dbname > schema.sql
- 导出为 INSERT 语句（便于在已有表结构下插入）：
- 带列名（更稳健）：pg_dump -U username -W --column-inserts -t table dbname > inserts.sql
- 不带列名（更紧凑）：pg_dump -U username -W --inserts -t table dbname > inserts.sql
三、跨版本与兼容性处理
- 版本一致优先：备份与恢复的 PostgreSQL 版本尽量一致，可减少对象定义与特性差异带来的问题。
- 高版本到低版本的稳妥做法：避免使用自定义归档（.custom），改用 纯文本 SQL 脚本（.sql），通过 psql 在目标库执行恢复，兼容性更好。
- 编码一致：导出与导入时显式指定 UTF-8（如 pg_dump 的 -E UTF8），避免乱码。
- 大对象与并行：自定义（-F c）或目录（-F d）归档支持包含 BLOBs 与并行恢复（如 -j 4），大数据量时更高效。
- 目标库准备：恢复前确保目标库已创建（或使用模板/空库），并且连接用户具备足够权限。
四、迁移 pgAdmin 配置与书签
- 迁移范围：pgAdmin 的配置与服务器书签通常位于用户目录 ~/.pgadmin，以及系统级目录 /etc/pgadmin、/var/lib/pgadmin（不同安装方式与版本路径可能不同）。
- 操作步骤：
- 在旧环境备份上述目录（如使用 tar 或 rsync）。
- 将备份复制到新环境相同路径并解压/覆盖（注意权限与 SELinux/AppArmor 策略）。
- 首次启动 pgAdmin 检查服务器树与连接是否正常；如有路径或权限变化，需在界面中调整。
五、性能优化与常见坑
- 并行与分片：大数据量导出/恢复使用目录格式（-F d）并配合 -j N 并行；超大文件可分片传输与校验。
- 一致性：导出期间尽量避免写入，必要时在维护窗口执行；恢复前确认目标库为空或采用新库名避免冲突。
- 权限与角色：确保执行用户具备 SUPERUSER 或所需对象权限；跨库迁移时，注意 OWNER/GRANT 是否一并迁移并在目标库补齐角色。
- 校验与回滚：恢复后抽样校验表行数、关键约束与大对象；保留一份可回滚的备份，切换前再次确认应用连接串与连接池配置。
- 传输与存储：使用 scp/rsync 校验完整性（如 sha256sum），并妥善保护包含敏感数据的备份文件。