mysql load 用法

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關鍵詞,從客戶主機讀文件。如果LOCAL沒指定,文件必須位於服務器上。(LOCAL在MySQL3.22.6或以後版本中可用。)

爲了安全原因,當讀取位於服務器上的文本文件時,文件必須處於數據庫目錄或可被所有人讀取。另外,爲了對服務器上文件使用LOAD DATA INFILE,在服務器主機上你必須有file的權限。見6.5 由MySQL提供的權限。

如果你指定關鍵詞LOW_PRIORITY,LOAD DATA語句的執行被推遲到沒有其他客戶讀取表後。

使用LOCAL將比讓服務器直接存取文件慢些,因爲文件的內容必須從客戶主機傳送到服務器主機。在另一方面,你不需要file權限裝載本地文件。

你也可以使用mysqlimport實用程序裝載數據文件;它由發送一個LOAD DATA INFILE命令到服務器來運作。 --local選項使得mysqlimport從客戶主機上讀取數據。如果客戶和服務器支持壓縮協議,你能指定--compress在較慢的網絡上獲得更好的性能。

當在服務器主機上尋找文件時,服務器使用下列規則:

如果給出一個絕對路徑名,服務器使用該路徑名。
如果給出一個有一個或多個前置部件的相對路徑名,服務器相對服務器的數據目錄搜索文件。
如果給出一個沒有前置部件的一個文件名,服務器在當前數據庫的數據庫目錄尋找文件。
注意這些規則意味着一個像“./myfile.txt”給出的文件是從服務器的數據目錄讀取,而作爲“myfile.txt”給出的一個文件是從當前數據庫的數據庫目錄下讀取。也要注意,對於下列哪些語句,對db1文件從數據庫目錄讀取,而不是db2:

mysql> USE db1;
mysql> LOAD DATA INFILE "./data.txt" INTO TABLE db2.my_table;


REPLACE和IGNORE關鍵詞控制對現有的唯一鍵記錄的重複的處理。如果你指定REPLACE,新行將代替有相同的唯一鍵值的現有行。如果你指定IGNORE,跳過有唯一鍵的現有行的重複行的輸入。如果你不指定任何一個選項,當找到重複鍵鍵時,出現一個錯誤,並且文本文件的餘下部分被忽略時。

如果你使用LOCAL關鍵詞從一個本地文件裝載數據,服務器沒有辦法在操作的當中停止文件的傳輸,因此缺省的行爲好像IGNORE被指定一樣。

LOAD DATA INFILE是SELECT ... INTO OUTFILE的逆操作,
SELECT句法。爲了將一個數據庫的數據寫入一個文件,使用SELECT ... INTO OUTFILE,爲了將文件讀回數據庫,使用LOAD DATA INFILE。兩個命令的FIELDS和LINES子句的語法是相同的。兩個子句是可選的,但是如果指定兩個,FIELDS必須在LINES之前。

如果你指定一個FIELDS子句,它的每一個子句(TERMINATED BY, [OPTIONALLY] ENCLOSED BY和ESCAPED BY)也是可選的,除了你必須至少指定他們之一。

如果你不指定一個FIELDS子句,缺省值與如果你這樣寫的相同:

FIELDS TERMINATED BY '\t' ENCLOSED BY '' ESCAPED BY '\\'

如果你不指定一個LINES子句,缺省值與如果你這樣寫的相同:

LINES TERMINATED BY '\n'
換句話說,缺省值導致讀取輸入時,LOAD DATA INFILE表現如下:

在換行符處尋找行邊界
在定位符處將行分進字段
不要期望字段由任何引號字符封裝
將由“\”開頭的定位符、換行符或“\”解釋是字段值的部分字面字符
相反,缺省值導致在寫入輸出時,SELECT ... INTO OUTFILE表現如下:

在字段之間寫定位符
不用任何引號字符封裝字段
使用“\”轉義出現在字段中的定位符、換行符或“\”字符
在行尾處寫換行符
注意,爲了寫入FIELDS ESCAPED BY '\\',對作爲一條單個的反斜線被讀取的值,你必須指定2條反斜線值。

IGNORE number LINES選項可被用來忽略在文件開始的一個列名字的頭:
mysql> LOAD DATA INFILE "/tmp/file_name" into table test IGNORE 1 LINES;


當你與LOAD DATA INFILE一起使用SELECT ... INTO OUTFILE將一個數據庫的數據寫進一個文件並且隨後馬上將文件讀回數據庫時,兩個命令的字段和處理選項必須匹配,否則,LOAD DATA INFILE將不能正確解釋文件的內容。假定你使用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';



可能的結果是每個輸入行將被解釋爲單個的字段。

LOAD DATA INFILE能被用來讀取從外部來源獲得的文件。例如,以dBASE格式的文件將有由逗號分隔並用雙引號包圍的字段。如果文件中的行由換行符終止,下面顯示的命令說明你將用來裝載文件的字段和行處理選項:

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



