--help, -?

顯示說明訊息並結束。

--auto-rehash

啟用自動重新雜湊。預設會啟用此選項，這會啟用資料庫、資料表和欄位名稱完成。使用 --disable-auto-rehash 來停用重新雜湊。這會導致 mysql 啟動速度更快，但如果您想使用名稱完成，則必須發出 rehash 指令或其 \# 快捷方式。

若要完成名稱，請輸入第一部分並按下 Tab 鍵。如果名稱沒有歧義，mysql 會完成它。否則，您可以再次按下 Tab 鍵，以查看以您目前輸入內容開頭的可能名稱。如果沒有預設資料庫，則不會發生完成。

--auto-vertical-output

如果結果集對於目前的視窗來說太寬，則讓結果集垂直顯示，否則使用正常的表格格式。（這適用於以 ; 或 \G 終止的陳述式。）

--batch, -B

使用 Tab 作為欄分隔符號列印結果，每一列在新的一行上。使用此選項時，mysql 不會使用歷史記錄檔。

批次模式會產生非表格輸出格式和特殊字元的跳脫。可以使用原始模式來停用跳脫；請參閱 --raw 選項的說明。

--binary-as-hex

當提供此選項時，mysql 會使用十六進位標記法 (0xvalue) 顯示二進位資料。無論整體輸出顯示格式是表格、垂直、HTML 或 XML，都會發生這種情況。

啟用時，--binary-as-hex 會影響所有二進位字串的顯示，包括由 CHAR() 和 UNHEX() 等函式傳回的字串。下列範例使用 A 的 ASCII 碼 (十進位 65，十六進位 41) 來說明這一點

若要寫入二進位字串運算式，使其顯示為字元字串，而不論是否啟用 --binary-as-hex，請使用下列技術

當 mysql 在互動模式下運作時，預設會啟用此選項。此外，當隱含或明確啟用選項時，status（或 \s）指令的輸出會包含這一行

Binary data as: Hexadecimal

若要停用十六進位標記法，請使用 --skip-binary-as-hex

--binary-mode

當處理可能包含 BLOB 值的 mysqlbinlog 輸出時，此選項會有所幫助。根據預設，mysql 會將陳述式字串中的 \r\n 轉譯為 \n，並將 \0 解釋為陳述式終止符。--binary-mode 會停用這兩個功能。它也會在非互動模式下 (針對透過管道傳送到 mysql 或使用 source 指令載入的輸入) 停用所有 mysql 指令，除了 charset 和 delimiter 之外。

--bind-address=ip_address

在具有多個網路介面的電腦上，使用此選項來選取要用於連線到 MySQL 伺服器的介面。

--character-sets-dir=dir_name

安裝字元集的目錄。請參閱第 12.15 節「字元集組態」。

--column-names

在結果中寫入欄位名稱。

--column-type-info

顯示結果集的中繼資料。此資訊對應於 C API MYSQL_FIELD 資料結構的內容。請參閱C API 基本資料結構。

--comments, -c

是否保留或移除傳送到伺服器的陳述式中的註解。預設是保留它們；若要移除它們，請使用 --skip-comments 啟動 mysql。

--compress, -C

如果可能，壓縮用戶端和伺服器之間傳送的所有資訊。請參閱第 6.2.8 節「連線壓縮控制」。

此選項已棄用。預期在未來的 MySQL 版本中移除它。請參閱設定舊版連線壓縮。

--compression-algorithms=value

與伺服器連線時允許的壓縮演算法。可用的演算法與 protocol_compression_algorithms 系統變數相同。預設值為 uncompressed。

更多資訊，請參閱 第 6.2.8 節， “連線壓縮控制”。

--connect-expired-password

告知伺服器，如果用於連線的帳戶密碼已過期，客戶端可以處理沙箱模式。這對於 mysql 的非互動式調用可能很有用，因為通常伺服器會斷開嘗試使用密碼過期的帳戶連線的非互動式客戶端。（請參閱 第 8.2.16 節，「伺服器處理過期密碼」。）

--connect-timeout=value

連線逾時前的秒數。（預設值為 0。）

--database=db_name, -D db_name

要使用的資料庫。這在選項檔案中特別有用。

--debug[=debug_options], -# [debug_options]

