Documentation Home
MySQL 8.4 Reference Manual
Related Documentation Download this Manual
PDF (US Ltr) - 39.8Mb
PDF (A4) - 39.9Mb
Man Pages (TGZ) - 257.9Kb
Man Pages (Zip) - 364.9Kb
Info (Gzip) - 4.0Mb
Info (Zip) - 4.0Mb


MySQL 8.4 Reference Manual  /  ...  /  Installing the Clone Plugin

7.6.7.1 安装克隆插件

本节描述了如何安装和配置克隆插件。对于远程克隆操作,克隆插件必须在捐赠服务器实例和接收服务器实例上安装。

关于安装或卸载插件的总体信息,请参见第7.6.1节,“安装和卸载插件”

要使插件可供服务器使用,插件库文件必须位于 MySQL 插件目录(由plugin_dir系统变量指定的目录)。如果必要,请在服务器启动时设置plugin_dir的值,以告知服务器插件目录位置。

插件库文件的基本名称是mysql_clone.so。文件名后缀因平台而异(例如,Unix 和 Unix 类似系统为.so,Windows 为.dll)。

要在服务器启动时加载插件,请使用--plugin-load-add选项指定包含该插件的库文件。使用这个插件加载方法,必须每次服务器启动时给出该选项。例如,在您的my.cnf文件中添加这些行,根据平台调整插件库文件名后缀(插件库文件名后缀取决于平台,常见的后缀为 Unix 和 Unix 类似系统的.so,Windows 的.dll)。

[mysqld]
plugin-load-add=mysql_clone.so

修改my.cnf后,重启服务器以使新设置生效。

Note

在从前版本MySQL升级到当前版本时,不能使用--plugin-load-add选项来加载克隆插件。在这种情况下,尝试重启服务器时,会出现错误[ERROR] [MY-013238] [Server] Error installing plugin 'clone': Cannot install during upgrade。为了避免这个问题,在升级服务器前先启动服务器。

或者,可以在运行时使用以下语句,根据平台调整.so后缀:

INSTALL PLUGIN clone SONAME 'mysql_clone.so';

INSTALL PLUGIN加载插件,并将其注册到mysql.plugins系统表中,以便在后续正常服务器启动时不需要--plugin-load-add

验证插件安装,查看信息架构PLUGINS表或使用SHOW PLUGINS语句(见第7.6.2节,“获取服务器插件信息”)。例如:

mysql> SELECT PLUGIN_NAME, PLUGIN_STATUS
       FROM INFORMATION_SCHEMA.PLUGINS
       WHERE PLUGIN_NAME = 'clone';
+------------------------+---------------+
| PLUGIN_NAME            | PLUGIN_STATUS |
+------------------------+---------------+
| clone                  | ACTIVE        |
+------------------------+---------------+

如果插件初始化失败,检查服务器错误日志中的克隆或插件相关诊断消息。

如果插件已经使用INSTALL PLUGIN注册过,或者使用--plugin-load-add加载过,您可以在服务器启动时使用--clone选项控制插件激活状态。例如,为了在启动时加载插件并防止在运行时删除,使用这些选项:

[mysqld]
plugin-load-add=mysql_clone.so
clone=FORCE_PLUS_PERMANENT

如果您想防止服务器在没有克隆插件的情况下运行,使用--clone选项的值为FORCEFORCE_PLUS_PERMANENT强制服务器启动失败,如果插件初始化不成功。

关于插件激活状态的更多信息,请见控制插件激活状态