MySQL LOAD DATA 怎样把空字段导入为 NULL

如果 CSV 中某一列是空字段，MySQL LOAD DATA 不会因为它“看起来没有内容”就自动把它当成 SQL NULL。最稳妥的写法是先用用户变量接住原始字段，再在 SET 中用 NULLIF(@变量, '') 显式转换。

官方文档：https://dev.mysql.com/doc/refman/8.4/en/load-data.html

下面的重点是区分三件事：空字符串是一个值，SQL NULL 表示缺失，文件里的文本 NULL 只是普通字符，除非它符合特定的字段解析规则。

先把空字段和 SQL NULL 分开

假设 CSV 行是 1001,张三,，最后一个逗号后没有字符。对常见的逗号分隔格式来说，最后一列通常会先得到空字符串 ''。如果直接把它映射到表列，得到的可能是空字符串，而不是 NULL。

MySQL 文档还规定了另一种专门表示 NULL 的输入：在默认转义规则下，字段写成 \N 才会按 NULL 读取。因此不要把“字段为空”和“字段写了 \N”混成一件事。

用用户变量和 NULLIF 做字段转换

列名列表中，直接写表列表示“读入后直接赋值”；写成 @email 则表示先把输入保存到用户变量。这样就能在 SET 中决定空值规则：

LOAD DATA LOCAL INFILE '/data/customers.csv'
INTO TABLE customer_import
FIELDS TERMINATED BY ',' ENCLOSED BY '"'
LINES TERMINATED BY '\r\n'
IGNORE 1 LINES
(customer_id, customer_name, @email)
SET email = NULLIF(@email, ''); -- 空字符串转为 SQL NULL，非空值原样保留

这里的关键不是 NULLIF 本身，而是把输入列写成 @email。如果直接写 email，就没有一个独立的原始值可以在 SET 中判断。

NULLIF(@email, '') 的语义是：当变量等于空字符串时返回 NULL，否则返回变量原值。若业务还要把只包含空格的字段视作缺失，可以明确写出这个规则：

LOAD DATA LOCAL INFILE '/data/customers.csv'
INTO TABLE customer_import
FIELDS TERMINATED BY ',' ENCLOSED BY '"'
LINES TERMINATED BY '\r\n'
IGNORE 1 LINES
(customer_id, customer_name, @email)
SET email = NULLIF(TRIM(@email), ''); -- 先去首尾空格，再把空文本转为 NULL

第二种写法会改变首尾空格的保留语义，只适合业务确认“首尾空格没有意义”的字段。对需要保留原样的备注、地址或代码字段，不要盲目套用 TRIM。

把 CSV 格式、表头和列顺序一起写清楚

空值转换正确，前提是字段先被正确切分。逗号 CSV、双引号包裹、Windows 换行和首行表头可以组合成下面的结构；示例中的 SQL 注释说明了每个容易错的参数：

LOAD DATA LOCAL INFILE '/data/customers.csv'
INTO TABLE customer_import
CHARACTER SET utf8mb4
FIELDS TERMINATED BY ',' ENCLOSED BY '"' ESCAPED BY '\\'
LINES TERMINATED BY '\r\n'
IGNORE 1 LINES
(@id, @name, @email, @created_at)
SET
  customer_id = NULLIF(@id, ''), -- 输入列为空时写入 SQL NULL
  customer_name = NULLIF(@name, ''), -- 名称为空时也按缺失处理
  email = NULLIF(@email, ''), -- 邮箱为空时不写入空字符串
  created_at = NULLIF(@created_at, ''); -- 日期字段交给列类型或后续规则处理

列名列表的顺序必须对应文件字段顺序。文件顺序和表顺序不同时，使用用户变量能把“输入位置”和“目标列”分离开；如果某个输入字段要丢弃，也可以接到一个不再使用的用户变量，而不是误写入表列。

IGNORE 1 LINES 只负责跳过开头的表头行，不负责空值转换。FIELDS TERMINATED BY、ENCLOSED BY 和 LINES TERMINATED BY 负责让 MySQL 正确识别字段边界；它们写错时，后面的 NULLIF 也只能转换已经被错误切分的值。

\\N、NULL 文本和空字符串要分开看

这几种文件内容看起来相近，但目标值不同。尤其是带引号的 CSV 文本，是否被引号包裹会影响 MySQL 的解释：

如果目标列声明了 NOT NULL，那么显式转换出来的 SQL NULL 仍然不能被该列接受。严格模式下通常会报错并终止相关导入；使用 IGNORE 或某些 LOCAL 组合时，错误可能转成警告并继续，这会改变数据质量结果，不能把“导入完成”直接等同于“每一行都按预期写入”。

常见误区与速查结论

• 想把空字段变成 NULL：用 @变量 接收，再写 SET 列 = NULLIF(@变量, '')。
• 想跳过表头：用 IGNORE 1 LINES，不要把它当成空值开关。
• 想保留空字符串：不要使用 NULLIF，直接把输入列映射到目标列。
• 想把空格也当缺失：使用 NULLIF(TRIM(@变量), '')，但先确认业务允许去掉首尾空格。
• 想使用 \\N 表示 NULL：确认字段转义符没有被改写，并注意带引号的文本语义。

相关问题

为什么空字段导入后查询不到 NULL？ 因为空字段通常是空字符串，必须用用户变量和 NULLIF 显式转换。

可以直接把 CSV 的 NULL 文本当成空值吗？ 不建议直接假设。带引号的 "NULL" 常常是普通字符串，应按文件约定决定是否在 SET 中额外处理。

LOAD DATA 导入到 NOT NULL 列为什么失败？ 因为转换结果确实是 SQL NULL，而目标列不允许缺失；应修正字段规则、提供默认值或调整表约束。