Ubuntu 上使用 pgAdmin 导入数据的常用方法
在 Ubuntu 上，pgAdmin 提供图形化界面完成数据库对象的导入导出与数据文件导入。以下按场景给出可直接操作的步骤与要点，覆盖 SQL 脚本、整库备份、以及 CSV 批量导入三种高频需求。
方法一 运行 SQL 脚本导入结构与数据
- 打开 pgAdmin 4，在左侧树连接到目标服务器，右键目标数据库选择 Query Tool（查询工具）。
- 在查询工具中点击 打开文件，选择你的 .sql 脚本，检查无误后点击 运行（或按 F5）。
- 适用：执行建表、索引、函数以及 INSERT 等 DML 脚本；若脚本包含建库语句，请先在 pgAdmin 中创建空库再执行。
方法二 整库备份与还原（.backup 自定义格式）
- 备份（在终端执行，非 pgAdmin 内）：
- 命令示例：pg_dump -U username -W -F c -b -v -f backup_file.backup database_name
- 说明：
- -F c 为自定义归档格式，便于跨版本迁移与选择性恢复；
- -b 包含大对象（如 BLOB）；
- -W 执行时提示输入密码。
- 将备份文件传输到目标机器（示例）：scp backup_file.backup user@host:/path/
- 还原（在目标机器执行，非 pgAdmin 内）：
- 命令示例：pg_restore -U username -W -d database_name /path/backup_file.backup
- 说明：
- 若目标库不存在，先创建空库；
- 自定义格式支持按对象过滤与并行恢复（配合 -j 选项）。
- 在 pgAdmin 中也可完成同等操作：右键数据库选择 Backup（导出为 .backup），以及右键数据库选择 Restore（导入 .backup）。
方法三 批量导入 CSV 到表（Import/Export）
- 准备数据：
- 将 Excel 另存为 CSV，建议编码为 UTF-8；
- 确认列顺序与目标表一致，必要时在导入时指定列映射。
- 在 pgAdmin 中导入：
- 在左侧树展开到目标表，右键选择 Import/Export。
- 关键设置：
- 方向选择 Import；
- 选择 CSV 文件；
- 勾选 Header（若首行为列名）；
- 设置 Delimiter（如逗号 ,）、Quote（如双引号 "）、NULL（如空字符串或 \N）；
- 指定目标表的列列表（如需重排或跳过列）。
- 点击 OK 执行，查看消息输出确认导入行数与错误。
- 命令行等价方式（psql 中使用 \copy，适合客户端本机文件）：
- 示例：\copy public.users(username,email,created_at) FROM ‘/path/users.csv’ WITH (FORMAT csv, HEADER);
- 说明：\copy 在客户端执行，文件路径为客户端本地；服务器端导入需用 COPY 且文件需在数据库服务器可访问路径下。
常见问题与排查要点
- 权限与路径：
- 服务器端 COPY 要求文件对数据库进程可读；客户端 \copy 要求文件对本地 psql 可读；
- 若报 “Permission denied”，检查文件权限与属主，或改用 \copy。
- 编码与格式：
- 中文乱码常见于非 UTF-8 文件；请统一为 UTF-8 并在导入时明确编码；
- 分隔符、引号、NULL 表达需与文件实际一致（如 DELIMITER ‘;’、NULL ‘\N’）。
- 版本与兼容性：
- 自定义归档 .backup 跨小版本通常兼容；跨大版本或不同平台迁移时，建议先在测试环境演练；
- 若 pgAdmin 界面报不可恢复错误，可改用命令行 pg_restore 获取更详细输出。
- 大数据量建议：
- 批量导入优先考虑 COPY/\copy 或 pg_restore；必要时分批提交或使用服务器端并行恢复以提升速度。