### 4.6.8 mysql\_迁移\_keyring - 密钥环密钥迁移实用程序

[](<>)

这[**mysql\_迁移\_钥匙圈**](mysql-migrate-keyring.html)实用程序在一个密钥环组件和另一个之间迁移密钥。它支持离线和在线迁移。

调用[**mysql\_迁移\_钥匙圈**](mysql-migrate-keyring.html)像这样（在一行中输入命令）：

```
mysql_migrate_keyring
  --component-dir=dir_name
  --source-keyring=name
  --destination-keyring=name
  [other options]
```

有关密钥迁移的信息以及描述如何使用它们执行它们的说明[**mysql\_迁移\_钥匙圈**](mysql-migrate-keyring.html)和其他方法，请参阅[第 6.4.4.13 节，“在密钥环密钥库之间迁移密钥”](keyring-key-migration.html).

[**mysql\_迁移\_钥匙圈**](mysql-migrate-keyring.html)支持以下选项，可以在命令行中指定，也可以在`[mysql_migrate_keyring]`一组选项文件。有关 MySQL 程序使用的选项文件的信息，请参阅[第 4.2.2.2 节，“使用选项文件”](option-files.html).

[](<>)

**表 4.21 mysql\_迁移\_密钥环选项**

| 选项名称 | 描述 | 介绍 |
| ---- | --- | --- |
| [--组件目录](mysql-migrate-keyring.html#option_mysql_migrate_keyring_component-dir) | 密钥环组件目录 |  |
| [--defaults-额外文件](mysql-migrate-keyring.html#option_mysql_migrate_keyring_defaults-extra-file) | 除了通常的选项文件外，还读取命名的选项文件 |  |
| [--默认文件](mysql-migrate-keyring.html#option_mysql_migrate_keyring_defaults-file) | 只读命名选项文件 |  |
| [--defaults-组后缀](mysql-migrate-keyring.html#option_mysql_migrate_keyring_defaults-group-suffix) | 选项组后缀值 |  |
| [--目的地-钥匙圈](mysql-migrate-keyring.html#option_mysql_migrate_keyring_destination-keyring) | 目标密钥环组件名称 |  |
| [--destination-keyring-configuration-dir](mysql-migrate-keyring.html#option_mysql_migrate_keyring_destination-keyring-configuration-dir) | 目标密钥环组件配置目录 |  |
| [--get-server-public-key](mysql-migrate-keyring.html#option_mysql_migrate_keyring_get-server-public-key) | 从服务器请求 RSA 公钥 |  |
| [--帮助](mysql-migrate-keyring.html#option_mysql_migrate_keyring_help) | 显示帮助信息并退出 |  |
| [--主持人](mysql-migrate-keyring.html#option_mysql_migrate_keyring_host) | MySQL服务器所在的主机 |  |
| [--登录路径](mysql-migrate-keyring.html#option_mysql_migrate_keyring_login-path) | 从 .mylogin.cnf 读取登录路径选项 |  |
| [--无默认值](mysql-migrate-keyring.html#option_mysql_migrate_keyring_no-defaults) | 不读取选项文件 |  |
| [--在线迁移](mysql-migrate-keyring.html#option_mysql_migrate_keyring_online-migration) | 迁移源是活动服务器 |  |
| [--密码](mysql-migrate-keyring.html#option_mysql_migrate_keyring_password) | 连接服务器时使用的密码 |  |
| [--港口](mysql-migrate-keyring.html#option_mysql_migrate_keyring_port) | 用于连接的 TCP/IP 端口号 |  |
| [--打印默认值](mysql-migrate-keyring.html#option_mysql_migrate_keyring_print-defaults) | 打印默认选项 |  |
| [--服务器公钥路径](mysql-migrate-keyring.html#option_mysql_migrate_keyring_server-public-key-path) | 包含 RSA 公钥的文件的路径名 |  |
| [--插座](mysql-migrate-keyring.html#option_mysql_migrate_keyring_socket) | 要使用的 Unix 套接字文件或 Windows 命名管道 |  |
| [--源密钥环](mysql-migrate-keyring.html#option_mysql_migrate_keyring_source-keyring) | 源密钥环组件名称 |  |
| [--source-keyring-configuration-dir](mysql-migrate-keyring.html#option_mysql_migrate_keyring_source-keyring-configuration-dir) | 源密钥环组件配置目录 |  |
| [--ssl-ca](mysql-migrate-keyring.html#option_mysql_migrate_keyring_ssl) | 包含受信任 SSL 证书颁发机构列表的文件 |  |
| [--ssl-capath](mysql-migrate-keyring.html#option_mysql_migrate_keyring_ssl) | 包含受信任的 SSL 证书颁发机构证书文件的目录 |  |
| [--ssl 证书](mysql-migrate-keyring.html#option_mysql_migrate_keyring_ssl) | 包含 X.509 证书的文件 |  |
| [--ssl密码](mysql-migrate-keyring.html#option_mysql_migrate_keyring_ssl) | 连接加密的允许密码 |  |
| [--ssl-crl](mysql-migrate-keyring.html#option_mysql_migrate_keyring_ssl) | 包含证书吊销列表的文件 |  |
| [--ssl-crlpath](mysql-migrate-keyring.html#option_mysql_migrate_keyring_ssl) | 包含证书吊销列表文件的目录 |  |
| [--ssl-fips 模式](mysql-migrate-keyring.html#option_mysql_migrate_keyring_ssl-fips-mode) | 客户端是否开启 FIPS 模式 |  |
| [--ssl 密钥](mysql-migrate-keyring.html#option_mysql_migrate_keyring_ssl) | 包含 X.509 密钥的文件 |  |
| [--ssl 模式](mysql-migrate-keyring.html#option_mysql_migrate_keyring_ssl) | 连接到服务器的所需安全状态 |  |
| [--ssl 会话数据](mysql-migrate-keyring.html#option_mysql_migrate_keyring_ssl) | 包含 SSL 会话数据的文件 | 8.0.29 |
| [--ssl-session-data-continue-on-failed-reuse](mysql-migrate-keyring.html#option_mysql_migrate_keyring_ssl) | 会话重用失败时是否建立连接 | 8.0.29 |
| [--tls-密码套件](mysql-migrate-keyring.html#option_mysql_migrate_keyring_tls-ciphersuites) | 用于加密连接的允许 TLSv1.3 密码套件 |  |
| [--tls-版本](mysql-migrate-keyring.html#option_mysql_migrate_keyring_tls-version) | 加密连接的允许 TLS 协议 |  |
| [--用户](mysql-migrate-keyring.html#option_mysql_migrate_keyring_user) | 连接到服务器时使用的 MySQL 用户名 |  |
| [--详细](mysql-migrate-keyring.html#option_mysql_migrate_keyring_verbose) | 详细模式 |  |
| [--版本](mysql-migrate-keyring.html#option_mysql_migrate_keyring_version) | 显示版本信息并退出 |  |

-   [](<>) [`- 帮助`](mysql-migrate-keyring.html#option_mysql_migrate_keyring_help),`-h`

    [](<>)[](<>)

    显示帮助信息并退出。

-   [](<>) [`--组件目录=*`目录名`*`](mysql-migrate-keyring.html#option_mysql_migrate_keyring_component-dir)

    [](<>)[](<>)

    密钥环组件所在的目录。这通常是[`插件目录`](server-system-variables.html#sysvar_plugin_dir)本地 MySQL 服务器的系统变量。

    笔记

    [`--组件目录`](mysql-migrate-keyring.html#option_mysql_migrate_keyring_component-dir),[`--source-keyring`](mysql-migrate-keyring.html#option_mysql_migrate_keyring_source-keyring)， 和[`--destination-keyring`](mysql-migrate-keyring.html#option_mysql_migrate_keyring_destination-keyring)对于由以下人员执行的所有密钥环迁移操作是强制性的[**mysql\_迁移\_钥匙圈**](mysql-migrate-keyring.html).此外，源组件和目标组件必须不同，并且必须正确配置两个组件，以便[**mysql\_迁移\_钥匙圈**](mysql-migrate-keyring.html)可以加载和使用它们。

-   [](<>) [`--defaults-extra-file=*`文件名`*`](mysql-migrate-keyring.html#option_mysql_migrate_keyring_defaults-extra-file)

    [](<>)[](<>)

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

    有关此选项和其他选项文件选项的更多信息，请参阅[第 4.2.2.3 节，“影响选项文件处理的命令行选项”](option-file-options.html).

-   [](<>) [`--默认文件=*`文件名`*`](mysql-migrate-keyring.html#option_mysql_migrate_keyring_defaults-file)

    [](<>)[](<>)

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

    例外：即使有[`--defaults 文件`](option-file-options.html#option_general_defaults-file), 客户端程序读取`.mylogin.cnf`.

    有关此选项和其他选项文件选项的更多信息，请参阅[第 4.2.2.3 节，“影响选项文件处理的命令行选项”](option-file-options.html).

-   [](<>) [`--defaults-group-suffix=*`字符串`*`](mysql-migrate-keyring.html#option_mysql_migrate_keyring_defaults-group-suffix)

    [](<>)[](<>)

    不仅可以读取通常的选项组，还可以读取具有通常名称和后缀的组*`字符串`*.例如，[**mysql\_迁移\_钥匙圈**](mysql-migrate-keyring.html)通常读取`[mysql_migrate_keyring]`团体。如果这个选项被给出为[`--defaults-group-suffix=_other`](mysql-migrate-keyring.html#option_mysql_migrate_keyring_defaults-group-suffix),[**mysql\_迁移\_钥匙圈**](mysql-migrate-keyring.html)还读取`[mysql_migrate_keyring_other]`团体。

    有关此选项和其他选项文件选项的更多信息，请参阅[第 4.2.2.3 节，“影响选项文件处理的命令行选项”](option-file-options.html).

-   [](<>) [`--destination-keyring=*`姓名`*`](mysql-migrate-keyring.html#option_mysql_migrate_keyring_destination-keyring)

    [](<>)[](<>)

    密钥迁移的目标密钥环组件。期权价值的格式和解释与描述的相同[`--source-keyring`](mysql-migrate-keyring.html#option_mysql_migrate_keyring_source-keyring)选项。

    笔记

    [`--组件目录`](mysql-migrate-keyring.html#option_mysql_migrate_keyring_component-dir),[`--source-keyring`](mysql-migrate-keyring.html#option_mysql_migrate_keyring_source-keyring)， 和[`--destination-keyring`](mysql-migrate-keyring.html#option_mysql_migrate_keyring_destination-keyring)对于由以下人员执行的所有密钥环迁移操作是强制性的[**mysql\_迁移\_钥匙圈**](mysql-migrate-keyring.html).此外，源组件和目标组件必须不同，并且必须正确配置两个组件，以便[**mysql\_迁移\_钥匙圈**](mysql-migrate-keyring.html)可以加载和使用它们。

-   [](<>) [`--destination-keyring-configuration-dir=*`目录名`*`](mysql-migrate-keyring.html#option_mysql_migrate_keyring_destination-keyring-configuration-dir)

    [](<>)[](<>)

    此选项仅适用于目标密钥环组件全局配置文件包含`“read_local_config”：真`，表示组件配置包含在本地配置文件中。选项值指定包含该本地文件的目录。

-   [](<>) [`--get-server-public-key`](mysql-migrate-keyring.html#option_mysql_migrate_keyring_get-server-public-key)

    [](<>)[](<>)

    从服务器请求基于 RSA 密钥对的密码交换所需的公钥。此选项适用于通过`cache_sha2_password`身份验证插件。对于该插件，除非请求，否则服务器不会发送公钥。对于未使用该插件进行身份验证的帐户，此选项将被忽略。如果不使用基于 RSA 的密码交换，它也会被忽略，例如客户端使用安全连接连接到服务器的情况。

    如果[`--server-public-key-path=*`文件名`*`](mysql-migrate-keyring.html#option_mysql_migrate_keyring_server-public-key-path)给出并指定一个有效的公钥文件，它优先于[`--get-server-public-key`](mysql-migrate-keyring.html#option_mysql_migrate_keyring_get-server-public-key).

    有关信息`cache_sha2_password`插件，见[第 6.4.1.2 节，“缓存 SHA-2 可插入身份验证”](caching-sha2-pluggable-authentication.html).

-   [](<>) [`--主机=*`主机名`*`](mysql-migrate-keyring.html#option_mysql_migrate_keyring_host),`-h *`主机名`*`

    [](<>)[](<>)

    当前正在使用密钥迁移密钥库之一的运行服务器的主机位置。迁移始终发生在本地主机上，因此该选项始终指定连接本地服务器的值，例如`本地主机`,`127.0.0.1`,`::1`, 或本地主机 IP 地址或主机名。

-   [](<>) [`--登录路径=*`姓名`*`](mysql-migrate-keyring.html#option_mysql_migrate_keyring_login-path)

    [](<>)[](<>)

    从命名登录路径中读取选项`.mylogin.cnf`登录路径文件。“登录路径”是一个选项组，其中包含指定要连接到哪个 MySQL 服务器以及要作为哪个帐户进行身份验证的选项。要创建或修改登录路径文件，请使用[**mysql\_配置\_编辑**](mysql-config-editor.html)效用。看[第 4.6.7 节，“mysql\_配置\_编辑器 — MySQL 配置实用程序”](mysql-config-editor.html).

    有关此选项和其他选项文件选项的更多信息，请参阅[第 4.2.2.3 节，“影响选项文件处理的命令行选项”](option-file-options.html).

-   [](<>) [`--no-defaults`](mysql-migrate-keyring.html#option_mysql_migrate_keyring_no-defaults)

    [](<>)[](<>)

    不要读取任何选项文件。如果由于从选项文件中读取未知选项而导致程序启动失败，[`--no-defaults`](mysql-migrate-keyring.html#option_mysql_migrate_keyring_no-defaults)可以用来防止它们被读取。

    唯一的例外是`.mylogin.cnf`如果文件存在，则在所有情况下都会读取文件。这允许以比在命令行上更安全的方式指定密码，即使在[`--no-defaults`](mysql-migrate-keyring.html#option_mysql_migrate_keyring_no-defaults)用来。创造`.mylogin.cnf`， 使用[**mysql\_配置\_编辑**](mysql-config-editor.html)效用。看[第 4.6.7 节，“mysql\_配置\_编辑器 — MySQL 配置实用程序”](mysql-config-editor.html).

    有关此选项和其他选项文件选项的更多信息，请参阅[第 4.2.2.3 节，“影响选项文件处理的命令行选项”](option-file-options.html).

-   [](<>) [`--在线迁移`](mysql-migrate-keyring.html#option_mysql_migrate_keyring_online-migration)

    [](<>)[](<>)

    当正在运行的服务器使用密钥环时，此选项是必需的。它说[**mysql\_迁移\_钥匙圈**](mysql-migrate-keyring.html)执行在线密钥迁移。该选项具有以下效果：

    -   [**mysql\_迁移\_钥匙圈**](mysql-migrate-keyring.html)使用指定的任何连接选项连接到服务器；否则这些选项将被忽略。

    -   后[**mysql\_迁移\_钥匙圈**](mysql-migrate-keyring.html)连接到服务器，它告诉服务器暂停密钥环操作。密钥复制完成后，[**mysql\_迁移\_钥匙圈**](mysql-migrate-keyring.html)告诉服务器它可以在断开连接之前恢复密钥环操作。

-   [](<>) [`--密码[=*`密码`*]`](mysql-migrate-keyring.html#option_mysql_migrate_keyring_password),`-p[*`密码`*]`

    [](<>)[](<>)

    用于连接到当前正在使用密钥迁移密钥库之一的正在运行的服务器的 MySQL 帐户的密码。密码值是可选的。如果不给，[**mysql\_迁移\_钥匙圈**](mysql-migrate-keyring.html)提示一个。如果给出，必须有*没有空间*之间[`--密码=`](mysql-migrate-keyring.html#option_mysql_migrate_keyring_password)要么`-p`和它后面的密码。如果未指定密码选项，则默认为不发送密码。

    在命令行上指定密码应该被认为是不安全的。为避免在命令行上提供密码，请使用选项文件。看[第 6.1.2.1 节，“最终用户密码安全指南”](password-security-user.html).

    明确指定没有密码并且[**mysql\_迁移\_钥匙圈**](mysql-migrate-keyring.html)不应该提示输入一个，使用[`--跳过密码`](mysql-migrate-keyring.html#option_mysql_migrate_keyring_password)选项。

-   [](<>) [`--端口=*`端口号`*`](mysql-migrate-keyring.html#option_mysql_migrate_keyring_port),`-P *`端口号`*`

    [](<>)[](<>)[](<>)

    对于 TCP/IP 连接，用于连接到当前正在使用密钥迁移密钥库之一的正在运行的服务器的端口号。

-   [](<>) [`--打印默认值`](mysql-migrate-keyring.html#option_mysql_migrate_keyring_print-defaults)

    [](<>)[](<>)

    打印程序名称和它从选项文件中获得的所有选项。

    有关此选项和其他选项文件选项的更多信息，请参阅[第 4.2.2.3 节，“影响选项文件处理的命令行选项”](option-file-options.html).

-   [](<>) [`--server-public-key-path=*`文件名`*`](mysql-migrate-keyring.html#option_mysql_migrate_keyring_server-public-key-path)

    [](<>)[](<>)

    PEM 格式的文件的路径名，其中包含服务器基于 RSA 密钥对的密码交换所需的公钥的客户端副本。此选项适用于通过`sha256_password`要么`cache_sha2_password`身份验证插件。对于未使用这些插件之一进行身份验证的帐户，此选项将被忽略。如果不使用基于 RSA 的密码交换，它也会被忽略，例如客户端使用安全连接连接到服务器的情况。

    如果[`--server-public-key-path=*`文件名`*`](mysql-migrate-keyring.html#option_mysql_migrate_keyring_server-public-key-path)给出并指定一个有效的公钥文件，它优先于[`--get-server-public-key`](mysql-migrate-keyring.html#option_mysql_migrate_keyring_get-server-public-key).

    为了`sha256_password`, 此选项仅适用于使用 OpenSSL 构建 MySQL 的情况。

    有关信息`sha256_password`和`cache_sha2_password`插件，见[第 6.4.1.3 节，“SHA-256 可插入身份验证”](sha256-pluggable-authentication.html)， 和[第 6.4.1.2 节，“缓存 SHA-2 可插入身份验证”](caching-sha2-pluggable-authentication.html).

-   [](<>) [`--socket=*`小路`*`](mysql-migrate-keyring.html#option_mysql_migrate_keyring_socket),`-S *`小路`*`

    [](<>)[](<>)

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

    在 Windows 上，此选项仅在服务器以[`命名管道`](server-system-variables.html#sysvar_named_pipe)启用系统变量以支持命名管道连接。此外，建立连接的用户必须是由指定的 Windows 组的成员[`named_pipe_full_access_group`](server-system-variables.html#sysvar_named_pipe_full_access_group)系统变量。

-   [](<>) [`--source-keyring=*`姓名`*`](mysql-migrate-keyring.html#option_mysql_migrate_keyring_source-keyring)

    [](<>)[](<>)

    用于密钥迁移的源密钥环组件。这是指定的组件库文件名，没有任何特定于平台的扩展名，例如`。所以`要么`.dll`.例如，要使用库文件所在的组件`component_keyring_file.so`, 指定选项为[`--source-keyring=component_keyring_file`](mysql-migrate-keyring.html#option_mysql_migrate_keyring_source-keyring).

    笔记

    [`--组件目录`](mysql-migrate-keyring.html#option_mysql_migrate_keyring_component-dir),[`--source-keyring`](mysql-migrate-keyring.html#option_mysql_migrate_keyring_source-keyring)， 和[`--destination-keyring`](mysql-migrate-keyring.html#option_mysql_migrate_keyring_destination-keyring)对于由以下人员执行的所有密钥环迁移操作是强制性的[**mysql\_迁移\_钥匙圈**](mysql-migrate-keyring.html).此外，源组件和目标组件必须不同，并且必须正确配置两个组件，以便[**mysql\_迁移\_钥匙圈**](mysql-migrate-keyring.html)可以加载和使用它们。

-   [](<>) [`--source-keyring-configuration-dir=*`目录名`*`](mysql-migrate-keyring.html#option_mysql_migrate_keyring_source-keyring-configuration-dir)

    [](<>)[](<>)

    此选项仅适用于源密钥环组件全局配置文件包含`“read_local_config”：真`，表示组件配置包含在本地配置文件中。选项值指定包含该本地文件的目录。

-   [](<>) `--ssl*`

    [](<>)[](<>)

    开头的选项`--ssl`指定是否使用加密连接到服务器并指示在哪里可以找到 SSL 密钥和证书。看[加密连接的命令选项](connection-options.html#encrypted-connection-options).

-   [](<>) [`--ssl-fips-mode={OFF|ON|STRICT}`](mysql-migrate-keyring.html#option_mysql_migrate_keyring_ssl-fips-mode)

    [](<>)[](<>)

    控制是否在客户端启用 FIPS 模式。这[`--ssl-fips-模式`](mysql-migrate-keyring.html#option_mysql_migrate_keyring_ssl-fips-mode)选项不同于其他`--ssl-*`xxx`*`选项，因为它不用于建立加密连接，而是影响允许哪些加密操作。看[第 6.8 节，“FIPS 支持”](fips-mode.html).

    这些[`--ssl-fips-模式`](mysql-migrate-keyring.html#option_mysql_migrate_keyring_ssl-fips-mode)允许的值：

    -   `离开`：禁用 FIPS 模式。

    -   `在`：启用 FIPS 模式。

    -   `严格的`：启用“严格”FIPS 模式。

    笔记

    如果 OpenSSL FIPS 对象模块不可用，则唯一允许的值为[`--ssl-fips-模式`](mysql-migrate-keyring.html#option_mysql_migrate_keyring_ssl-fips-mode)是`离开`.在这种情况下，设置[`--ssl-fips-模式`](mysql-migrate-keyring.html#option_mysql_migrate_keyring_ssl-fips-mode)到`在`要么`严格的`导致客户端在启动时产生警告并在非 FIPS 模式下运行。

-   [](<>) [`--tls-ciphersuites=*`密码套件列表`*`](mysql-migrate-keyring.html#option_mysql_migrate_keyring_tls-ciphersuites)

    [](<>)[](<>)

    允许使用 TLSv1.3 的加密连接的密码套件。该值是一个或多个以冒号分隔的密码套件名称的列表。可以为此选项命名的密码套件取决于用于编译 MySQL 的 SSL 库。有关详细信息，请参阅[第 6.3.2 节，“加密连接 TLS 协议和密码”](encrypted-connection-protocols-ciphers.html).

-   [](<>) [`--tls-版本=*`协议列表`*`](mysql-migrate-keyring.html#option_mysql_migrate_keyring_tls-version)

    [](<>)[](<>)

    加密连接的允许 TLS 协议。该值是一个或多个逗号分隔的协议名称的列表。可以为此选项命名的协议取决于用于编译 MySQL 的 SSL 库。有关详细信息，请参阅[第 6.3.2 节，“加密连接 TLS 协议和密码”](encrypted-connection-protocols-ciphers.html).

-   [](<>) [`--用户=*`用户名`*`](mysql-migrate-keyring.html#option_mysql_migrate_keyring_user),`-u *`用户名`*`

    [](<>)[](<>)

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

-   [](<>) [`--详细`](mysql-migrate-keyring.html#option_mysql_migrate_keyring_verbose),`-v`

    [](<>)[](<>)

    详细模式。产生更多关于程序做什么的输出。

-   [](<>) [`- 版本`](mysql-migrate-keyring.html#option_mysql_migrate_keyring_version),`-V`

    [](<>)[](<>)

    显示版本信息并退出。