寫入除錯日誌。典型的 debug_options 字串為 d:t:o,file_name。預設值為 d:t:o,/tmp/mysql.trace。

只有在使用 WITH_DEBUG 建置 MySQL 時，此選項才可用。 Oracle 提供的 MySQL 發行二進位檔案 沒有 使用此選項建置。

--debug-check

程式結束時列印一些除錯資訊。

只有在使用 WITH_DEBUG 建置 MySQL 時，此選項才可用。 Oracle 提供的 MySQL 發行二進位檔案 沒有 使用此選項建置。

--debug-info, -T

程式結束時列印除錯資訊以及記憶體和 CPU 使用統計資料。

只有在使用 WITH_DEBUG 建置 MySQL 時，此選項才可用。 Oracle 提供的 MySQL 發行二進位檔案 沒有 使用此選項建置。

--default-auth=plugin

關於要使用哪個用戶端驗證外掛程式的提示。請參閱 第 8.2.17 節，「可外掛驗證」。

--default-character-set=charset_name

使用 charset_name 作為用戶端和連線的預設字元集。

如果作業系統使用一個字元集，而 mysql 客戶端預設使用另一個字元集，則此選項可能很有用。在這種情況下，輸出可能會格式不正確。您通常可以使用此選項強制客戶端改用系統字元集來解決此類問題。

更多資訊，請參閱 第 12.4 節，「連線字元集與校對」和 第 12.15 節，「字元集組態」。

--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 字尾的群組。例如，mysql 通常讀取 [client] 和 [mysql] 群組。如果將此選項指定為 --defaults-group-suffix=_other，mysql 也會讀取 [client_other] 和 [mysql_other] 群組。

有關此選項和其他選項檔案選項的其他資訊，請參閱 第 6.2.2.3 節，「影響選項檔案處理的命令列選項」。

--delimiter=str

設定語句分隔符號。預設值為分號字元 (;)。

--disable-named-commands

停用具名命令。僅使用 \* 形式，或僅在以分號 (;) 結尾的行開頭使用具名命令。mysql 預設啟用了此選項。但是，即使使用此選項，長格式命令仍然可以從第一行起作用。請參閱 第 6.5.1.2 節，「mysql 客戶端命令」。

--dns-srv-name=name

指定 DNS SRV 記錄的名稱，該記錄決定用於建立與 MySQL 伺服器連線的候選主機。有關 MySQL 中 DNS SRV 支援的資訊，請參閱 第 6.2.6 節，「使用 DNS SRV 記錄連線到伺服器」。

假設 DNS 為 example.com 網域設定了此 SRV 資訊

Name                     TTL   Class   Priority Weight Port Target
_mysql._tcp.example.com. 86400 IN SRV  0        5      3306 host1.example.com
_mysql._tcp.example.com. 86400 IN SRV  0        10     3306 host2.example.com
_mysql._tcp.example.com. 86400 IN SRV  10       5      3306 host3.example.com
_mysql._tcp.example.com. 86400 IN SRV  20       5      3306 host4.example.com

若要使用該 DNS SRV 記錄，請像這樣調用 mysql

mysql --dns-srv-name=_mysql._tcp.example.com

mysql 接著會嘗試連線至群組中的每個伺服器，直到建立成功的連線。只有在無法建立與任何伺服器的連線時，才會發生連線失敗。DNS SRV 記錄中的優先順序和權重值決定應該嘗試伺服器的順序。

使用 --dns-srv-name 調用時，mysql 僅嘗試建立 TCP 連線。

如果同時給定 --dns-srv-name 和 --host 選項，則 --dns-srv-name 選項優先。 --dns-srv-name 會導致連線建立使用 mysql_real_connect_dns_srv() C API 函數，而不是 mysql_real_connect()。但是，如果在執行階段隨後使用 connect 命令並指定了主機名稱引數，則該主機名稱優先於在 mysql 啟動時指定的任何 --dns-srv-name 選項，以指定 DNS SRV 記錄。

--enable-cleartext-plugin

啟用 mysql_clear_password 明文驗證外掛程式。（請參閱 第 8.4.1.4 節，「用戶端明文可外掛驗證」。）

--execute=statement, -e statement

