LOAD DATA [LOW_PRIORITY] [LOCAL] INFILE 'file_name.txt' [REPLACE | IGNORE]
INTO TABLE tbl_name
[FIELDS
[TERMINATED BY '\t']
[OPTIONALLY] ENCLOSED BY '']
[ESCAPED BY '\\' ]]
[LINES TERMINATED BY '\n']
[IGNORE number LINES]
[(col_name,...)]
LOAD DATA INFILE語句從一個文本文件中以很高的速度讀入一個表中。如果指定LOCAL關(guān)鍵詞，從客戶主機讀文件。如果LOCAL沒指定，文件必須位于服務(wù)器上。(LOCAL在MySQL3.22.6或以后版本中可用。）
為了安全原因，當(dāng)讀取位于服務(wù)器上的文本文件時，文件必須處于數(shù)據(jù)庫目錄或可被所有人讀取。另外，為了對服務(wù)器上文件使用LOAD DATA INFILE，在服務(wù)器主機上你必須有file的權(quán)限。見6.5 由MySQL提供的權(quán)限。
如果你指定關(guān)鍵詞LOW_PRIORITY，LOAD DATA語句的執(zhí)行被推遲到?jīng)]有其他客戶讀取表后。
使用LOCAL將比讓服務(wù)器直接存取文件慢些，因為文件的內(nèi)容必須從客戶主機傳送到服務(wù)器主機。在另一方面，你不需要file權(quán)限裝載本地文件。
你也可以使用mysqlimport實用程序裝載數(shù)據(jù)文件；它由發(fā)送一個LOAD DATA INFILE命令到服務(wù)器來運作。 --local選項使得mysqlimport從客戶主機上讀取數(shù)據(jù)。如果客戶和服務(wù)器支持壓縮協(xié)議，你能指定--compress在較慢的網(wǎng)絡(luò)上獲得更好的性能。
當(dāng)在服務(wù)器主機上尋找文件時，服務(wù)器使用下列規(guī)則：
如果給出一個絕對路徑名，服務(wù)器使用該路徑名。
如果給出一個有一個或多個前置部件的相對路徑名，服務(wù)器相對服務(wù)器的數(shù)據(jù)目錄搜索文件。
如果給出一個沒有前置部件的一個文件名，服務(wù)器在當(dāng)前數(shù)據(jù)庫的數(shù)據(jù)庫目錄尋找文件。
注意這些規(guī)則意味著一個像“./myfile.txt”給出的文件是從服務(wù)器的數(shù)據(jù)目錄讀取，而作為“myfile.txt”給出的一個文件是從當(dāng)前數(shù)據(jù)庫的數(shù)據(jù)庫目錄下讀取。也要注意，對于下列哪些語句，對db1文件從數(shù)據(jù)庫目錄讀取，而不是db2：
mysql> USE db1;
mysql> LOAD DATA INFILE "./data.txt" INTO TABLE db2.my_table;
REPLACE和IGNORE關(guān)鍵詞控制對現(xiàn)有的唯一鍵記錄的重復(fù)的處理。如果你指定REPLACE，新行將代替有相同的唯一鍵值的現(xiàn)有行。如果你指定IGNORE，跳過有唯一鍵的現(xiàn)有行的重復(fù)行的輸入。如果你不指定任何一個選項，當(dāng)找到重復(fù)鍵鍵時，出現(xiàn)一個錯誤，并且文本文件的余下部分被忽略時。
如果你使用LOCAL關(guān)鍵詞從一個本地文件裝載數(shù)據(jù)，服務(wù)器沒有辦法在操作的當(dāng)中停止文件的傳輸，因此缺省的行為好像IGNORE被指定一樣。
LOAD DATA INFILE是SELECT ... INTO OUTFILE的逆操作，
SELECT句法。為了將一個數(shù)據(jù)庫的數(shù)據(jù)寫入一個文件，使用SELECT ... INTO OUTFILE，為了將文件讀回數(shù)據(jù)庫，使用LOAD DATA INFILE。兩個命令的FIELDS和LINES子句的語法是相同的。兩個子句是可選的，但是如果指定兩個，F(xiàn)IELDS必須在LINES之前。
如果你指定一個FIELDS子句，它的每一個子句(TERMINATED BY, [OPTIONALLY] ENCLOSED BY和ESCAPED BY)也是可選的，除了你必須至少指定他們之一。
如果你不指定一個FIELDS子句，缺省值與如果你這樣寫的相同：
FIELDS TERMINATED BY '\t' ENCLOSED BY '' ESCAPED BY '\\'
如果你不指定一個LINES子句，缺省值與如果你這樣寫的相同：
LINES TERMINATED BY '\n'
換句話說，缺省值導(dǎo)致讀取輸入時，LOAD DATA INFILE表現(xiàn)如下：
在換行符處尋找行邊界
在定位符處將行分進字段
不要期望字段由任何引號字符封裝
將由“\”開頭的定位符、換行符或“\”解釋是字段值的部分字面字符
相反，缺省值導(dǎo)致在寫入輸出時，SELECT ... INTO OUTFILE表現(xiàn)如下：
在字段之間寫定位符
不用任何引號字符封裝字段
使用“\”轉(zhuǎn)義出現(xiàn)在字段中的定位符、換行符或“\”字符
在行尾處寫換行符
注意，為了寫入FIELDS ESCAPED BY '\\'，對作為一條單個的反斜線被讀取的值，你必須指定2條反斜線值。
IGNORE number LINES選項可被用來忽略在文件開始的一個列名字的頭：
mysql> LOAD DATA INFILE "/tmp/file_name" into table test IGNORE 1 LINES;
當(dāng)你與LOAD DATA INFILE一起使用SELECT ... INTO OUTFILE將一個數(shù)據(jù)庫的數(shù)據(jù)寫進一個文件并且隨后馬上將文件讀回數(shù)據(jù)庫時，兩個命令的字段和處理選項必須匹配，否則，LOAD DATA INFILE將不能正確解釋文件的內(nèi)容。假定你使用SELECT ... INTO OUTFILE將由逗號分隔的字段寫入一個文件：
mysql> SELECT * FROM table1 INTO OUTFILE 'data.txt'
FIELDS TERMINATED BY ','
FROM ...
為了將由逗號分隔的文件讀回來，正確的語句將是：
mysql> LOAD DATA INFILE 'data.txt' INTO TABLE table2
FIELDS TERMINATED BY ',';
相反，如果你試圖用下面顯示的語句讀取文件，它不會工作，因為它命令LOAD DATA INFILE在字段之間尋找定位符：
mysql> LOAD DATA INFILE 'data.txt' INTO TABLE table2
FIELDS TERMINATED BY '\t';
可能的結(jié)果是每個輸入行將被解釋為單個的字段。
LOAD DATA INFILE能被用來讀取從外部來源獲得的文件。例如，以dBASE格式的文件將有由逗號分隔并用雙引號包圍的字段。如果文件中的行由換行符終止，下面顯示的命令說明你將用來裝載文件的字段和行處理選項：
mysql> LOAD DATA INFILE 'data.txt' INTO TABLE tbl_name
FIELDS TERMINATED BY ',' ENCLOSED BY '"'
LINES TERMINATED BY '\n';
任何字段或行處理選項可以指定一個空字符串('')。如果不是空，F(xiàn)IELDS [OPTIONALLY] ENCLOSED BY和FIELDS ESCAPED BY值必須是一個單個字符。FIELDS TERMINATED BY和LINES TERMINATED BY值可以是超過一個字符。例如，寫入由回車換行符對（CR+LF）終止的行，或讀取包含這樣行的一個文件，指定一個LINES TERMINATED BY '\r\n'子句。
FIELDS [OPTIONALLY] ENCLOSED BY控制字段的包圍字符。對于輸出(SELECT ... INTO OUTFILE)，如果你省略O(shè)PTIONALLY，所有的字段由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和VARCHAR字段：
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字符的出現(xiàn)通過用ESCAPED BY字符作為其前綴來轉(zhuǎn)義。也要注意，如果你指定一個空ESCAPED BY值，可能產(chǎn)生不能被LOAD DATA INFILE正確讀出的輸出。例如，如果轉(zhuǎn)義字符為空，上面顯示的輸出顯示如下。注意到在第四行的第二個字段包含跟隨引號的一個逗號，它(錯誤地)好象要終止字段：
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字符如果存在，它從字段值的尾部被剝?nèi)?。（不管是否指定OPTIONALLY都是這樣；OPTIONALLY對于輸入解釋不起作用)由ENCLOSED BY字符領(lǐng)先的ESCAPED BY字符出現(xiàn)被解釋為當(dāng)前字段值的一部分。另外，出現(xiàn)在字段中重復(fù)的ENCLOSED 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控制如何寫入或讀出特殊字符。如果FIELDS ESCAPED BY字符不是空的，它被用于前綴在輸出上的下列字符：
FIELDS ESCAPED BY字符
FIELDS [OPTIONALLY] ENCLOSED BY字符
FIELDS TERMINATED BY和LINES TERMINATED BY值的第一個字符
ASCII 0（實際上將后續(xù)轉(zhuǎn)義字符寫成 ASCII'0'，而不是一個零值字節(jié)）
如果FIELDS ESCAPED BY字符是空的，沒有字符被轉(zhuǎn)義。指定一個空轉(zhuǎn)義字符可能不是一個好主意，特別是如果在你數(shù)據(jù)中的字段值包含剛才給出的表中的任何字符。
對于輸入，如果FIELDS ESCAPED BY字符不是空的，該字符的出現(xiàn)被剝?nèi)ゲ⑶液罄m(xù)字符在字面上作為字段值的一個部分。例外是一個轉(zhuǎn)義的“0”或“N”（即，\0或\N，如果轉(zhuǎn)義字符是“\”)。這些序列被解釋為ASCII 0（一個零值字節(jié)）和NULL。見下面關(guān)于NULL處理的規(guī)則。
對于更多關(guān)于“\”- 轉(zhuǎn)義句法的信息，在某些情況下，字段和行處理選項相互作用：
如果LINES TERMINATED BY是一個空字符串并且FIELDS TERMINATED BY是非空的，行也用FIELDS TERMINATED BY終止。
如果FIELDS TERMINATED BY和FIELDS ENCLOSED BY值都是空的('')，一個固定行(非限定的)格式被使用。用固定行格式，在字段之間不使用分隔符。相反，列值只用列的“顯示”寬度被寫入和讀出。例如，如果列被聲明為INT(7)，列的值使用7個字符的字段被寫入。對于輸入，列值通過讀取7個字符獲得。固定行格式也影響NULL值的處理；見下面。注意如果你正在使用一個多字節(jié)字符集，固定長度格式將不工作。
NULL值的處理有多種，取決于你使用的FIELDS和LINES選項：
對于缺省FIELDS和LINES值，對輸出，NULL被寫成\N，對輸入，\N被作為NULL讀入(假定ESCAPED BY字符是“\”)。
如果FIELDS ENCLOSED BY不是空的，包含以文字詞的NULL作為它的值的字段作為一個NULL值被讀入(這不同于包圍在FIELDS ENCLOSED BY字符中的字NULL，它作為字符串'NULL'讀入)。
如果FIELDS ESCAPED BY是空的，NULL作為字NULL被寫入。
用固定行格式(它發(fā)生在FIELDS TERMINATED BY和FIELDS ENCLOSED BY都是空的時候)，NULL作為一個空字符串被寫入。注意，在寫入文件時，這導(dǎo)致NULL和空字符串在表中不能區(qū)分，因為他們都作為空字符串被寫入。如果在讀回文件時需要能區(qū)分這兩者，你應(yīng)該不使用固定行格式。
一些不被LOAD DATA INFILE支持的情況：
固定長度的行(FIELDS TERMINATED BY和FIELDS ENCLOSED BY都為空)和BLOB或TEXT列。
如果你指定一個分隔符與另一個相同，或是另一個的前綴，LOAD DATA INFILE不能正確地解釋輸入。例如，下列FIELDS子句將導(dǎo)致問題：
FIELDS TERMINATED BY '"' ENCLOSED BY '"'
如果FIELDS ESCAPED BY是空的，一個包含跟隨FIELDS TERMINATED BY值之后的FIELDS ENCLOSED BY或LINES TERMINATED BY的字段值將使得LOAD DATA INFILE過早地終止讀取一個字段或行。這是因為LOAD DATA INFILE不能正確地決定字段或行值在哪兒結(jié)束。
下列例子裝載所有persondata表的行：
mysql> LOAD DATA INFILE 'persondata.txt' INTO TABLE persondata;
沒有指定字段表，所以LOAD DATA INFILE期望輸入行對每個表列包含一個字段。使用缺省FIELDS和LINES值。
如果你希望僅僅裝載一張表的某些列，指定一個字段表：
mysql> LOAD DATA INFILE 'persondata.txt'
INTO TABLE persondata (col1,col2,...);
如果在輸入文件中的字段順序不同于表中列的順序，你也必須指定一個字段表。否則，MySQL不能知道如何匹配輸入字段和表中的列。
如果一個行有很少的字段，對于不存在輸入字段的列被設(shè)置為缺省值。
如果字段值缺省，空字段值有不同的解釋：
對于字符串類型，列被設(shè)置為空字符串。
對于數(shù)字類型，列被設(shè)置為0。
對于日期和時間類型，列被設(shè)置為該類型的適當(dāng)“零”值。
如果列有一個NULL，或(只對第一個TIMESTAMP列)在指定一個字段表時，如果TIMESTAMP列從字段表省掉，TIMESTAMP列只被設(shè)置為當(dāng)前的日期和時間。
如果輸入行有太多的字段，多余的字段被忽略并且警告數(shù)字加1。
LOAD DATA INFILE認(rèn)為所有的輸入是字符串，因此你不能像你能用INSERT語句的ENUM或SET列的方式使用數(shù)字值。所有的ENUM和SET值必須作為字符串被指定！
如果你正在使用C API，當(dāng)LOAD DATA INFILE查詢完成時，你可通過調(diào)用API函數(shù)mysql_info()得到有關(guān)查詢的信息。信息字符串的格式顯示在下面：
Records: 1 Deleted: 0 Skipped: 0 Warnings: 0
當(dāng)值通過INSERT語句插入時，在某些情況下出現(xiàn)警告，除了在輸入行中有太少或太多的字段時，LOAD DATA INFILE也產(chǎn)生警告。警告沒被存儲在任何地方；警告數(shù)字僅能用于表明一切是否順利。如果你得到警告并且想要確切知道你為什么得到他們，一個方法是使用SELECT ... INTO OUTFILE到另外一個文件并且把它與你的原版輸入文件比較。