无法将本地CSV导入PostgreSQL，导入后无数据原因排查求助

导入CSV到PostgreSQL后查不到数据，通常是以下几个细节没做好，逐个排查就能解决：

1. 表名拼写不一致 #

你用CREATE TABLE创建的是unicorns表，但导入操作指定的是unicorn（少了末尾的s）——PostgreSQL对表名严格区分（默认小写但拼写错误就是不同表）。这种情况下数据要么导入到了自动创建的unicorn表（如果导入命令允许自动建表），要么直接报错但你没注意到。规避方法：导入前核对表名，确保创建表和导入的表名完全一致。

2. CSV格式与表结构不匹配 #

• 列数对不上：你的unicorns表有8个字段，但如果CSV的列数多了或者少了，导入时要么整行被拒绝，要么数据错位后因类型不匹配被丢弃。打开CSV数一下列数，确保和表字段一一对应。
• 分隔符错误：PostgreSQL默认用逗号分隔CSV，但如果你的CSV是用制表符、分号这类分隔符，又没在导入命令里指定，会导致解析混乱，数据无法正确写入。比如用\copy的话，要加DELIMITER ';'（分号分隔的情况）。
• 引号/转义问题：如果CSV里的字段包含逗号（比如公司名带逗号），必须用双引号包裹；要是引号没闭合或者用了单引号，会导致解析失败。导入时可以显式指定QUOTE '"'来确保识别正确。

3. 导入命令的参数漏了关键项 #

• 文件路径用错：如果是在本地psql客户端操作，别用服务器端的COPY命令，因为服务器访问不到你本地桌面的文件，要用psql专属的\copy命令。比如正确的写法是：\copy unicorns FROM '/你的本地路径/Desktop/unicorn.csv' WITH (FORMAT csv);
• 没跳过表头：如果CSV第一行是字段名（比如company,url,...），导入时必须加HEADER参数，否则会把表头当成数据行导入——而表头里的字符串和last_valuation、year_joined的numeric类型不匹配，整行被拒绝，最终表为空。正确命令：\copy unicorns FROM 'xxx.csv' WITH (FORMAT csv, HEADER);

4. 数据类型不匹配导致全量拒载 #

你的表中last_valuation和year_joined是numeric类型，但CSV里对应字段可能有非数字内容：比如last_valuation带了$、B（比如$10B），或者year_joined是2020年这种带文字的格式，PostgreSQL会直接拒绝这些行。如果所有行都有这类问题，表自然是空的。
规避方法：先清洗CSV数据，把非数字符号去掉；或者先导入到一个全text类型的临时表，清洗后再插入到目标表。

5. 权限不足 #

• 本地文件权限：当前用户要有读取桌面CSV文件的权限，不然\copy命令读不到数据。
• 数据库权限：执行导入的用户必须有unicorns表的INSERT权限，否则数据写不进去。

6. 没关注导入时的错误提示 #

导入过程中PostgreSQL会输出导入行数、拒绝行数的信息，比如\copy执行后会显示COPY 0，说明根本没读到数据；如果有拒绝行数，要查看具体错误原因（可以加LOG ERRORS INTO error_table参数把错误记录到临时表里分析）。

内容的提问来源于stack exchange，提问作者Genesis Bacason