--help, -h

显示帮助消息并退出。

--component-dir=目录名

密钥环组件所在的目录。这通常是本地 MySQL 服务器的 plugin_dir 系统变量的值。

--defaults-extra-file=文件名

在全局选项文件之后但（在 Unix 上）在用户选项文件之前读取此选项文件。如果文件不存在或无法访问，则会发生错误。如果 文件名 不是绝对路径名，则相对于当前目录解释它。

有关此选项文件选项和其他选项文件选项的更多信息，请参阅 第 6.2.2.3 节，“影响选项文件处理的命令行选项”。

--defaults-file=文件名

仅使用给定的选项文件。如果文件不存在或无法访问，则会发生错误。如果 文件名 不是绝对路径名，则相对于当前目录解释它。

例外：即使使用 --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.1 节“缓存 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

包含服务器所需的用于基于 RSA 密钥对的密码交换的公钥的客户端副本的 PEM 格式文件的路径名。此选项适用于使用 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.2 节“SHA-256 可插拔身份验证” 和 第 8.4.1.1 节“缓存 SHA-2 可插拔身份验证”。

--socket=path, -S path

对于 Unix 套接字文件或 Windows 命名管道连接，用于连接到当前正在使用其中一个密钥迁移密钥存储的正在运行的服务器的套接字文件或命名管道。

在 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 协议的扩展（必须使用 TLS 扩展编译 OpenSSL，此选项才能起作用）。MySQL 对 SNI 的实现仅代表客户端。

--tls-version=protocol_list

加密连接允许的 TLS 协议。该值是一个或多个以逗号分隔的协议名称列表。此选项可以命名的协议取决于用于编译 MySQL 的 SSL 库。有关详细信息，请参见 第 8.3.2 节，“加密连接 TLS 协议和密码”。

--user=user_name, -u user_name

用于连接到当前正在使用其中一个密钥迁移密钥库的正在运行的服务器的 MySQL 帐户的用户名。

--verbose, -v

详细模式。生成有关程序功能的更多输出。

--version, -V

显示版本信息并退出。