在 pgAdmin 中进行数据迁移的实用方法
一 迁移方式总览
- 表级数据导入导出：适合小中规模数据、按表迁移或做增量同步。
- 整库备份与恢复：适合一次性整体迁移，含结构、数据、索引、外键等。
- 跨版本与跨平台：优先使用自定义归档格式（.backup/.dump），必要时再做兼容性评估与测试。
二 表级导入导出步骤（图形界面）
- 连接服务器：在左侧对象浏览器中右键Servers > Create > Server…，填写主机名/IP、端口 5432、维护数据库 postgres、用户名/密码并保存。
- 导出单表或查询结果：
- 右键目标表 > Export…，选择CSV/JSON/SQL等格式；CSV 需设置分隔符、引号、是否包含列名等选项后执行。
- 或使用Query Tool执行查询，结果面板点击Save results to file导出为CSV等。
- 导入到表：
- 右键目标表 > Import…，选择数据源文件，配置分隔符/编码/是否包含列名等，确保与导出选项一致后执行。
- 适用场景：按表迁移、结构已存在、需要灵活控制字段与过滤条件。
三 整库备份与恢复（适合全量迁移）
- 方式 A（推荐，适合跨版本/含大对象）：使用自定义归档
- 备份：在终端执行
- pg_dump -U username -h hostname -d dbname -F c -b -v -f backup_file.backup
- 传输：使用scp等工具将备份文件复制到目标服务器
- scp backup_file.backup user@new_host:/path/
- 恢复：在目标服务器先创建空库（如 CREATE DATABASE），再执行
- pg_restore -U username -h hostname -d dbname /path/backup_file.backup
- 方式 B（纯 SQL 脚本，便于审阅/版本控制）
- 备份：pg_dump -U username -h hostname -d dbname -f backup_file.sql
- 恢复：psql -U username -h hostname -d dbname -f backup_file.sql
- 说明：自定义归档（-F c）可保留大对象并支持并行恢复，适合生产环境全量迁移。
四 迁移 pgAdmin 自身的配置与服务器列表（可选）
- 迁移对象：pgAdmin 4 的服务器配置、连接历史、偏好设置等（不含被管理的数据库数据）。
- 默认存储位置：
- Linux：配置多在**/etc/pgadmin**，数据多在**/var/lib/pgadmin**；用户级配置常见于**~/.pgadmin**。
- 桌面版：配置通常在用户主目录的**.pgadmin**文件夹。
- 迁移步骤：
- 备份上述目录（如使用rsync或scp），在新环境对应路径恢复。
- 首次启动 pgAdmin 后，必要时在界面中调整连接信息与路径。
五 常见问题与最佳实践
- 版本兼容：尽量保持源/目标 PostgreSQL 与 pgAdmin 版本一致；跨版本迁移先做小样本演练，必要时调整数据类型/默认值/索引/扩展。
- 大对象与性能：整库迁移优先用自定义归档（-F c）；大数据量建议分批导入、关闭自动提交、必要时禁用/重建索引与触发器后再恢复，最后再启用。
- 字符集与分隔符：导出CSV时统一客户端/服务端编码（常见 UTF8）与分隔符，避免导入乱码或列错位。
- 权限与依赖：迁移后检查OWNER/GRANT、SEQUENCE 当前值、外键/检查约束、**扩展（如 postgis）**是否完整。
- 一致性校验：迁移后用COUNT/校验和/抽样对比核验关键表数据一致性与约束有效性。