執行語句並退出。預設輸出格式類似於使用 --batch 產生的格式。如需範例，請參閱 第 6.2.2.1 節，「在命令列上使用選項」。使用此選項時，mysql 不會使用歷史記錄檔。

--force、-f

即使發生 SQL 錯誤也繼續執行。

--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 可插入驗證」。

--histignore

一個或多個以冒號分隔的模式清單，用於指定要忽略以進行記錄的語句。這些模式會新增至預設模式清單 ("*IDENTIFIED*:*PASSWORD*")。為此選項指定的值會影響寫入歷史記錄檔以及如果給定 --syslog 選項則會影響寫入 syslog 的語句記錄。如需更多資訊，請參閱 第 6.5.1.3 節，「mysql 用戶端記錄」。

--host=host_name、-h host_name

連線至指定主機上的 MySQL 伺服器。

如果同時給定 --dns-srv-name 和 --host 選項，則 --dns-srv-name 選項優先。 --dns-srv-name 會導致連線建立使用 mysql_real_connect_dns_srv() C API 函數，而不是 mysql_real_connect()。但是，如果在執行階段隨後使用 connect 命令並指定了主機名稱引數，則該主機名稱優先於在 mysql 啟動時指定的任何 --dns-srv-name 選項，以指定 DNS SRV 記錄。

--html、-H

產生 HTML 輸出。

--ignore-spaces、-i

忽略函式名稱後面的空格。其效果在 IGNORE_SPACE SQL 模式的討論中有說明（請參閱 第 7.1.11 節，「伺服器 SQL 模式」）。

--init-command=str

連線到伺服器後要執行的單一 SQL 語句。如果啟用自動重新連線，則會在發生重新連線後再次執行該語句。該定義會重設由它或 init-command-add 定義的現有語句。

--init-command-add=str

新增一個額外的 SQL 語句，以便在連線或重新連線到 MySQL 伺服器後執行。它可以在沒有 --init-command 的情況下使用，但如果在它之前使用則無效，因為 init-command 會重設要呼叫的命令清單。

--line-numbers

寫入錯誤的行號。使用 --skip-line-numbers 停用此功能。

--load-data-local-dir=dir_name

此選項會影響 LOAD DATA 作業的用戶端 LOCAL 功能。它指定 LOAD DATA LOCAL 語句中命名的檔案必須所在的目錄。--load-data-local-dir 的效果取決於是否啟用或停用 LOCAL 資料載入。

當 --load-data-local-dir 適用時，選項值會指定本地資料檔案必須所在的目錄。無論基礎檔案系統的大小寫靈敏度如何，都會區分目錄路徑名稱與要載入的檔案路徑名稱的大小寫。如果選項值為空字串，則表示沒有目錄，因此不允許任何檔案用於本機資料載入。

例如，若要明確停用本機資料載入，除非檔案位於 /my/local/data 目錄中，否則可以像這樣叫用 mysql

mysql --local-infile=0 --load-data-local-dir=/my/local/data

當同時給定 --local-infile 和 --load-data-local-dir 時，它們給定的順序無關緊要。

在 mysql 中成功使用 LOCAL 載入作業也需要伺服器允許本機載入；請參閱 第 8.1.6 節，「LOAD DATA LOCAL 的安全性考量」

--local-infile[={0|1}]

預設情況下，LOAD DATA 的 LOCAL 功能由編譯到 MySQL 用戶端程式庫中的預設值決定。若要明確啟用或停用 LOCAL 資料載入，請使用 --local-infile 選項。當不帶值給定時，此選項會啟用 LOCAL 資料載入。當以 --local-infile=0 或 --local-infile=1 給定時，此選項會停用或啟用 LOCAL 資料載入。

如果停用 LOCAL 功能，則可以使用 --load-data-local-dir 選項，以允許限制性地載入指定目錄中的檔案。

在 mysql 中成功使用 LOCAL 載入作業也需要伺服器允許本機載入；請參閱 第 8.1.6 節，「LOAD DATA LOCAL 的安全性考量」

--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 節，「影響選項檔案處理的命令列選項」。

--max-allowed-packet=value

客戶端/伺服器通訊的緩衝區最大大小。預設值為 16MB，最大值為 1GB。

