本节介绍如何安装和配置 clone 插件。对于远程克隆操作,clone 插件必须安装在捐赠者和接收者 MySQL 服务器实例上。
有关安装或卸载插件的一般信息,请参见 第 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
后,重新启动服务器以使新设置生效。
在从以前的 MySQL 版本升级期间重新启动服务器时,不能使用 --plugin-load-add
选项加载 clone 插件。在这种情况下,尝试使用 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
后缀。
INSTALL PLUGIN clone SONAME 'mysql_clone.so';
INSTALL PLUGIN
加载插件,并在 mysql.plugins
系统表中注册它,以使插件在每次后续正常服务器启动时加载,而无需使用 --plugin-load-add
。
要验证插件安装,请检查 Information Schema 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 |
+------------------------+---------------+
如果插件无法初始化,请检查服务器错误日志以查找与 clone 或插件相关的诊断消息。
如果插件已使用 INSTALL PLUGIN
注册,或使用 --plugin-load-add
加载,则可以在服务器启动时使用 --clone
选项来控制插件激活状态。例如,要加载启动时的插件并防止它在运行时被删除,请使用以下选项
[mysqld]
plugin-load-add=mysql_clone.so
clone=FORCE_PLUS_PERMANENT
如果您希望服务器在没有 clone 插件的情况下无法运行,请将 --clone
与 FORCE
或 FORCE_PLUS_PERMANENT
的值一起使用,以强制服务器启动在插件未成功初始化的情况下失败。
有关插件激活状态的更多信息,请参见 控制插件激活状态。