脱机迁移:当您确定本地主机上没有运行的服务器正在使用源或目标密钥存储库时使用。在这种情况下，迁移操作可以将密钥从源密钥存储库复制到目标，而不需要运行中的服务器在操作期间修改密钥存储库内容。

在线迁移:当本地主机上运行的服务器正在使用源密钥存储库时使用。在这种情况下，必须注意防止该服务器在迁移期间更新密钥存储库。这涉及到连接到正在运行的服务器，并指示它暂停密匙环操作，以便可以安全地将密钥从源密钥存储库复制到目标。密钥复制完成后，允许运行的服务器恢复密匙环操作。

不要执行涉及正在运行的服务器使用的密钥存储库的脱机迁移。

在在线迁移期间暂停密匙环操作是通过连接到正在运行的服务器并设置其全局来完成的keyring_operations系统变量为从在复制密钥之前在复制密钥后。这有几个含义:

在线密钥迁移可暂停单个运行服务器上的密匙环操作。若要执行迁移，如果多个正在运行的服务器正在使用涉及的密钥存储库，请使用中描述的过程涉及多台运行服务器的关键迁移．

从一个keyring插件迁移到另一个。

从密匙环插件迁移到密匙环组件。该功能在MySQL 8.0.24中可用。旧的服务器只支持从一个密匙环插件迁移到另一个，在这种情况下，这些指示中涉及密匙环组件的部分不适用。

要指定源密匙环插件和目标密匙环插件或组件，请指定以下选项:

的——keyring-migration-source而且——keyring-migration-destination选项指示服务器应该以键迁移模式运行。对于关键的迁移操作，这两个选项都是必需的。每个插件或组件都使用其库文件的名称指定，包括任何特定于平台的扩展，例如所以或. dll．源和目标必须不同，迁移服务器必须同时支持它们。

对于脱机迁移，不需要其他关键迁移选项。

对于在线迁移，一些正在运行的服务器当前正在使用源或目标密钥存储库。要调用迁移服务器，请指定指示如何连接到运行中的服务器的其他关键迁移选项。这是必需的，以便迁移服务器可以连接到正在运行的服务器，并告诉它在迁移操作期间暂停使用密匙环。

使用下列选项之一表示在线迁移:

可能需要其他服务器选项，例如两个keyring插件的配置参数。例如，如果keyring_file是源还是目的，必须设置keyring_file_data如果密匙环数据文件位置不是默认位置，则为系统变量。可能还需要其他非密匙环选项。指定这些选项的一种方法是使用——defaults-file为包含所需选项的选项文件命名。

迁移服务器希望路径名选项值为完整路径。相对路径名可能无法按预期进行解析。

以键迁移方式调用服务器的用户不能是根操作系统用户，除非——用户选项使用非指定根以该用户身份运行服务器的用户名。

在密钥迁移模式下运行的服务器用户必须具有读写任何本地keyring文件的权限，例如基于文件的插件的数据文件。

如果从不同于通常用于运行MySQL的系统帐户调用迁移服务器，则可能会创建在正常操作期间服务器无法访问的密匙环目录或文件。假设mysqld通常以mysql操作系统用户，但是在登录时调用迁移服务器伊莎贝尔．由迁移服务器创建的任何新目录或文件都属于伊莎贝尔．时，后续启动失败mysql操作系统用户试图访问所属的文件系统对象伊莎贝尔．

要避免此问题，请以根操作系统用户和提供——用户=user_name选项,user_name通常用于运行MySQL的系统帐号。或者，在迁移之后，检查与密匙环相关的文件系统对象，并在必要时更改它们的所有权和权限乔恩，修改文件权限，或类似的命令，以便运行的服务器可以访问对象。

如果正在运行的服务器在迁移之前使用源密钥存储库，并且应该在迁移之后继续使用它，那么在迁移之后不需要重新启动它。

如果正在运行的服务器在迁移之前使用目标密钥存储库，并且应该在迁移之后继续使用它，那么应该在迁移之后重新启动它，以将所有迁移到目标密钥存储库中的密钥加载到目标密钥存储库中。

如果正在运行的服务器在迁移之前使用源密钥存储库，但在迁移之后应该使用目标密钥存储库，则必须重新配置它以使用目标密钥存储库并重新启动。在这种情况下，请注意，尽管正在运行的服务器在迁移过程中暂停了对源密钥存储库的修改，但在迁移和后续重新启动之间的间隔期间，它不会暂停。应该注意，服务器在此期间不会修改源密钥存储库，因为任何此类更改都不会反映在目标密钥存储库中。

要指定源和目标密匙环组件及其位置，请指定以下选项:

所有三个选项都是强制性的。每个密匙环组件名称都是一个组件库文件名，没有指定任何特定于平台的扩展名，例如所以或. dll．例如，使用库文件所在的组件component_keyring_file.so，指定该选项为——source-keyring = component_keyring_file．源和目的必须不同，并且mysql_migrate_keyring必须同时支持他们。

对于脱机迁移，不需要其他选项。

对于在线迁移，一些正在运行的服务器当前正在使用源或目标密钥存储库。在本例中，指定——在线迁移选项，表示在线迁移。此外，指定指示如何连接到运行中的服务器的连接选项，以便mysql_migrate_keyring可以连接到它，并告诉它在迁移操作期间暂停使用密匙环。

的——在线迁移Option通常与连接选项一起使用，例如:

调用的用户mysql_migrate_keyring一定不是根操作系统用户。

调用的用户mysql_migrate_keyring必须具有读写任何本地keyring文件的权限，例如基于文件的插件的数据文件。

如果你调用mysql_migrate_keyring从一个不同于通常用于运行MySQL的系统帐户，它可能会创建密钥环目录或文件，在正常操作期间服务器无法访问。假设mysqld通常以mysql操作系统用户，但您调用mysql_migrate_keyring当以伊莎贝尔．创建的任何新目录或文件mysql_migrate_keyring属于伊莎贝尔．时，后续启动失败mysql操作系统用户试图访问所属的文件系统对象伊莎贝尔．

要避免此问题，请调用mysql_migrate_keyring随着mysql操作系统用户。或者，在迁移之后，检查与密匙环相关的文件系统对象，并在必要时更改它们的所有权和权限乔恩，修改文件权限，或类似的命令，以便运行的服务器可以访问对象。

如果正在运行的服务器在迁移之前使用源密钥存储库，并且应该在迁移之后继续使用它，那么在迁移之后不需要重新启动它。

如果正在运行的服务器在迁移之前使用目标密钥存储库，并且应该在迁移之后继续使用它，那么应该在迁移之后重新启动它，以将所有迁移到目标密钥存储库中的密钥加载到目标密钥存储库中。

如果正在运行的服务器在迁移之前使用源密钥存储库，但在迁移之后应该使用目标密钥存储库，则必须重新配置它以使用目标密钥存储库并重新启动。在这种情况下，请注意，尽管正在运行的服务器在迁移过程中暂停了对源密钥存储库的修改，但在迁移和后续重新启动之间的间隔期间，它不会暂停。应该注意，服务器在此期间不会修改源密钥存储库，因为任何此类更改都不会反映在目标密钥存储库中。