Documentation Home
MySQL 8.3 Reference Manual
Related Documentation Download this Manual
PDF (US Ltr) - 40.8Mb
PDF (A4) - 40.9Mb
Man Pages (TGZ) - 294.0Kb
Man Pages (Zip) - 409.0Kb
Info (Gzip) - 4.0Mb
Info (Zip) - 4.0Mb
Excerpts from this Manual

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

7.6.7.1 克隆插件的安装

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

有关安装或卸载插件的一般信息,请参阅 第 7.6.1 节,“安装和卸载插件”

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

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

要在服务器启动时加载插件,请使用 --plugin-load-add 选项来命名包含插件的库文件。使用这种插件加载方法,每次服务器启动时都需要提供该选项。例如,在 my.cnf 文件中添加以下行,根据平台调整插件库文件名的后缀。

Press CTRL+C to copy
[mysqld] plugin-load-add=mysql_clone.so

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

Note

在升级到之前的 MySQL 版本时,无法使用 --plugin-load-add 选项加载克隆插件。在这种情况下,尝试使用 plugin-load-add=mysql_clone.so 重启服务器时,会出现错误 [ERROR] [MY-013238] [Server] Error installing plugin 'clone': Cannot install during upgrade. 为避免这种情况,请在尝试使用 plugin-load-add=mysql_clone.so 之前升级服务器。

或者,要在运行时加载插件,请使用以下语句,根据平台调整 .so 后缀:

Press CTRL+C to copy
INSTALL PLUGIN clone SONAME 'mysql_clone.so';

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

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

Press CTRL+C to copy
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选项来控制插件激活状态。例如,要在启动时加载插件并防止它在运行时被删除,请使用以下选项:

Press CTRL+C to copy
[mysqld] plugin-load-add=mysql_clone.so clone=FORCE_PLUS_PERMANENT

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

有关插件激活状态的更多信息,请参阅控制插件激活状态