--max-join-size=value

使用 --safe-updates 時，聯結中資料列的自動限制。（預設值為 1,000,000。）

--named-commands、-G

啟用具名的 mysql 命令。允許使用長格式命令，而不僅限於短格式命令。例如，quit 和 \q 都會被識別。使用 --skip-named-commands 來停用具名命令。請參閱 第 6.5.1.2 節，「mysql 用戶端命令」。

--net-buffer-length=值

用於 TCP/IP 和 socket 通訊的緩衝區大小。（預設值為 16KB。）

--network-namespace=名稱

用於 TCP/IP 連線的網路命名空間。如果省略，連線會使用預設（全域）命名空間。有關網路命名空間的資訊，請參閱 第 7.1.14 節，「網路命名空間支援」。

此選項僅適用於實作網路命名空間支援的平台。

--no-auto-rehash, -A

這與 --skip-auto-rehash 的效果相同。請參閱 --auto-rehash 的說明。

--no-beep, -b

發生錯誤時不發出嗶聲。

--no-defaults

不讀取任何選項檔案。如果程式啟動因從選項檔案讀取未知選項而失敗，可以使用 --no-defaults 來防止讀取這些選項。

例外情況是，.mylogin.cnf 檔案在所有情況下都會被讀取（如果存在）。即使使用 --no-defaults，也可以更安全地指定密碼，而不是在命令列上指定。要建立 .mylogin.cnf，請使用 mysql_config_editor 公用程式。請參閱 第 6.6.7 節，「mysql_config_editor — MySQL 設定公用程式」。

有關此選項和其他選項檔案選項的其他資訊，請參閱 第 6.2.2.3 節，「影響選項檔案處理的命令列選項」。

--oci-config-file=路徑

Oracle Cloud Infrastructure CLI 設定檔的替代路徑。指定設定檔的位置。如果現有的預設設定檔正確，則無需指定此選項。但是，如果您有現有的設定檔，其中包含多個設定檔，或與您想要連線的使用者的租用戶不同的預設設定檔，請指定此選項。

--one-database, -o

忽略語句，除非在預設資料庫是在命令列上指定的資料庫時才會執行。此選項很基本，應謹慎使用。語句篩選僅基於 USE 語句。

最初，mysql 會執行輸入中的語句，因為在命令列上指定資料庫 db_name 等同於在輸入的開頭插入 USE db_name。然後，對於遇到的每個 USE 語句，mysql 會根據命名的資料庫是否為命令列上的資料庫來接受或拒絕後續的語句。語句的內容並不重要。

假設呼叫 mysql 來處理這組語句

DELETE FROM db2.t2;
USE db2;
DROP TABLE db1.t1;
CREATE TABLE db1.t1 (i INT);
USE db1;
INSERT INTO t1 (i) VALUES(1);
CREATE TABLE db2.t1 (j INT);

如果命令列是 mysql --force --one-database db1，mysql 會如下處理輸入

--pager[=命令]

使用給定的命令來分頁查詢輸出。如果省略該命令，預設的分頁器是您的 PAGER 環境變數的值。有效的分頁器包括 less、more、cat [> filename] 等。此選項僅在 Unix 上且僅在互動模式下有效。要停用分頁，請使用 --skip-pager。第 6.5.1.2 節，「mysql 用戶端命令」 進一步討論了輸出分頁。

--password[=密碼], -p[密碼]

用於連線至伺服器的 MySQL 帳戶的密碼。密碼值是選填的。如果未指定，mysql 會提示輸入一個密碼。如果指定了密碼，--password= 或 -p 與其後的密碼之間不得有空格。如果未指定密碼選項，預設是不傳送密碼。

在命令列上指定密碼應被視為不安全的做法。若要避免在命令列上提供密碼，請使用選項檔案。請參閱 第 8.1.2.1 節，「最終使用者密碼安全性指南」。

若要明確指定沒有密碼，並且 mysql 不應提示輸入密碼，請使用 --skip-password 選項。

--password1[=pass_val]

用於連線至伺服器的 MySQL 帳戶的多因素驗證因素 1 的密碼。密碼值是選填的。如果未指定，mysql 會提示輸入一個密碼。如果指定了密碼，--password1= 與其後的密碼之間不得有空格。如果未指定密碼選項，預設是不傳送密碼。