任何字段或行處理選項可以指定一個空字符串('')。如果不是空,FIELDS [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),如果你省略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和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字符的出現通過用ESCAPED BY字符作爲其前綴來轉義。也要注意,如果你指定一個空ESCAPED BY值,可能產生不能被LOAD DATA INFILE正確讀出的輸出。例如,如果轉義字符爲空,上面顯示的輸出顯示如下。注意到在第四行的第二個字段包含跟隨引號的一個逗號,它(錯誤地)好象要終止字段:

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被解釋爲單個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(實際上將後續轉義字符寫成 ASCII'0',而不是一個零值字節)
如果FIELDS ESCAPED BY字符是空的,沒有字符被轉義。指定一個空轉義字符可能不是一個好主意,特別是如果在你數據中的字段值包含剛纔給出的表中的任何字符。

對於輸入,如果FIELDS ESCAPED BY字符不是空的,該字符的出現被剝去並且後續字符在字面上作爲字段值的一個部分。例外是一個轉義的“0”或“N”(即,\0或\N,如果轉義字符是 “\”)。這些序列被解釋爲ASCII 0(一個零值字節)和NULL。見下面關於NULL處理的規則。

對於更多關於“\”- 轉義句法的信息,在某些情況下,字段和行處理選項相互作用:

如果LINES TERMINATED BY是一個空字符串並且FIELDS TERMINATED BY是非空的,行也用FIELDS TERMINATED BY終止。
如果FIELDS TERMINATED BY和FIELDS ENCLOSED BY值都是空的(''),一個固定行(非限定的)格式被使用。用固定行格式,在字段之間不使用分隔符。相反,列值只用列的“顯示”寬度被寫入和讀出。例如,如果列被聲明爲INT(7),列的值使用7個字符的字段被寫入。對於輸入,列值通過讀取7個字符獲得。固定行格式也影響NULL值的處理;見下面。注意如果你正在使用一個多字節字符集,固定長度格式將不工作。
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被寫入。
用固定行格式(它發生在FIELDS TERMINATED BY和FIELDS ENCLOSED BY都是空的時候),NULL作爲一個空字符串被寫入。注意,在寫入文件時,這導致NULL和空字符串在表中不能區分,因爲他們都作爲空字符串被寫入。如果在讀迴文件時需要能區分這兩者,你應該不使用固定行格式。
一些不被LOAD DATA INFILE支持的情況:

固定長度的行(FIELDS TERMINATED BY和FIELDS ENCLOSED BY都爲空)和BLOB或TEXT列。
如果你指定一個分隔符與另一個相同,或是另一個的前綴,LOAD DATA INFILE不能正確地解釋輸入。例如,下列FIELDS子句將導致問題:
FIELDS TERMINATED BY '"' ENCLOSED BY '"'

如果FIELDS ESCAPED BY是空的,一個包含跟隨FIELDS TERMINATED BY值之後的FIELDS ENCLOSED BY或LINES TERMINATED BY的字段值將使得LOAD DATA INFILE過早地終止讀取一個字段或行。這是因爲LOAD DATA INFILE不能正確地決定字段或行值在哪兒結束。
下列例子裝載所有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不能知道如何匹配輸入字段和表中的列。

如果一個行有很少的字段,對於不存在輸入字段的列被設置爲缺省值。

如果字段值缺省,空字段值有不同的解釋:

對於字符串類型,列被設置爲空字符串。
對於數字類型,列被設置爲0。
對於日期和時間類型,列被設置爲該類型的適當“零”值。
如果列有一個NULL,或(只對第一個TIMESTAMP列)在指定一個字段表時,如果TIMESTAMP列從字段表省掉,TIMESTAMP列只被設置爲當前的日期和時間。

如果輸入行有太多的字段,多餘的字段被忽略並且警告數字加1。

LOAD DATA INFILE認爲所有的輸入是字符串,因此你不能像你能用INSERT語句的ENUM或SET列的方式使用數字值。所有的ENUM和SET值必須作爲字符串被指定!

如果你正在使用C API,當LOAD DATA INFILE查詢完成時,你可通過調用API函數mysql_info()得到有關查詢的信息。信息字符串的格式顯示在下面:

Records: 1 Deleted: 0 Skipped: 0 Warnings: 0
當值通過INSERT語句插入時,在某些情況下出現警告,除了在輸入行中有太少或太多的字段時,LOAD DATA INFILE也產生警告。警告沒被存儲在任何地方;警告數字僅能用於表明一切是否順利。如果你得到警告並且想要確切知道你爲什麼得到他們,一個方法是使用SELECT ... INTO OUTFILE到另外一個文件並且把它與你的原版輸入文件比較。
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章