与非操作 相比， 修饰符LOCAL会影响这些方面 ：LOAD DATALOCAL

LOCAL仅当服务器和您的客户端都已配置为允许时才有效。例如，如果 mysqld是在 local_infile禁用系统变量的情况下启动的，则会LOCAL产生错误。请参阅 第 6.1.6 节，“LOAD DATA LOCAL 的安全注意事项”。

文件名必须作为文字字符串给出。在 Windows 上，将路径名中的反斜杠指定为正斜杠或双反斜杠。character_set_filesystem服务器使用系统变量 指示的字符集解释文件名 。

默认情况下，服务器使用 character_set_database系统变量指示的字符集解释文件内容。如果文件内容使用的字符集与此默认值不同，最好使用CHARACTER SET子句指定该字符集。字符集binary指定“不转换。”

SET NAMES和设置 character_set_client不影响文件内容的解释。

LOAD DATA将文件中的所有字段解释为具有相同的字符集，而不管字段值加载到的列的数据类型如何。为了正确解释文件，您必须确保它是用正确的字符集编写的。例如，如果您使用mysqldump -T或通过在mysql中发出SELECT ... INTO OUTFILE语句来 写入数据文件，请务必使用一个 选项以在文件加载时使用的字符集写入输出。 --default-character-setLOAD DATA

这些规则决定了LOAD DATA输入文件的位置：

非LOCAL规则意味着服务器读取一个名为 as 的文件相对于它的数据目录，而它从默认数据库的数据库目录./myfile.txt读取一个名为 as 的文件 。myfile.txt例如，如果在 默认数据库LOAD DATA中执行以下语句，服务器会从数据库目录中读取文件，即使该语句显式地将文件加载到 数据库中的表中也是如此： db1data.txtdb1db2

LOAD DATA INFILE 'data.txt' INTO TABLE db2.my_table;

对于非LOCAL加载操作，服务器读取位于服务器主机上的文本文件，因此必须满足以下安全要求：

对于LOCAL加载操作，客户端程序读取位于客户端主机上的文本文件。因为文件内容是由客户端通过连接发送到服务器的，所以使用LOCAL比服务器直接访问文件要慢一点。另一方面，您不需要FILE 特权，文件可以位于客户端程序可以访问的任何目录中。

REPLACE和IGNORE 修饰符控制在唯一键值（PRIMARY KEY或UNIQUE索引值） 上复制现有表行的新（输入）行 的处理：

修饰符与LOCAL具有相同的效果 IGNORE。发生这种情况是因为服务器无法在操作过程中停止文件的传输。

如果未指定REPLACE、 IGNORE或LOCAL，则在找到重复的键值时会发生错误，并忽略文本文件的其余部分。

除了影响刚刚描述的重复键处理外，IGNORE还会 LOCAL影响错误处理：

要在加载操作期间忽略外键约束，请在执行SET foreign_key_checks = 0 之前执行一条语句LOAD DATA。

如果您LOAD DATA在空 MyISAM表上使用，所有非唯一索引都将在单独的批次中创建（对于REPAIR TABLE）。通常，LOAD DATA当您有很多索引时，这会更快。在某些极端情况下，您可以更快地创建索引，方法是ALTER TABLE ... DISABLE KEYS在将文件加载到表中之前关闭它们，并在加载文件后重新创建索引 ALTER TABLE ... ENABLE KEYS。请参阅 第 8.2.4.1 节，“优化 INSERT 语句”。

对于LOAD DATAand SELECT ... INTO OUTFILE语句， FIELDSandLINES子句的语法是相同的。这两个子句都是可选的，但 如果两者都指定 ，则FIELDS必须放在前面。LINES

如果您指定一个FIELDS子句，则其每个子句（TERMINATED BY、 [OPTIONALLY] ENCLOSED BY和 ESCAPED BY）也是可选的，除非您必须至少指定其中一个。这些子句的参数只允许包含 ASCII 字符。

如果您指定 no FIELDSor LINES子句，则默认值与您编写此内容时的默认值相同：

FIELDS TERMINATED BY '\t' ENCLOSED BY '' ESCAPED BY '\\'
LINES TERMINATED BY '\n' STARTING BY ''

