在 Ubuntu 上使用 pgAdmin 导入数据的实用步骤
一 准备工作
- 安装并启动 PostgreSQL 与 pgAdmin 4（桌面或服务器模式均可）。
- 在 pgAdmin 中注册服务器：名称自定义，主机填写 127.0.0.1（本机）或服务器 IP，端口 5432，输入数据库用户与密码保存。
- 规划目标库：导入前先创建空库（或使用既有库），并确保登录用户具备相应权限（如 CREATE、INSERT 等）。
- 准备数据文件：SQL 脚本（.sql）、自定义归档（.backup/.dump/.tar）或 CSV（用于单表导入）。
二 三种常用导入方式与步骤
- SQL 脚本导入（.sql）
- 方式 A（图形界面）：在目标数据库上右键选择 Restore，文件类型选 SQL，选择 .sql 文件后开始恢复；若失败，可改用方式 B。
- 方式 B（查询工具）：打开菜单 工具 → 查询工具，点击 打开文件 载入 .sql，执行全部语句完成导入。
- 自定义格式备份导入（.backup/.dump/.tar）
- 在目标数据库上右键 Restore，选择自定义归档文件，保持与备份时一致的格式选项，开始恢复。
- CSV 单表导入
- 在目标表上右键 Import/导出，选择 CSV，设置分隔符（如 ,）、是否包含列名、编码（推荐 UTF-8），指向 CSV 文件后执行导入。
三 常见报错与快速排查
- 路径或权限问题：Restore 时文件路径不要包含空格；若提示权限不足，改用拥有数据库权限的系统用户（如 postgres）执行，或调整文件权限与属主。
- 编码错误：CSV 导入报 “invalid byte sequence” 等，先将文件保存为 UTF-8 再导入。
- 认证或连接失败：核对主机、端口、数据库名、用户名与密码；必要时在 pgAdmin 中测试连接。
- SQL 脚本导入失败：优先用查询工具逐条执行定位问题；若仍失败，改用命令行导入（见下文）。
四 命令行备选方案（更稳定）
- SQL 脚本
- 先创建库：createdb -U postgres your_db
- 执行脚本：psql -U postgres -d your_db -f /path/file.sql
- 自定义归档
- pg_restore -U postgres -d your_db /path/file.backup
- 适用场景：图形界面不稳定、文件较大或需要自动化时使用命令行更可靠。