在命令列上指定密碼應被視為不安全的做法。若要避免在命令列上提供密碼，請使用選項檔案。請參閱 第 8.1.2.1 節，「最終使用者密碼安全性指南」。

若要明確指定沒有密碼，並且 mysql 不應提示輸入密碼，請使用 --skip-password1 選項。

--password1 和 --password 是同義詞，--skip-password1 和 --skip-password 也是同義詞。

--password2[=pass_val]

用於連線至伺服器的 MySQL 帳戶的多因素驗證因素 2 的密碼。此選項的語意與 --password1 的語意類似；詳細資訊請參閱該選項的說明。

--password3[=pass_val]

用於連線至伺服器的 MySQL 帳戶的多因素驗證因素 3 的密碼。此選項的語意與 --password1 的語意類似；詳細資訊請參閱該選項的說明。

--pipe, -W

在 Windows 上，使用具名管道連線至伺服器。此選項僅在伺服器啟動時啟用 named_pipe 系統變數以支援具名管道連線時適用。此外，建立連線的使用者必須是 named_pipe_full_access_group 系統變數指定的 Windows 群組的成員。

--plugin-authentication-kerberos-client-mode=值

在 Windows 上，authentication_kerberos_client 驗證外掛程式支援此外掛程式選項。它提供了用戶端使用者可以在執行時設定的兩個可能的值：SSPI 和 GSSAPI。

用戶端外掛程式選項的預設值使用安全性支援提供者介面 (SSPI)，該介面能夠從 Windows 的記憶體內快取中取得認證。或者，用戶端使用者可以選擇一種模式，該模式透過 Windows 上的 MIT Kerberos 程式庫支援通用安全服務應用程式介面 (GSSAPI)。GSSAPI 能夠取得先前使用 kinit 命令產生的快取認證。

如需更多資訊，請參閱 GSSAPI 模式下 Windows 用戶端的命令。

--plugin-authentication-webauthn-client-preserve-privacy={OFF|ON}

決定在針對給定的 RP ID（即依賴方伺服器，也就是 MySQL 伺服器所給定的唯一名稱）儲存多個可探索憑證時，如何將斷言傳送到伺服器。如果 FIDO2 裝置針對給定的 RP ID 包含多個常駐金鑰，此選項可讓使用者選擇要用於斷言的金鑰。它提供兩個用戶端使用者可以設定的值。預設值為 OFF。如果設定為 OFF，則會由給定 RP ID 的所有可用憑證簽署質詢，並且所有簽名都會傳送到伺服器。如果設定為 ON，則會提示使用者選擇要用於簽署的憑證。

如需更多資訊，請參閱第 8.4.1.11 節「WebAuthn 可插拔驗證」。

--plugin-dir=dir_name

要搜尋外掛程式的目錄。如果使用 --default-auth 選項來指定驗證外掛程式，但 mysql 找不到該外掛程式時，請指定此選項。請參閱第 8.2.17 節「可插拔驗證」。

--port=port_num, -P port_num

用於 TCP/IP 連線的連接埠號碼。

--print-defaults

列印程式名稱和它從選項檔取得的所有選項。

有關此選項和其他選項檔案選項的其他資訊，請參閱 第 6.2.2.3 節，「影響選項檔案處理的命令列選項」。

--prompt=format_str

將提示設定為指定的格式。預設值為 mysql>。提示可以包含的特殊序列在第 6.5.1.2 節「mysql 用戶端命令」中說明。

--protocol={TCP|SOCKET|PIPE|MEMORY}

用於連線到伺服器的傳輸協定。當其他連線參數通常會導致使用您不想要的協定時，這很有用。有關允許的值的詳細資訊，請參閱第 6.2.7 節「連線傳輸協定」。

--quick, -q

不要快取每個查詢結果，而是在收到每個資料列時列印。如果輸出暫停，這可能會減慢伺服器的速度。使用此選項，mysql 不會使用歷史記錄檔。