反斜杠是 SQL 语句中字符串中的 MySQL 转义字符。因此，要指定文字反斜杠，您必须为要解释为单个反斜杠的值指定两个反斜杠。转义序列'\t' 分别'\n'指定制表符和换行符。

换句话说，默认值会导致LOAD DATA读取输入时的行为如下：

相反，默认值会导致 SELECT ... INTO OUTFILE写入输出时的行为如下：

如果所有输入行都有一个你想忽略的公共前缀，你可以使用跳过前缀和它之前的任何内容。如果一行不包含前缀，则跳过整行。假设您发出以下语句： LINES STARTING BY 'prefix_string'

LOAD DATA INFILE '/tmp/test.txt' INTO TABLE test
  FIELDS TERMINATED BY ','  LINES STARTING BY 'xxx';

如果数据文件是这样的：

xxx"abc",1
something xxx"def",2
"ghi",3

结果行是("abc",1)和 ("def",2)。文件中的第三行被跳过，因为它不包含前缀。

该子句可用于忽略文件开头的行。例如，您可以使用跳过包含列名的初始标题行： IGNORE number LINESIGNORE 1 LINES

LOAD DATA INFILE '/tmp/test.txt' INTO TABLE test IGNORE 1 LINES;

当您SELECT ... INTO OUTFILE串联使用 with LOAD DATA将数据从数据库写入文件，然后稍后将该文件读回数据库时，这两个语句的字段和行处理选项必须匹配。否则，LOAD DATA不会正确解释文件的内容。假设您 SELECT ... INTO OUTFILE用来编写一个文件，其中的字段以逗号分隔：

SELECT * INTO OUTFILE 'data.txt'
  FIELDS TERMINATED BY ','
  FROM table2;

要读取逗号分隔的文件，正确的说法是：

LOAD DATA INFILE 'data.txt' INTO TABLE table2
  FIELDS TERMINATED BY ',';

相反，如果您尝试使用如下所示的语句读取文件，它将不起作用，因为它指示 LOAD DATA在字段之间查找制表符：

LOAD DATA INFILE 'data.txt' INTO TABLE table2
  FIELDS TERMINATED BY '\t';

可能的结果是每个输入行都将被解释为一个字段。

LOAD DATA可用于读取从外部源获取的文件。例如，许多程序可以以逗号分隔值 (CSV) 格式导出数据，这样行中的字段由逗号分隔并括在双引号中，首行是列名。如果此类文件中的行以回车符/换行符对终止，此处显示的语句说明了用于加载文件的字段和行处理选项：

LOAD DATA INFILE 'data.txt' INTO TABLE tbl_name
  FIELDS TERMINATED BY ',' ENCLOSED BY '"'
  LINES TERMINATED BY '\r\n'
  IGNORE 1 LINES;

如果输入值不一定用引号引起来，请在选项 OPTIONALLY前 使用。ENCLOSED BY

任何字段或行处理选项都可以指定一个空字符串 ( '')。如果不为空，则 FIELDS [OPTIONALLY] ENCLOSED BY和 FIELDS ESCAPED BY值必须是单个字符。、FIELDS TERMINATED BY和 值可以LINES STARTING BY是LINES TERMINATED BY多个字符。例如，要写入由回车符/换行符对终止的行，或要读取包含此类行的文件，请指定一个LINES TERMINATED BY '\r\n'子句。

要读取包含由 组成的行分隔的笑话的文件%%，您可以这样做

CREATE TABLE jokes
  (a INT NOT NULL AUTO_INCREMENT PRIMARY KEY,
  joke TEXT NOT NULL);
LOAD DATA INFILE '/tmp/jokes.txt' INTO TABLE jokes
  FIELDS TERMINATED BY ''
  LINES TERMINATED BY '\n%%\n' (joke);

FIELDS [OPTIONALLY] ENCLOSED BY控制字段的引用。对于输出 ( SELECT ... INTO OUTFILE)，如果省略单词 OPTIONALLY，则所有字段都包含在 ENCLOSED BY字符中。此处显示了此类输出的示例（使用逗号作为字段分隔符）：

"1","a string","100.20"
"2","a string containing a , comma","102.20"
"3","a string containing a \" quote","102.20"
"4","a string containing a \", quote and comma","102.20"

