mysqlimport 用戶端為 LOAD DATA SQL 陳述式提供了命令列介面。mysqlimport 的大多數選項直接對應於 LOAD DATA 語法的子句。請參閱 第 15.2.9 節,「LOAD DATA 陳述式」。
像這樣呼叫 mysqlimport
mysqlimport [options] db_name textfile1 [textfile2 ...]對於命令列上命名的每個文字檔案,mysqlimport 會從檔案名稱中移除任何副檔名,並使用結果來判斷要將檔案內容匯入的資料表名稱。例如,名為 patient.txt、patient.text 和 patient 的檔案都會匯入名為 patient 的資料表。
mysqlimport 支援以下選項,這些選項可以在命令列中或選項檔案的 [mysqlimport] 和 [client] 群組中指定。如需 MySQL 程式使用的選項檔案的相關資訊,請參閱 第 6.2.2.2 節,「使用選項檔案」。
表 6.14 mysqlimport 選項
| 選項名稱 | 描述 |
|---|---|
| --bind-address | 使用指定的網路介面連線至 MySQL 伺服器 |
| --character-sets-dir | 可以找到字元集的目錄 |
| --columns | 此選項採用逗號分隔的欄位名稱清單作為其值 |
| --compress | 壓縮用戶端和伺服器之間傳送的所有資訊 |
| --compression-algorithms | 允許連線至伺服器的壓縮演算法 |
| --debug | 寫入偵錯記錄 |
| --debug-check | 程式結束時列印偵錯資訊 |
| --debug-info | 程式結束時列印偵錯資訊、記憶體和 CPU 統計資料 |
| --default-auth | 要使用的驗證外掛程式 |
| --default-character-set | 指定預設字元集 |
| --defaults-extra-file | 除了常用的選項檔案外,還讀取指定的選項檔案 |
| --defaults-file | 僅讀取指定的選項檔案 |
| --defaults-group-suffix | 選項群組尾碼值 |
| --delete | 在匯入文字檔案之前清空資料表 |
| --enable-cleartext-plugin | 啟用明文驗證外掛程式 |
| --fields-enclosed-by | 此選項與 LOAD DATA 的對應子句具有相同意義 |
| --fields-escaped-by | 此選項與 LOAD DATA 的對應子句具有相同意義 |
| --fields-optionally-enclosed-by | 此選項與 LOAD DATA 的對應子句具有相同意義 |
| --fields-terminated-by | 此選項與 LOAD DATA 的對應子句具有相同意義 |
| --force | 即使發生 SQL 錯誤也繼續執行 |
| --get-server-public-key | 向伺服器請求 RSA 公開金鑰 |
| --help | 顯示說明訊息並結束 |
| --host | MySQL 伺服器所在的的主機 |
| --ignore | 請參閱 --replace 選項的說明 |
| --ignore-lines | 忽略資料檔案的前 N 行 |
| --lines-terminated-by | 此選項與 LOAD DATA 的對應子句具有相同意義 |
| --local | 從用戶端主機本機讀取輸入檔案 |
| --lock-tables | 在處理任何文字檔案之前鎖定所有資料表以進行寫入 |
| --login-path | 從 .mylogin.cnf 讀取登入路徑選項 |
| --low-priority | 載入資料表時使用 LOW_PRIORITY |
| --no-defaults | 不讀取任何選項檔案 |
| --no-login-paths | 不從登入路徑檔案讀取登入路徑 |
| --password | 連線至伺服器時要使用的密碼 |
| --password1 | 連線至伺服器時要使用的第一個多因素驗證密碼 |
| --password2 | 連線至伺服器時要使用的第二個多因素驗證密碼 |
| --password3 | 連線至伺服器時要使用的第三個多因素驗證密碼 |
| --pipe | 使用具名管道連線至伺服器 (僅限 Windows) |
| --plugin-dir | 安裝外掛程式的目錄 |
| --port | 連線的 TCP/IP 通訊埠號碼 |
| --print-defaults | 列印預設選項 |
| --protocol | 要使用的傳輸協定 |
| --replace | --replace 和 --ignore 選項控制如何處理在唯一鍵值上與現有資料列重複的輸入資料列。 |
--server-public-key-path |
包含 RSA 公開金鑰的檔案路徑名稱。 |
--shared-memory-base-name |
用於共享記憶體連線的共享記憶體名稱(僅限 Windows)。 |
--silent |
僅在發生錯誤時產生輸出。 |
--socket |
要使用的 Unix socket 檔案或 Windows 具名管道。 |
--ssl-ca |
包含信任的 SSL 憑證授權單位清單的檔案。 |
--ssl-capath |
包含信任的 SSL 憑證授權單位憑證檔案的目錄。 |
--ssl-cert |
包含 X.509 憑證的檔案。 |
--ssl-cipher |
連線加密允許的密碼。 |
--ssl-crl |
包含憑證撤銷清單的檔案。 |
--ssl-crlpath |
包含憑證撤銷清單檔案的目錄。 |
--ssl-fips-mode |
是否在用戶端啟用 FIPS 模式。 |
--ssl-key |
包含 X.509 金鑰的檔案。 |
--ssl-mode |
與伺服器連線所需的安全性狀態。 |
--ssl-session-data |
包含 SSL 會期資料的檔案。 |
--ssl-session-data-continue-on-failed-reuse |
如果會期重用失敗,是否建立連線。 |
--tls-ciphersuites |
加密連線允許的 TLSv1.3 密碼套件。 |
--tls-sni-servername |
用戶端提供的伺服器名稱。 |
--tls-version |
加密連線允許的 TLS 通訊協定。 |
--use-threads |
用於平行載入檔案的執行緒數目。 |
--user |
連線至伺服器時要使用的 MySQL 使用者名稱。 |
--verbose |
詳細模式。 |
--version |
顯示版本資訊並結束。 |
--zstd-compression-level |
使用 zstd 壓縮連線至伺服器的壓縮層級。 |
--help,-?命令列格式 --help顯示說明訊息並結束。
-
命令列格式 --bind-address=ip_address在具有多個網路介面的電腦上,使用此選項選擇要用於連線至 MySQL 伺服器的介面。
-
命令列格式 --character-sets-dir=路徑類型 字串 預設值 [無]安裝字元集的目錄。請參閱 第 12.15 節,「字元集組態」。
--columns=,column_list-ccolumn_list命令列格式 --columns=column_list此選項採用逗號分隔的欄位名稱清單作為其值。欄位名稱的順序表示如何將資料檔案欄位與表格欄位匹配。
--compress,-C命令列格式 --compress[={OFF|ON}]已棄用 是 類型 布林值 預設值 OFF如果可能,壓縮用戶端和伺服器之間傳送的所有資訊。請參閱 第 6.2.8 節,「連線壓縮控制」。
此選項已棄用。預期會在未來版本的 MySQL 中移除。請參閱 組態舊版連線壓縮。
--compression-algorithms=value命令列格式 --compression-algorithms=value類型 設定 預設值 未壓縮有效值 zlibzstd未壓縮允許用於連線至伺服器的壓縮演算法。可用的演算法與
protocol_compression_algorithms系統變數相同。預設值為uncompressed。如需詳細資訊,請參閱 第 6.2.8 節,「連線壓縮控制」。
--debug[=,debug_options]-# [debug_options]命令列格式 --debug[=debug_options]類型 字串 預設值 d:t:o寫入偵錯記錄檔。典型的
debug_options字串為d:t:o,。預設值為file_named:t:o。只有在使用
WITH_DEBUG建置 MySQL 時,此選項才可用。Oracle 提供的 MySQL 發行二進位檔未使用此選項建置。-
命令列格式 --debug-check類型 布林值 預設值 FALSE程式結束時列印一些偵錯資訊。
只有在使用
WITH_DEBUG建置 MySQL 時,此選項才可用。Oracle 提供的 MySQL 發行二進位檔未使用此選項建置。 -
命令列格式 --debug-info類型 布林值 預設值 FALSE程式結束時列印偵錯資訊以及記憶體和 CPU 使用率統計資料。
只有在使用
WITH_DEBUG建置 MySQL 時,此選項才可用。Oracle 提供的 MySQL 發行二進位檔未使用此選項建置。 --default-character-set=charset_name命令列格式 --default-character-set=charset_name類型 字串 使用
charset_name作為預設字元集。請參閱 第 12.15 節,「字元集組態」。-
命令列格式 --default-auth=plugin類型 字串 關於要使用的用戶端驗證外掛程式的提示。請參閱 第 8.2.17 節,「可插拔驗證」。
--defaults-extra-file=file_name命令列格式 --defaults-extra-file=file_name類型 檔案名稱 在全域選項檔案之後,但在使用者選項檔案之前(在 Unix 上)讀取此選項檔案。如果檔案不存在或無法存取,則會發生錯誤。如果
file_name不是絕對路徑名稱,則會將其解譯為相對於目前目錄的路徑。如需關於此選項和其他選項檔案選項的更多資訊,請參閱 第 6.2.2.3 節,「影響選項檔案處理的命令列選項」。
-
命令列格式 --defaults-file=file_name類型 檔案名稱 僅使用給定的選項檔案。如果檔案不存在或無法存取,則會發生錯誤。如果
file_name不是絕對路徑名稱,則會將其解譯為相對於目前目錄的路徑。例外:即使使用
--defaults-file,用戶端程式仍會讀取.mylogin.cnf。如需關於此選項和其他選項檔案選項的更多資訊,請參閱 第 6.2.2.3 節,「影響選項檔案處理的命令列選項」。
-
命令列格式 --defaults-group-suffix=str類型 字串 不僅讀取一般的選項群組,也讀取具有一般名稱和
str後綴的群組。例如,mysqlimport 通常讀取[client]和[mysqlimport]群組。如果此選項給定為--defaults-group-suffix=_other,則 mysqlimport 也會讀取[client_other]和[mysqlimport_other]群組。如需關於此選項和其他選項檔案選項的更多資訊,請參閱 第 6.2.2.3 節,「影響選項檔案處理的命令列選項」。
--delete,-D命令列格式 --delete在匯入文字檔案之前清空表格。
-
命令列格式 --enable-cleartext-plugin類型 布林值 預設值 FALSE啟用
mysql_clear_password明文驗證外掛程式。(請參閱 第 8.4.1.4 節,「用戶端明文可插拔驗證」。) --fields-terminated-by=...,--fields-enclosed-by=...,--fields-optionally-enclosed-by=...,--fields-escaped-by=...命令列格式 --fields-terminated-by=字串類型 字串 命令列格式 --fields-enclosed-by=字串類型 字串 命令列格式 --fields-optionally-enclosed-by=字串類型 字串 命令列格式 --fields-escaped-by類型 字串 這些選項的意義與
LOAD DATA的對應子句相同。請參閱 第 15.2.9 節,「LOAD DATA 陳述式」。--force,-f命令列格式 --force忽略錯誤。例如,如果文字檔案的表格不存在,則繼續處理任何剩餘的檔案。如果沒有
--force,則如果表格不存在,mysqlimport 會結束。-
命令列格式 --get-server-public-key類型 布林值 要求伺服器提供基於 RSA 金鑰配對的密碼交換所需的公開金鑰。此選項適用於使用
caching_sha2_password驗證外掛程式進行驗證的用戶端。對於該外掛程式,除非要求,否則伺服器不會傳送公開金鑰。對於不使用該外掛程式進行驗證的帳戶,會忽略此選項。如果未使用基於 RSA 的密碼交換,也會忽略此選項,例如當用戶端使用安全連線連線至伺服器時。如果指定了
--server-public-key-path=,並且指定的是有效的公開金鑰檔案,則會優先於file_name--get-server-public-key。關於
caching_sha2_password外掛程式的資訊,請參閱 第 8.4.1.2 節,「快取 SHA-2 可插拔驗證」。 --host=,host_name-hhost_name命令列格式 --host=host_name類型 字串 預設值 localhost將資料匯入到指定主機上的 MySQL 伺服器。預設主機為
localhost。--ignore,-i命令列格式 --ignore請參閱
--replace選項的說明。-
命令列格式 --ignore-lines=#類型 數值 忽略資料檔案的前
N行。 -
命令列格式 --lines-terminated-by=字串類型 字串 此選項的意義與
LOAD DATA的對應子句相同。例如,若要匯入以歸位字元/換行字元組結尾的 Windows 檔案,請使用--lines-terminated-by="\r\n"。(您可能必須加倍反斜線,具體取決於命令直譯器的跳脫慣例。)請參閱 第 15.2.9 節,「LOAD DATA 陳述式」。 --local,-L命令列格式 --local類型 布林值 預設值 FALSE預設情況下,檔案由伺服器主機上的伺服器讀取。使用此選項,mysqlimport 會在本機用戶端主機上讀取輸入檔案。
若要成功使用 mysqlimport 中的
LOCAL載入操作,伺服器也必須允許本機載入;請參閱 第 8.1.6 節,「LOAD DATA LOCAL 的安全性考量」--lock-tables,-l命令列格式 --lock-tables在處理任何文字檔案之前,鎖定 所有 資料表以進行寫入。這可確保伺服器上的所有資料表都已同步。
-
命令列格式 --login-path=name類型 字串 從
.mylogin.cnf登入路徑檔案中的具名登入路徑讀取選項。「登入路徑」是一個選項群組,其中包含指定要連線的 MySQL 伺服器以及要驗證的身分帳戶的選項。若要建立或修改登入路徑檔案,請使用 mysql_config_editor 公用程式。請參閱 第 6.6.7 節,「mysql_config_editor — MySQL 組態公用程式」。如需關於此選項和其他選項檔案選項的更多資訊,請參閱 第 6.2.2.3 節,「影響選項檔案處理的命令列選項」。
-
命令列格式 --no-login-paths跳過從登入路徑檔案讀取選項。
請參閱
--login-path以取得相關資訊。如需關於此選項和其他選項檔案選項的更多資訊,請參閱 第 6.2.2.3 節,「影響選項檔案處理的命令列選項」。
-
命令列格式 --low-priority在載入資料表時使用
LOW_PRIORITY。這只會影響僅使用資料表層級鎖定的儲存引擎(例如MyISAM、MEMORY和MERGE)。 -
命令列格式 --no-defaults不讀取任何選項檔案。如果程式啟動由於從選項檔案讀取不明選項而失敗,可以使用
--no-defaults來防止讀取這些選項。例外情況是,如果
.mylogin.cnf檔案存在,則在所有情況下都會讀取該檔案。這允許以比在命令列上更安全的方式指定密碼,即使在使用--no-defaults的情況下也一樣。若要建立.mylogin.cnf,請使用 mysql_config_editor 公用程式。請參閱 第 6.6.7 節,「mysql_config_editor — MySQL 組態公用程式」。如需關於此選項和其他選項檔案選項的更多資訊,請參閱 第 6.2.2.3 節,「影響選項檔案處理的命令列選項」。
--password[=,password]-p[password]命令列格式 --password[=password]類型 字串 用於連線到伺服器的 MySQL 帳戶的密碼。密碼值是選用的。如果未提供,mysqlimport 會提示輸入一個密碼。如果提供,則在
--password=或-p與其後的密碼之間必須沒有空格。如果未指定密碼選項,則預設為不傳送密碼。在命令列上指定密碼應視為不安全。若要避免在命令列上提供密碼,請使用選項檔案。請參閱 第 8.1.2.1 節,「最終使用者密碼安全指南」。
若要明確指定沒有密碼,並且 mysqlimport 不應提示輸入密碼,請使用
--skip-password選項。用於連線到伺服器的 MySQL 帳戶的多因素驗證因素 1 的密碼。密碼值是選用的。如果未提供,mysqlimport 會提示輸入一個密碼。如果提供,則在
--password1=與其後的密碼之間必須沒有空格。如果未指定密碼選項,則預設為不傳送密碼。在命令列上指定密碼應視為不安全。若要避免在命令列上提供密碼,請使用選項檔案。請參閱 第 8.1.2.1 節,「最終使用者密碼安全指南」。
若要明確指定沒有密碼,並且 mysqlimport 不應提示輸入密碼,請使用
--skip-password1選項。--password1和--password是同義詞,--skip-password1和--skip-password也是同義詞。用於連線到伺服器的 MySQL 帳戶的多因素驗證因素 2 的密碼。此選項的語意類似於
--password1的語意;如需詳細資訊,請參閱該選項的說明。用於連線到伺服器的 MySQL 帳戶的多因素驗證因素 3 的密碼。此選項的語意類似於
--password1的語意;如需詳細資訊,請參閱該選項的說明。--pipe,-W命令列格式 --pipe類型 字串 在 Windows 上,使用具名管道連線到伺服器。只有在伺服器啟動時啟用
named_pipe系統變數以支援具名管道連線時,此選項才適用。此外,建立連線的使用者必須是named_pipe_full_access_group系統變數所指定的 Windows 群組的成員。-
命令列格式 --plugin-dir=目錄名稱類型 目錄名稱 要在其中尋找外掛程式的目錄。如果使用
--default-auth選項指定驗證外掛程式,但 mysqlimport 找不到外掛程式,請指定此選項。請參閱 第 8.2.17 節,「可插拔驗證」。 --port=,port_num-Pport_num命令列格式 --port=port_num類型 數值 預設值 3306對於 TCP/IP 連線,要使用的連接埠號碼。
-
命令列格式 --print-defaults列印程式名稱以及它從選項檔案取得的所有選項。
如需關於此選項和其他選項檔案選項的更多資訊,請參閱 第 6.2.2.3 節,「影響選項檔案處理的命令列選項」。
--protocol={TCP|SOCKET|PIPE|MEMORY}命令列格式 --protocol=類型類型 字串 預設值 [請參閱文字]有效值 TCPSOCKETPIPEMEMORY用於連線到伺服器的傳輸協定。當其他連線參數通常導致使用您不想要的協定時,此選項很有用。如需允許值的詳細資訊,請參閱 第 6.2.7 節,「連線傳輸協定」。
--replace,-r命令列格式 --replace--replace和--ignore選項控制如何處理輸入列,這些輸入列與現有列的唯一鍵值重複。如果您指定--replace,則新列會取代具有相同唯一鍵值的現有列。如果您指定--ignore,則會略過與現有列的唯一鍵值重複的輸入列。如果您未指定任何選項,當發現重複的鍵值時,就會發生錯誤,並且會忽略其餘的文字檔案。--server-public-key-path=file_name命令列格式 --server-public-key-path=file_name類型 檔案名稱 PEM 格式檔案的路徑名稱,其中包含伺服器用於基於 RSA 金鑰對密碼交換所需的用戶端副本公開金鑰。此選項適用於使用
sha256_password(已棄用) 或caching_sha2_password驗證外掛程式進行驗證的用戶端。對於未使用這些外掛程式進行驗證的帳戶,將會忽略此選項。如果未使用基於 RSA 的密碼交換,也會忽略此選項,例如當用戶端使用安全連線連線到伺服器時。如果指定了
--server-public-key-path=,並且指定的是有效的公開金鑰檔案,則會優先於file_name--get-server-public-key。對於
sha256_password(已棄用),只有在 MySQL 是使用 OpenSSL 建置時,此選項才適用。有關
sha256_password和caching_sha2_password外掛程式的資訊,請參閱 章節 8.4.1.3,「SHA-256 可插拔驗證」和 章節 8.4.1.2,「快取 SHA-2 可插拔驗證」。--shared-memory-base-name=name命令列格式 --shared-memory-base-name=name平台特定 Windows 在 Windows 上,用於透過共用記憶體連線到本機伺服器的共用記憶體名稱。預設值為
MYSQL。共用記憶體名稱區分大小寫。只有當伺服器啟動時啟用了
shared_memory系統變數以支援共用記憶體連線時,此選項才適用。--silent,-s命令列格式 --silent靜默模式。僅在發生錯誤時產生輸出。
--socket=,path-Spath命令列格式 --socket={file_name|pipe_name}類型 字串 對於連線到
localhost,要使用的 Unix socket 檔案,或在 Windows 上,要使用的具名管道的名稱。在 Windows 上,只有當伺服器啟動時啟用了
named_pipe系統變數以支援具名管道連線時,此選項才適用。此外,進行連線的使用者必須是named_pipe_full_access_group系統變數指定的 Windows 群組的成員。以
--ssl開頭的選項指定是否使用加密連線到伺服器,並指示在哪裡找到 SSL 金鑰和憑證。請參閱 加密連線的命令選項。--ssl-fips-mode={OFF|ON|STRICT}命令列格式 --ssl-fips-mode={OFF|ON|STRICT}已棄用 是 類型 列舉 預設值 OFF有效值 OFFONSTRICT控制是否在用戶端啟用 FIPS 模式。
--ssl-fips-mode選項與其他--ssl-選項的不同之處在於,它不被用於建立加密連線,而是用於影響允許哪些加密操作。請參閱 章節 8.8,「FIPS 支援」。xxx允許以下
--ssl-fips-mode值OFF:停用 FIPS 模式。ON:啟用 FIPS 模式。STRICT:啟用「「嚴格」」FIPS 模式。
注意如果 OpenSSL FIPS 物件模組不可用,則
--ssl-fips-mode的唯一允許值為OFF。在這種情況下,將--ssl-fips-mode設定為ON或STRICT會導致用戶端在啟動時產生警告,並在非 FIPS 模式下執行。此選項已棄用。預計會在 MySQL 的未來版本中移除。
--tls-ciphersuites=ciphersuite_list命令列格式 --tls-ciphersuites=ciphersuite_list類型 字串 使用 TLSv1.3 加密連線允許的密碼套件。值是一個或多個以冒號分隔的密碼套件名稱的清單。此選項可以命名的密碼套件取決於用於編譯 MySQL 的 SSL 程式庫。有關詳細資訊,請參閱 章節 8.3.2,「加密連線 TLS 協定和密碼」。
--tls-sni-servername=server_name命令列格式 --tls-sni-servername=server_name類型 字串 指定時,名稱會使用
mysql_options()的MYSQL_OPT_TLS_SNI_SERVERNAME選項傳遞給libmysqlclientC API 程式庫。伺服器名稱不區分大小寫。若要顯示用戶端為目前工作階段指定的伺服器名稱(如果有的話),請檢查Tls_sni_server_name狀態變數。伺服器名稱指示 (SNI) 是 TLS 協定的延伸 (必須使用 TLS 延伸編譯 OpenSSL,此選項才能運作)。SNI 的 MySQL 實作僅代表用戶端。
-
命令列格式 --tls-version=protocol_list類型 字串 預設值 TLSv1,TLSv1.1,TLSv1.2,TLSv1.3(OpenSSL 1.1.1 或更高版本)TLSv1,TLSv1.1,TLSv1.2(否則)加密連線允許的 TLS 協定。值是一個或多個以逗號分隔的協定名稱的清單。此選項可以命名的協定取決於用於編譯 MySQL 的 SSL 程式庫。有關詳細資訊,請參閱 章節 8.3.2,「加密連線 TLS 協定和密碼」。
--user=,user_name-uuser_name命令列格式 --user=user_name類型 字串 用於連線到伺服器的 MySQL 帳戶的使用者名稱。
-
命令列格式 --use-threads=#類型 數值 使用
N個執行緒平行載入檔案。 --verbose,-v命令列格式 --verbose詳細模式。印出有關程式所做操作的更多資訊。
--version,-V命令列格式 --version顯示版本資訊並結束。
--zstd-compression-level=level命令列格式 --zstd-compression-level=#類型 整數 使用
zstd壓縮演算法連線到伺服器時要使用的壓縮等級。允許的等級從 1 到 22,較大的值表示壓縮等級較高。預設的zstd壓縮等級為 3。壓縮等級設定對於未使用zstd壓縮的連線沒有影響。如需詳細資訊,請參閱 第 6.2.8 節,「連線壓縮控制」。
以下是一個範例工作階段,展示了 mysqlimport 的使用
$> mysql -e 'CREATE TABLE imptest(id INT, n VARCHAR(30))' test
$> ed
a
100 Max Sydow
101 Count Dracula
.
w imptest.txt
32
q
$> od -c imptest.txt
0000000 1 0 0 \t M a x S y d o w \n 1 0
0000020 1 \t C o u n t D r a c u l a \n
0000040
$> mysqlimport --local test imptest.txt
test.imptest: Records: 2 Deleted: 0 Skipped: 0 Warnings: 0
$> mysql -e 'SELECT * FROM imptest' test
+------+---------------+
| id | n |
+------+---------------+
| 100 | Max Sydow |
| 101 | Count Dracula |
+------+---------------+