依預設，mysql 會先擷取所有結果資料列，然後再產生任何輸出；在儲存這些資料列時，它會從每個連續的資料行實際值計算執行的最大資料行長度。列印輸出時，它會使用此最大值來格式化。指定 --quick 時，mysql 沒有資料列來計算開始之前的長度，因此使用最大長度。在以下範例中，表格 t1 有一個 BIGINT 類型的單一資料行，並包含 4 個資料列。預設輸出寬度為 9 個字元；此寬度等於傳回資料列中任何資料行值的最大字元數 (5)，加上用於填補的 2 個字元空格，以及用作資料行分隔符號的 | 字元。使用 --quick 選項時的輸出寬度為 25 個字元；這等於代表 -9223372036854775808 所需的字元數，這是可以儲存在 (帶正負號) BIGINT 資料行的最長可能值，即 19 個字元，加上用於填補和資料行分隔符號的 4 個字元。差異可在此處看到

$> mysql -t test -e "SELECT * FROM t1"
+-------+
| c1    |
+-------+
|   100 |
|  1000 |
| 10000 |
|    10 |
+-------+

$> mysql --quick -t test -e "SELECT * FROM t1"
+----------------------+
| c1                   |
+----------------------+
|                  100 |
|                 1000 |
|                10000 |
|                   10 |
+----------------------+

--raw, -r

對於表格輸出，資料行周圍的「框線」可以區分一個資料行值與另一個資料行值。對於非表格輸出（例如在批次模式下產生，或者當提供 --batch 或 --silent 選項時），輸出中的特殊字元會經過跳脫，以便可以輕鬆識別。換行符號、定位點、NUL 和反斜線會寫入為 \n、\t、\0 和 \\。--raw 選項會停用此字元跳脫。

以下範例示範了表格輸出與非表格輸出，以及使用原始模式停用跳脫

% mysql
mysql> SELECT CHAR(92);
+----------+
| CHAR(92) |
+----------+
| \        |
+----------+

% mysql -s
mysql> SELECT CHAR(92);
CHAR(92)
\\

% mysql -s -r
mysql> SELECT CHAR(92);
CHAR(92)
\

--reconnect

如果與伺服器的連線中斷，請自動嘗試重新連線。每次連線中斷時，都會進行一次重新連線嘗試。若要取消重新連線行為，請使用 --skip-reconnect。

--register-factor=value

在使用基於 WebAuthn 裝置的驗證之前，必須執行 FIDO/FIDO2 裝置註冊的因素。此選項值必須是單一值，或是以逗號分隔的兩個值。每個值必須是 2 或 3，因此允許的選項值為 '2'、'3'、'2,3' 和 '3,2'。

例如，需要註冊第三個驗證因素的帳戶會呼叫 mysql 用戶端，如下所示

mysql --user=user_name --register-factor=3

需要註冊第二個和第三個驗證因素的帳戶會呼叫 mysql 用戶端，如下所示

mysql --user=user_name --register-factor=2,3

如果註冊成功，就會建立連線。如果存在具有待定註冊的驗證因素，則在嘗試連線至伺服器時，連線會置於待定註冊模式。在這種情況下，請使用正確的 --register-factor 值中斷連線並重新連線，以完成註冊。

註冊是包含起始註冊和完成註冊步驟的兩步驟程序。起始註冊步驟會執行此陳述式

ALTER USER user factor INITIATE REGISTRATION

該陳述式會傳回包含 32 位元組質詢、使用者名稱和依賴方 ID（請參閱authentication_webauthn_rp_id）的結果集。

完成註冊步驟會執行此陳述式

ALTER USER user factor FINISH REGISTRATION SET CHALLENGE_RESPONSE AS 'auth_string'

該陳述式會完成註冊，並將以下資訊傳送至伺服器作為 auth_string 的一部分：驗證器資料、X.509 格式的可選證明憑證和簽名。

起始和註冊步驟必須在單一連線中執行，因為用戶端在起始步驟期間收到的質詢會儲存至用戶端連線處理常式。如果註冊步驟是由不同的連線執行，註冊將會失敗。--register-factor 選項會執行起始和註冊步驟，這可避免上述失敗情況，並防止必須手動執行 ALTER USER 起始和註冊陳述式。

--register-factor 選項僅適用於 mysql 和 MySQL Shell 用戶端。其他 MySQL 用戶端程式不支援此選項。

有關相關資訊，請參閱使用 WebAuthn 驗證。

