PostgreSQL 数据库使用 psql 导入 SQL

在 PostgreSQL 中使用 psql 导入包含 COPY FROM stdin 格式的 SQL 文件时，需注意以下关键步骤和参数说明：

• 参数解析：

  -h：数据库服务器地址（如本地可省略或设为 localhost）。

  -p：PostgreSQL 服务端口（默认 5432，示例中为 5433）。

  -U：登录用户名（需有目标表的写入权限）。

  -W：强制提示输入密码（避免密码明文暴露在命令行）。

  -d：目标数据库名称。

  < dump.sql：重定向输入文件（包含 COPY 命令的 SQL 脚本）。

• 关键结构：

  COPY public.table_name (column1, column2, ...) FROM stdin;data_row1_value1 data_row1_value2 ...data_row2_value1 data_row2_value2 ....

  终止符 .：必须独占一行且无空格，标志数据输入结束。

  字段分隔：默认使用制表符（t），若数据包含制表符需显式指定分隔符（如 DELIMITER ','）。

• 示例文件内容：

  -- 表结构注释（可选）COPY public.upload_references (id, upload_id, target_type, target_id, created_at, updated_at) FROM stdin;45698 760 Post 667 2023-05-05 04:11:35.947138 2023-05-05 04:11:35.94715642396 6674 Post 3903 2023-05-05 01:59:37.447183 2023-05-05 01:59:37.447202.

• 权限不足：

  确保用户有目标表的 INSERT 权限，或使用超级用户（不推荐生产环境）。

  错误示例：ERROR: permission denied for table upload_references

• 连接失败：

  检查 pg_hba.conf 是否允许客户端地址连接。

  测试连接：psql -h 127.0.0.1 -p 5433 -U username -d database_name -c "SELECT 1"

• 数据格式错误：

  若字段包含换行符或特殊字符，改用 COPY FROM PROGRAM 或导出为 CSV 后导入：COPY public.table_name FROM '/path/to/file.csv' WITH (FORMAT csv, HEADER true);

若 psql 导入失败，可尝试以下方式：

1. 使用 copy 命令（在 psql 交互模式下）：

   copy public.upload_references FROM '/path/to/dump.sql' WITH (FORMAT text, DELIMITER 't')

   优势：无需服务器文件权限，适合本地调试。

2. 转换为 INSERT 语句：

   通过脚本将 COPY 数据转换为 INSERT 语句（适用于小数据量）。

导入完成后，检查数据是否成功写入：

或查看最近导入的记录：

• 终止符不可省略：缺少 . 会导致 psql 持续等待输入。
• 字符编码：确保 SQL 文件与数据库编码一致（如 UTF-8）。
• 大文件处理：超大文件建议分块导入或使用 pg_restore（针对 pg_dump 格式）。

通过以上步骤，可高效完成 PostgreSQL 中 COPY FROM stdin 格式数据的导入。如遇特定错误，建议结合 PostgreSQL 日志（log_statement = 'all'）进一步排查。