--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 命令，但 charset 和 delimiter 在非互動模式下除外 (適用於透過管道傳輸到 mysql 或使用 source 命令載入的輸入)。

--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.3 節「用戶端明文可外掛驗證」。）

--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.1 節，「快取 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=value

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

--network-namespace=name

用於 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=PATH

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[=command]

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

--password[=password], -p[password]

用於連線到伺服器的 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=value

在 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.10 節，「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 個字元空間，以及用作列分隔符號的 | 字元各 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

必須執行 FIDO/FIDO2 裝置註冊的因素或多個因素，之後才能使用基於 WebAuthn 裝置的身份驗證。此選項值必須是單一值，或以逗號分隔的兩個值。每個值必須是 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，此選項僅在 MySQL 使用 OpenSSL 建置時適用。

關於 sha256_password 和 caching_sha2_password 外掛程式的資訊，請參閱 章節 8.4.1.2，「SHA-256 可插拔式驗證」 和 章節 8.4.1.1，「快取 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，此選項才能運作）。MySQL 對 SNI 的實作僅代表用戶端。

--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 章，遙測。