在 Debian 上使用 pgAdmin 进行数据迁移
一 迁移场景与准备
- 明确迁移对象：是迁移业务数据（PostgreSQL 数据库），还是迁移 pgAdmin 自身的配置与服务器清单（元数据）。前者用 pgAdmin 的备份/恢复或导出/导入，后者通过拷贝配置与数据目录完成。
- 安装与访问：在 Debian 上安装 pgAdmin 4 后，通常通过浏览器访问 http://localhost/pgadmin4 登录管理界面。
- 版本与权限：确认源/目标 PostgreSQL 版本兼容（跨大版本如 12→15 一般可行但需验证对象兼容性）；用于迁移的账号需具备导出（如 SELECT）与导入（如 INSERT/CREATE）权限，结构变更还需 ALTER/DROP。
- 备份先行：迁移前对源库做一次完整备份（pgAdmin 的“备份”或命令行工具），以防数据丢失。
二 迁移 PostgreSQL 业务数据（推荐流程）
- 连接源库与目标库：在 pgAdmin 左侧“Servers”中新增并保存源与目标 服务器连接（主机、端口默认 5432、用户名、密码）。
- 方式 A 备份/恢复（适合整库迁移）
- 源库：右键数据库 → 任务 → 备份，格式选 SQL（如需保留结构/索引/权限一并勾选），保存到本地或可达存储。
- 目标库：先在目标实例创建同名空库（或使用已有库）；右键目标库 → 任务 → 恢复，选择上一步的 .sql 文件开始恢复。
- 方式 B 导出/导入（适合表级或跨格式迁移）
- 导出：右键数据库或表 → 导出数据…，格式可选 SQL（结构+数据）或 CSV（仅数据）；CSV 需设置字段分隔符（如 ,）与文本限定符（如 "）。
- 导入：在目标库/表右键 → 导入/导出数据…，选择与导出一致的格式与参数；CSV 需保持分隔符/限定符一致，并注意“覆盖/追加”选项。
- 一致性校验：在目标库用查询工具对比关键表的 COUNT(*) 与抽样数据，确认记录数与业务规则正确。
三 迁移 pgAdmin 自身的配置与元数据
- 适用场景：在新 Debian 主机上复用原有的服务器连接、用户收藏、布局等。
- 备份与恢复步骤：
- 备份：复制 /etc/pgadmin（配置）与 /var/lib/pgadmin（数据与会话）到安全位置（可用 rsync/scp）。
- 恢复：将备份目录放置到新主机的相同路径，确保权限与属主正确（如 postgres 或运行 pgAdmin 的系统用户），然后启动 pgAdmin 验证服务器列表与登录信息。
四 常见问题与优化
- 权限不足：导入报错 permission denied 时，为目标用户授予 CREATE/INSERT（必要时 ALTER/DROP）权限，或使用 postgres 管理员账户执行。
- 版本不兼容：导入出现语法错误或函数不存在，多为 PostgreSQL 版本差异；可调整 SQL、改用兼容语法，或在两端做小范围适配后再导入。
- 大文件导入慢：对 >1GB 的 SQL 可拆分执行；在目标端适当调整 work_mem、maintenance_work_mem 等参数以提升导入速度。
- 数据不一致：核对 COUNT(*)、主键范围、外键约束与索引；必要时抽样对比明细。
- 需要持续同步：可使用 pgAdmin 的 数据比较/数据同步 功能对比两库差异并同步，适合准实时或定期对齐。
五 命令行替代方案（适合自动化与超大库）
- 整库逻辑备份/恢复：使用 pg_dump 与 psql
- 备份：pg_dump -h 源主机 -U 用户 -F c -b -v -f mydb.dump mydb
- 恢复：psql -h 目标主机 -U 用户 -d mydb -f mydb.dump
- 自定义格式与并行：pg_dump -F c --jobs=4 …；恢复用 pg_restore -j 4 … 提升速度。
- 纯文本 SQL 导入：psql -f mydb.sql target_db（适合小体量或结构+数据一体的脚本）。