如果您指定OPTIONALLY，则该 ENCLOSED BY字符仅用于包含具有字符串数据类型（例如 CHAR、 BINARY、 TEXT或 ENUM）的列中的值：

1,"a string",100.20
2,"a string containing a , comma",102.20
3,"a string containing a \" quote",102.20
4,"a string containing a \", quote and comma",102.20

字段值中字符的出现ENCLOSED BY通过在它们前面加上字符来转义 ESCAPED BY。此外，如果您指定一个空ESCAPED BY值，则可能会无意中生成 无法正确读取的输出 LOAD DATA。例如，如果转义字符为空，刚才显示的前面的输出将如下所示。观察第四行的第二个字段在引号后面包含一个逗号，它（错误地）似乎终止了该字段：

1,"a string",100.20
2,"a string containing a , comma",102.20
3,"a string containing a " quote",102.20
4,"a string containing a ", quote and comma",102.20

对于输入，该ENCLOSED BY字符（如果存在）将从字段值的末尾去除。（无论是否OPTIONALLY指定，这都是正确的；OPTIONALLY对输入解释没有影响。）ENCLOSED BY字符前面的ESCAPED BY字符的出现被解释为当前字段值的一部分。

如果字段以该字符开头，则该ENCLOSED BY 字符的实例仅在后跟字段或行 TERMINATED BY序列时才被识别为终止字段值。为避免歧义，ENCLOSED BY字段值中字符的出现次数可以加倍，并被解释为该字符的单个实例。例如，如果 ENCLOSED BY '"'指定，引号的处理方式如下所示：

"The ""BIG"" boss"  -> The "BIG" boss
The "BIG" boss      -> The "BIG" boss
The ""BIG"" boss    -> The ""BIG"" boss

FIELDS ESCAPED BY控制如何读取或写入特殊字符：

在某些情况下，字段和行处理选项相互作用：

值的处理NULL因使用的FIELDS选项而异LINES ：

根据列值分配中描述的规则， 尝试加载NULL到NOT NULL列中会产生警告或错误 。

某些情况不支持LOAD DATA：

以下示例加载表的所有列 persondata：

LOAD DATA INFILE 'persondata.txt' INTO TABLE persondata;

默认情况下，当 LOAD DATA语句末尾未提供列列表时，输入行应包含每个表列的字段。如果只想加载表的某些列，请指定列列表：

LOAD DATA INFILE 'persondata.txt' INTO TABLE persondata
(col_name_or_user_var [, col_name_or_user_var] ...);

如果输入文件中字段的顺序与表中列的顺序不同，您还必须指定一个列列表。否则，MySQL 无法判断如何将输入字段与表列相匹配。

col_name_or_user_var in语法的 每个实例LOAD DATA都是列名或用户变量。对于用户变量，该 SET子句使您能够在将结果分配给列之前对其值执行预处理转换。

子句中的用户变量SET可以多种方式使用。以下示例直接使用第一个输入列作为 的值t1.column1，并将第二个输入列分配给一个用户变量，该用户变量经过除法运算后才用于 的值t1.column2：

LOAD DATA INFILE 'file.txt'
  INTO TABLE t1
  (column1, @var1)
  SET column2 = @var1/100;

该SET子句可用于提供不是从输入文件派生的值。以下语句设置 column3为当前日期和时间：

LOAD DATA INFILE 'file.txt'
  INTO TABLE t1
  (column1, column2)
  SET column3 = CURRENT_TIMESTAMP;

您还可以通过将输入值分配给用户变量而不将该变量分配给任何表列来丢弃输入值：

LOAD DATA INFILE 'file.txt'
  INTO TABLE t1
  (column1, @dummy, column2, @dummy, column3);

列/变量列表和SET 子句的使用受以下限制：

要处理输入行，LOAD DATA将其拆分为字段并根据列/变量列表和 SET子句（如果存在）使用值。然后将结果行插入表中。如果表有 BEFORE INSERT或AFTER INSERT触发器，它们分别在插入行之前或之后被激活。

字段值的解释和表列的分配取决于以下因素：

这些因素结合起来通过以下方式产生限制性或非限制性数据解释LOAD DATA：