--safe-updates, --i-am-a-dummy, -U

如果啟用此選項，則不使用 WHERE 子句中的索引鍵或 LIMIT 子句的 UPDATE 和 DELETE 陳述式會產生錯誤。此外，也會對產生（或預計產生）非常大結果集的 SELECT 陳述式施加限制。如果您已在選項檔中設定此選項，則可以在命令列上使用 --skip-safe-updates 來覆寫它。有關此選項的更多資訊，請參閱使用安全更新模式 (--safe-updates)。

--select-limit=value

在使用 --safe-updates 時，SELECT 陳述式的自動限制。（預設值為 1,000。）

--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（已淘汰），此選項僅在使用 OpenSSL 建置 MySQL 時適用。

有關 sha256_password 和 caching_sha2_password 外掛程式的資訊，請參閱第 8.4.1.3 節「SHA-256 可插拔驗證」和第 8.4.1.2 節「快取 SHA-2 可插拔驗證」。

--shared-memory-base-name=name

在 Windows 上，使用共享記憶體連線到本機伺服器時所使用的共享記憶體名稱。預設值為 MYSQL。共享記憶體名稱區分大小寫。

只有在啟動伺服器時，啟用 shared_memory 系統變數以支援共享記憶體連線時，此選項才適用。

--show-warnings

如果每個語句執行後有任何警告，則顯示警告。此選項適用於互動模式和批次模式。

--sigint-ignore

忽略 SIGINT 訊號（通常是按下 Control+C 的結果）。

如果沒有此選項，按下 Control+C 會中斷目前的語句（如果有的話），否則會取消任何部分輸入行。

--silent, -s

靜默模式。產生較少的輸出。可以多次給定此選項，以產生越來越少的輸出。

此選項會導致非表格輸出格式和特殊字元跳脫。可以使用原始模式停用跳脫；請參閱 --raw 選項的說明。

--skip-column-names, -N

不在結果中寫入欄位名稱。使用此選項會導致輸出靠右對齊，如下所示

$> echo "SELECT * FROM t1" | mysql -t test
+-------+
| c1    |
+-------+
| a,c,d |
| c     |
+-------+
$> echo "SELECT * FROM t1" | ./mysql -uroot -Nt test
+-------+
| a,c,d |
|     c |
+-------+

--skip-line-numbers, -L

不寫入錯誤的行號。當您想要比較包含錯誤訊息的結果檔案時，此選項很有用。

--socket=path, -S path

對於連線到 localhost，要使用的 Unix socket 檔案，或在 Windows 上，要使用的具名管道名稱。

在 Windows 上，只有在啟動伺服器時，啟用 named_pipe 系統變數以支援具名管道連線時，此選項才適用。此外，進行連線的使用者必須是 named_pipe_full_access_group 系統變數指定的 Windows 群組的成員。

--ssl*

開頭為 --ssl 的選項指定是否使用加密連線到伺服器，並指出在哪裡找到 SSL 金鑰和憑證。請參閱加密連線的命令選項。

--ssl-fips-mode={OFF|ON|STRICT}

控制是否在用戶端啟用 FIPS 模式。 --ssl-fips-mode 選項與其他 --ssl-xxx 選項不同，因為它不用于建立加密連線，而是用於影響允許哪些加密操作。請參閱 第 8.8 節「FIPS 支援」。

允許以下 --ssl-fips-mode 值

此選項已棄用。預期會在未來版本的 MySQL 中移除。

--syslog, -j

此選項會導致 mysql 將互動式語句傳送到系統記錄設備。在 Unix 上，這是 syslog；在 Windows 上，這是 Windows 事件記錄檔。記錄訊息出現的目的地取決於系統。在 Linux 上，目的地通常是 /var/log/messages 檔案。

以下是使用 --syslog 在 Linux 上產生的輸出範例。此輸出已格式化以提高可讀性；每個記錄的訊息實際上都佔一行。

Mar  7 12:39:25 myhost MysqlClient[20824]:
  SYSTEM_USER:'oscar', MYSQL_USER:'my_oscar', CONNECTION_ID:23,
  DB_SERVER:'127.0.0.1', DB:'--', QUERY:'USE test;'
