在 Debian 上迁移 pgAdmin 的可行方案
- 迁移对象通常分为两类：
- 被管理的 PostgreSQL 数据库（业务数据）；
- pgAdmin 自身的配置与服务器书签（连接定义、布局等）。
下文分别给出在 Debian 上的标准做法与关键注意事项，覆盖命令行与 pgAdmin 图形界面两种路径，便于按场景选择。
迁移被管理的 PostgreSQL 数据库
-
方式一 逻辑备份与恢复（跨版本、跨平台通用）
- 导出（源库）：
- 纯 SQL 脚本（便于审阅与跨版本）：
pg_dump -h 源主机 -U 用户名 -p 端口 -d 数据库名 -f dbname.sql
- 自定义归档（便于选择性恢复、含大对象）：
pg_dump -h 源主机 -U 用户名 -p 端口 -F c -b -v -f dbname.backup 数据库名
- 传输：
scp dbname.sql 用户名@目标主机:/路径/
或 scp dbname.backup 用户名@目标主机:/路径/
- 恢复（目标库）：
- 若为 .sql：先创建空库（createdb -U 用户名 dbname），再
psql -h 目标主机 -U 用户名 -d dbname -f dbname.sql
- 若为 .backup（自定义格式）：
pg_restore -h 目标主机 -U 用户名 -d dbname dbname.backup
- 说明：自定义格式（-F c）与 pg_restore 支持按表/模式选择性恢复，适合大型库与灰度迁移。
-
方式二 仅迁移表数据（CSV 批量导入导出）
- 导出：
COPY 表名 TO ‘/路径/文件.csv’ DELIMITER ‘,’ CSV HEADER;
- 导入：
COPY 表名 FROM ‘/路径/文件.csv’ DELIMITER ‘,’ CSV HEADER;
- 说明：适合 ETL、分表/分批次迁移或对接外部系统数据。
-
方式三 使用 pgAdmin 图形界面备份与恢复
- 备份：在 pgAdmin 中右击数据库 → Backup…，可选 “Backup as plain SQL” 或 “Backup as custom tarball”。
- 恢复：在目标库上右击 → Restore…，选择相应备份文件；如使用自定义归档，优先用 pg_restore 以获得更灵活的选项。
迁移 pgAdmin 自身的配置与服务器书签
- 迁移服务器配置与存储目录（适合同版本或相近版本）
- 备份目录：
- 配置：/etc/pgadmin/
- 数据与书签：/var/lib/pgadmin/
- 在新 Debian 主机上安装同版本 pgAdmin 后，先停止服务，再同步目录：
rsync -a /etc/pgadmin/ 新主机:/etc/pgadmin/
rsync -a /var/lib/pgadmin/ 新主机:/var/lib/pgadmin/
启动服务后，原有服务器连接与布局应可用。
- 仅迁移连接定义（轻量做法）
- 在 pgAdmin 中导出连接（若界面提供）或在新环境手动新建服务器连接；必要时更新 pgAdmin 配置文件（如 /etc/pgadmin/pgadmin.conf）中的连接参数。
版本兼容性与验证要点
- 版本策略：尽量保持 PostgreSQL 与 pgAdmin 的源/目标版本一致；跨大版本迁移时优先使用逻辑备份（SQL 脚本或自定义归档），并在测试环境演练。
- 一致性校验：迁移后执行行数与抽样查询对比，核对约束、索引、触发器、视图、外键与权限；大对象（如 BYTEA、Large Object）需单独验证可用性。
- 传输与完整性：使用 scp/rsync 并校验文件完整性（如校验和），避免中断导致的半文件恢复。
常见坑与实用建议
- 路径与权限：确保运行 pgAdmin/PostgreSQL 的系统用户对备份与恢复目录具备读写权限；归档恢复时目标库需事先存在（pg_restore 不自动建库）。
- 大库与性能：自定义归档配合 pg_restore -j N 并行恢复可显著提速；超大表可分模式/分表迁移并控制事务批次。
- 字符集与格式：导出/导入统一使用 UTF-8；CSV 注意分隔符、引号与换行处理，避免解析错位。
- 扩展与依赖：若源库使用扩展（如 postgis、uuid-ossp 等），目标库需提前 CREATE EXTENSION，否则恢复会报错。