限制性数据解释使用以下规则：

相比之下，非限制性数据解释使用以下规则：

TIMESTAMP仅当列有NULL 值（即\N）且列未声明为允许NULL值时，或者TIMESTAMP列默认值为当前时间戳且字段中省略时，列才设置为当前日期和时间指定字段列表时的列表。

LOAD DATA将所有输入视为字符串，因此您不能像 with语句那样为ENUM或 SET列 使用数值 。INSERT所有 ENUM和 SET值都必须指定为字符串。

BIT不能使用二进制表示法（例如 b'011010'）直接加载值。要解决此问题，请使用该 SET子句去除前导 b'和尾随'并执行 base-2 到 base-10 的转换，以便 MySQL 将值BIT正确加载到列中：

$> cat /tmp/bit_test.txt
b'10'
b'1111111'
$> mysql test
mysql> LOAD DATA INFILE '/tmp/bit_test.txt'
       INTO TABLE bit_test (@var1)
       SET b = CAST(CONV(MID(@var1, 3, LENGTH(@var1)-3), 2, 10) AS UNSIGNED);
Query OK, 2 rows affected (0.00 sec)
Records: 2  Deleted: 0  Skipped: 0  Warnings: 0

mysql> SELECT BIN(b+0) FROM bit_test;
+----------+
| BIN(b+0) |
+----------+
| 10       |
| 1111111  |
+----------+
2 rows in set (0.00 sec)

对于二进制表示法BIT中的值 0b（例如 0b011010），请改用此SET 子句去除前导0b：

SET b = CAST(CONV(MID(@var1, 3, LENGTH(@var1)-2), 2, 10) AS UNSIGNED)

LOAD DATAPARTITION 使用带有一个或多个逗号分隔的分区、子分区或两者名称列表的子句支持显式分区选择。使用此子句时，如果文件中的任何行无法插入到列表中指定的任何分区或子分区中，则该语句将失败并显示错误Found a row not matching the given partition set。有关更多信息和示例，请参阅第 19.5 节，“分区选择”。

对于使用采用表锁的存储引擎的分区表，例如MyISAM， LOAD DATA不能修剪任何分区锁。这不适用于使用采用行级锁定的存储引擎的表，例如 InnoDB. 有关详细信息，请参阅 第 19.6.4 节，“分区和锁定”。

使用LOW_PRIORITY修饰符，LOAD DATA语句的执行被延迟，直到没有其他客户端从表中读取。这只会影响仅使用表级锁定的存储引擎（例如MyISAM、MEMORY和MERGE）。

使用CONCURRENT修饰符和 MyISAM满足并发插入条件的表（即中间不包含空闲块），其他线程可以在 LOAD DATA执行时从表中检索数据。此修饰符会LOAD DATA稍微影响性能，即使没有其他线程同时使用该表也是如此。

语句完成LOAD DATA后，它会返回以下格式的信息字符串：

Records: 1  Deleted: 0  Skipped: 0  Warnings: 0

INSERT 警告发生在与使用语句 插入值时相同的情况下（请参阅第 13.2.5 节，“INSERT 语句”），除了 LOAD DATA当输入行中的字段太少或太多时也会生成警告。

您可以使用SHOW WARNINGSto 获取第一个 max_error_count警告的列表，作为有关出错原因的信息。请参阅 第 13.7.5.41 节，“显示警告语句”。

mysql_info()如果您使用的是 C API，则可以通过调用函数 来获取有关语句的信息 。请参阅 mysql_info()。

有关LOAD DATA 与复制相关的信息，请参阅 第 17.4.1.18 节，“复制和加载数据”。

在 Unix 上，如果需要LOAD DATA从管道读取数据，可以使用以下技术（示例将/目录列表加载到表中db1.t1）：

mkfifo /mysql/data/db1/ls.dat
chmod 666 /mysql/data/db1/ls.dat
find / -ls > /mysql/data/db1/ls.dat &
mysql -e "LOAD DATA INFILE 'ls.dat' INTO TABLE t1" db1

此处必须在不同的终端运行生成待加载数据的命令和mysql命令，或者在后台运行数据生成过程（如上例所示）。如果不这样做，管道将阻塞，直到 mysql进程读取数据。