Documentation Home
MySQL 8.0 参考手册  / 第 4 章 MySQL 程序  / 4.4 安装相关程序  /  4.4.3 mysql_plugin — 配置 MySQL 服务器插件

4.4.3 mysql_plugin — 配置 MySQL 服务器插件

笔记

mysql_plugin从 MySQL 5.7.11 开始弃用,并在 MySQL 8.0 中删除。备选方案包括在服务器启动时使用 --plugin-loador --plugin-load-add选项加载插件,或在运行时使用INSTALL PLUGIN语句加载插件。

mysql_plugin实用程序使 MySQL 管理员能够管理 MySQL 服务器加载哪些插件。--plugin-load它提供了在服务器启动时手动指定 选项或在运行时使用INSTALL PLUGINandUNINSTALL PLUGIN语句的替代方法。

根据是否调用mysql_pluginmysql.plugin来启用或禁用插件,它会在用作插件注册表的表中插入或删除行 。(要执行此操作, mysql_plugin在引导程序模式下调用 MySQL 服务器。这意味着服务器必须尚未运行。)对于正常的服务器启动,服务器会mysql.plugin 自动加载并启用列出的插件。要对插件激活进行额外控制,请使用 为特定插件命名的选项,如 第 5.5.1 节“安装和卸载插件”中所述。 --plugin_name

每次调用mysql_plugin 都会读取一个配置文件,以确定如何配置单个插件库文件中包含的插件。要调用 mysql_plugin,请使用以下语法:

mysql_plugin [options] plugin {ENABLE|DISABLE}

plugin是要配置的插件的名称。ENABLEDISABLE(不区分大小写)指定是否启用或禁用配置文件中命名的插件库的组件。pluginand ENABLE or参数的顺序 DISABLE无关紧要。

例如,要配置myplugins.so在 Linux 或 myplugins.dllWindows 上命名的插件库文件的组件,请指定 pluginmyplugins. 假设这个插件库包含三个插件 、plugin1plugin2plugin3它们都应该配置在 mysql_plugin控制下。按照惯例,配置文件的后缀为 ,.ini 并且与插件库的基本名称相同,因此该插件库的默认配置文件名为 myplugins.ini. 配置文件内容如下所示:

myplugins
plugin1
plugin2
plugin3

文件中的第一行myplugins.ini是库文件的名称,没有任何扩展名,例如 .so.dll. 其余行是要启用或禁用的组件的名称。文件中的每个值都应位于单独的行中。第一个字符所在'#'的行被视为注释并被忽略。

要启用配置文件中列出的插件,请以这种方式调用 mysql_plugin

mysql_plugin myplugins ENABLE

要禁用插件,请使用DISABLE而不是ENABLE.

如果mysql_plugin找不到配置文件或插件库文件,或者 mysql_plugin无法启动MySQL服务器,就会出错。

mysql_plugin支持以下选项,可以在命令行中指定,也可以在 [mysqld]任意选项文件组中指定。对于[mysqld]组中指定的选项, mysql_plugin识别 --basedir--datadir--plugin-dir选项并忽略其他选项。有关 MySQL 程序使用的选项文件的信息,请参阅第 4.2.2.2 节,“使用选项文件”

表 4.8 mysql_plugin 选项

选项名称 描述
--basedir 服务器基目录
--数据目录 服务器数据目录
- 帮助 显示帮助信息并退出
--my-print-defaults my_print_defaults 的路径
--mysqld 服务器路径
--no-defaults 不读取配置文件
--插件目录 安装插件的目录
--plugin-ini 插件配置文件
--print-defaults 显示配置文件默认值
--冗长 详细模式
- 版本 显示版本信息并退出