Debian 下使用 pgAdmin 进行 PostgreSQL 数据库的导入导出
一 环境准备与连接
- 在 Debian 上安装并启动 PostgreSQL 与 pgAdmin（桌面或 Web 模式均可）。
- 打开 pgAdmin，注册服务器：主机填写 127.0.0.1（本机）或服务器 IP/域名，端口 5432，输入具有足够权限的数据库用户与密码，保存并连接。
- 在左侧树形导航中确认目标服务器、数据库可见，必要时创建目标数据库用于导入。
二 使用 pgAdmin 备份与还原数据库
- 备份（导出）数据库
- 在左侧树形中右键目标数据库，选择 Backup…。
- 在对话框中设置：
- 文件名：如 /path/to/db_backup.sql 或 /path/to/db_backup.dump。
- 格式：选择 Plain（生成 .sql 脚本）或 Custom/Tar（便于后续选择性恢复）。
- 点击 Backup 开始，右下角显示进度，完成后提示成功。
- 还原（导入）数据库
- 若导入到新库，先右键 Servers → Databases 创建空数据库（字符集与排序规则与原库一致）。
- 右键目标数据库，选择 Restore…，指定备份文件路径，选择格式与相应选项，点击 Restore 开始。
- 进度完成后在对象树中检查表、视图、数据是否已恢复。
三 使用 pgAdmin 导入导出表数据 CSV
- 导出表数据
- 在左侧展开目标数据库 → Schemas → public → Tables，右键目标表，选择 Import/Export…。
- 选择 Export，设置：
- 文件名：如 /path/to/table.csv。
- 格式：csv。
- 选项：勾选 Header（导出列名），设置 Delimiter（如 ,），编码 UTF8。
- 点击 OK 开始导出。
- 导入表数据
- 确保目标表已存在且结构与导出端一致（字段顺序、类型、约束等）。
- 右键目标表 → Import/Export…，选择 Import，指向 .csv 文件，设置相同的 Delimiter 与 Header，确认开始导入。
- 大表建议分批导入，或先在测试环境验证。
四 常用命令行备选方案
- 导出为 SQL 脚本
- pg_dump -U username -h hostname -p 5432 -d dbname -f db.sql
- 导出为自定义归档（便于选择性恢复）
- pg_dump -U username -h hostname -p 5432 -F c -f db.dump dbname
- 导入 SQL 脚本
- psql -U username -h hostname -p 5432 -d dbname -f db.sql
- 从自定义归档恢复
- pg_restore -U username -h hostname -p 5432 -d dbname db.dump
- 导出表为 CSV（服务器端文件）
- COPY tablename TO ‘/path/to/file.csv’ WITH (FORMAT csv, HEADER true);
- 导入 CSV 到表（服务器端文件）
- COPY tablename FROM ‘/path/to/file.csv’ WITH (FORMAT csv, HEADER true);
- 说明：CSV 方式适合大数据量；服务器端路径需 postgres 用户可写，客户端导出可用 \copy 写入本地。
五 常见问题与排错要点
- 权限与路径
- 使用 COPY 写入服务器文件时，数据库服务账户必须对目录有写权限；导入前确认目标表已存在且约束兼容。
- 字符集与分隔符
- 导出/导入 CSV 时统一 UTF8 与 Delimiter，并确保 Header 选项一致，避免列错位。
- 大对象与性能
- 大数据量优先使用 Custom/Tar 格式与 pg_restore 的并行选项（如 -j 4），分批导入可显著降低失败风险。
- 版本与兼容性
- 跨大版本恢复时，优先使用 pg_dump/pg_restore 而非直接 SQL 脚本，必要时在目标库调整类型与默认值。