Mar  7 12:39:28 myhost MysqlClient[20824]:
  SYSTEM_USER:'oscar', MYSQL_USER:'my_oscar', CONNECTION_ID:23,
  DB_SERVER:'127.0.0.1', DB:'test', QUERY:'SHOW TABLES;'

有關詳細資訊，請參閱 第 6.5.1.3 節「mysql 用戶端記錄」。

--table, -t

以表格格式顯示輸出。這是互動式使用的預設值，但可用於在批次模式中產生表格輸出。

--tee=file_name

將輸出的副本附加到給定的檔案。此選項僅在互動模式下有效。第 6.5.1.2 節「mysql 用戶端命令」進一步討論了 tee 檔案。

--tls-ciphersuites=ciphersuite_list

使用 TLSv1.3 的加密連線允許的密碼套件。此值是一個或多個以冒號分隔的密碼套件名稱的清單。可以為此選項命名的密碼套件取決於用於編譯 MySQL 的 SSL 程式庫。如需詳細資訊，請參閱 第 8.3.2 節「加密連線 TLS 協定和密碼」。

--tls-sni-servername=server_name

指定後，名稱會使用 mysql_options() 的 MYSQL_OPT_TLS_SNI_SERVERNAME 選項傳遞至 libmysqlclient C API 程式庫。伺服器名稱不區分大小寫。若要顯示用戶端為目前工作階段指定的伺服器名稱（如果有的話），請檢查 Tls_sni_server_name 狀態變數。

伺服器名稱指示 (SNI) 是 TLS 協定的擴充功能（必須使用 TLS 擴充功能編譯 OpenSSL，此選項才能運作）。SNI 的 MySQL 實作僅代表用戶端。

--tls-version=protocol_list

加密連線允許的 TLS 協定。此值是一個或多個以逗號分隔的協定名稱的清單。可以為此選項命名的協定取決於用於編譯 MySQL 的 SSL 程式庫。如需詳細資訊，請參閱 第 8.3.2 節「加密連線 TLS 協定和密碼」。

--unbuffered, -n

在每個查詢後清除緩衝區。

--user=user_name, -u user_name

用於連線到伺服器的 MySQL 帳戶的使用者名稱。

--verbose, -v

詳細模式。產生更多關於程式所執行操作的輸出。可以多次給定此選項，以產生越來越多的輸出。（例如，-v -v -v 即使在批次模式下也會產生表格輸出格式。）

--version, -V

顯示版本資訊並結束。

--vertical, -E

垂直列印查詢輸出列（每個欄位值一行）。如果沒有此選項，您可以透過以 \G 終止來指定個別語句的垂直輸出。

--wait, -w

如果無法建立連線，則等待並重試，而不是中止。

--xml, -X

產生 XML 輸出。

<field name="column_name">NULL</field>

使用 --xml 與 mysql 時的輸出與 mysqldump --xml 的輸出相符。如需詳細資訊，請參閱 第 6.5.4 節「mysqldump — 資料庫備份程式」。

XML 輸出也使用 XML 命名空間，如下所示

$> mysql --xml -uroot -e "SHOW VARIABLES LIKE 'version%'"
<?xml version="1.0"?>

<resultset statement="SHOW VARIABLES LIKE 'version%'" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<row>
<field name="Variable_name">version</field>
<field name="Value">5.0.40-debug</field>
</row>

<row>
<field name="Variable_name">version_comment</field>
<field name="Value">Source distribution</field>
</row>

<row>
<field name="Variable_name">version_compile_machine</field>
<field name="Value">i686</field>
</row>

<row>
<field name="Variable_name">version_compile_os</field>
<field name="Value">suse-linux-gnu</field>
</row>
</resultset>

--zstd-compression-level=level

用於連線到伺服器時，使用 zstd 壓縮演算法的壓縮層級。允許的層級為 1 到 22，值越大表示壓縮層級越高。預設的 zstd 壓縮層級為 3。壓縮層級設定對不使用 zstd 壓縮的連線沒有影響。

更多資訊，請參閱 第 6.2.8 節， “連線壓縮控制”。

telemetry_client

啟用遙測用戶端外掛程式 (僅限 Linux)。

有關詳細資訊，請參閱 第 35 章《遙測》。