--help, -h

顯示說明訊息並結束。

--component-dir=dir_name

金鑰環組件所在的目錄。這通常是本機 MySQL 伺服器的 plugin_dir 系統變數的值。

--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_migrate_keyring 通常會讀取 [mysql_migrate_keyring] 群組。如果將此選項指定為 --defaults-group-suffix=_other，則 mysql_migrate_keyring 也會讀取 [mysql_migrate_keyring_other] 群組。

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

--destination-keyring=name

用於金鑰移轉的目的地金鑰環元件。選項值的格式和解讀方式與 --source-keyring 選項的說明相同。

--destination-keyring-configuration-dir=dir_name

僅當目的地金鑰環元件的全域組態檔包含 "read_local_config": true 時，此選項才適用，表示元件組態包含在本機組態檔中。選項值指定包含該本機檔案的目錄。

--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，-h host_name

目前正在使用其中一個金鑰移轉金鑰庫的執行中伺服器的位置主機。移轉始終在本機主機上發生，因此該選項始終指定連接到本機伺服器的值，例如 localhost、127.0.0.1、::1 或本機主機 IP 位址或主機名稱。

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

--no-defaults

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

例外情況是，如果存在 .mylogin.cnf 檔案，則會在所有情況下讀取它。即使使用 --no-defaults，這樣也可以比在命令列上更安全的方式指定密碼。若要建立 .mylogin.cnf，請使用 mysql_config_editor 公用程式。請參閱第 6.6.7 節「mysql_config_editor — MySQL 組態公用程式」。

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

--online-migration

當執行中的伺服器正在使用金鑰環時，此選項是必要的。它會告知 mysql_migrate_keyring 執行線上金鑰移轉。該選項具有以下效果

--password[=password]，-p[password]

用於連接到目前正在使用其中一個金鑰移轉金鑰庫的執行中伺服器的 MySQL 帳戶密碼。密碼值是可選的。如果未給定密碼，mysql_migrate_keyring 會提示輸入一個。如果給定密碼，則在 --password= 或 -p 與其後的密碼之間不得有空格。如果未指定任何密碼選項，則預設為不傳送密碼。

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

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

--port=port_num，-P port_num

對於 TCP/IP 連線，用於連接到目前正在使用其中一個金鑰移轉金鑰庫的執行中伺服器的連接埠號碼。

--print-defaults

列印程式名稱以及從選項檔案取得的所有選項。

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

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

--socket=path，-S path

對於 Unix Socket 檔案或 Windows 具名管道連線，用於連接到目前正在使用其中一個金鑰移轉金鑰庫的執行中伺服器的 Socket 檔案或具名管道。

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

--source-keyring=name

用於金鑰移轉的來源金鑰環元件。這是指定的元件程式庫檔案名稱，不含任何平台特定的副檔名，例如 .so 或 .dll。例如，若要使用程式庫檔案為 component_keyring_file.so 的元件，請將選項指定為 --source-keyring=component_keyring_file。

--source-keyring-configuration-dir=dir_name

此選項僅在來源金鑰環組件全域組態檔包含 "read_local_config": true 時適用，表示組件組態包含在本機組態檔中。此選項的值指定包含該本機檔案的目錄。

--ssl*

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

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

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

允許使用這些 --ssl-fips-mode 值

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

--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 通訊協定的擴充功能（OpenSSL 必須使用 TLS 擴充功能進行編譯才能使此選項起作用）。SNI 的 MySQL 實作僅代表用戶端。

--tls-version=protocol_list

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

--user=user_name, -u user_name

用於連線到目前使用其中一個金鑰移轉金鑰儲存區的執行中伺服器的 MySQL 帳戶的使用者名稱。

--verbose, -v

詳細模式。產生更多關於程式執行內容的輸出。

--version, -V

顯示版本資訊並結束。