4.4.3 mysql_plugin-配置 MySQL 服务器插件

Note

从 MySQL 5.7.11 开始不推荐使用mysql_plugin，并在 MySQL 8.0 中将其删除。替代方法包括在服务器启动时使用--plugin-load或--plugin-load-add选项或在运行时使用INSTALL PLUGIN语句加载插件。

mysql_pluginUtil 使 MySQLManagement 员可以 ManagementMySQL 服务器加载哪些插件。它提供了一种替代方法，可以在服务器启动时手动指定--plugin-load选项，或者在运行时使用INSTALL PLUGIN和UNINSTALL PLUGIN语句。

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

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

mysql_plugin [options] plugin {ENABLE|DISABLE}

例如，要在 Linux 上配置名为myplugins.so或在 Windows 上名为myplugins.dll的插件库文件的组件，请将* plugin *值指定为myplugins。假设此插件库包含三个插件plugin1，plugin2和plugin3，所有这些插件都应在mysql_plugin的控制下进行配置。按照约定，配置文件的后缀为.ini，并且基本名称与插件库相同，因此此插件库的默认配置文件名称为myplugins.ini。配置文件的内容如下所示：

myplugins
plugin1
plugin2
plugin3

myplugins.ini文件中的第一行是库文件的名称，没有任何 extensions，例如.so或.dll。其余各行是要启用或禁用的组件的名称。文件中的每个值都应放在单独的行上。第一个字符为'#'的行被视为 Comments 并被忽略。

要启用配置文件中列出的插件，请通过以下方式调用mysql_plugin：

shell> 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 节“使用选项文件”。

table4.8 mysql_plugin 选项

Option Name Description
--basedir 服务器基础目录
--datadir 服务器数据目录
--help 显示帮助信息并退出
--my-print-defaults my_print_defaults 的路径
--mysqld 服务器路径
--no-defaults 不读取配置文件
--plugin-dir 安装插件的目录
--plugin-ini 插件配置文件
--print-defaults 显示配置文件默认值
--verbose Verbose mode
--version 显示版本信息并退出

显示帮助消息并退出。

服务器基本目录。

服务器数据目录。

my_print_defaults程序的路径。

mysqld服务器的路径。

不要从配置文件中读取值。此选项使 Management 员可以跳过从配置文件中读取默认值的操作。

使用mysql_plugin时，与大多数其他支持--no-defaults的 MySQL 程序不同，不需要在命令行上首先给出此选项。

服务器插件目录。

mysql_plugin配置文件。相对路径名是相对于当前目录解释的。如果未提供此选项，则默认为插件目录中的plugin.ini，其中* plugin *是命令行中的_plugin *参数。

显示配置文件中的默认值。如果在配置文件中找到--basedir，--datadir和--plugin-dir的默认值，则此选项将使mysql_plugin打印默认值。如果找不到变量的值，则不会显示任何内容。

使用mysql_plugin时，与大多数其他支持--print-defaults的 MySQL 程序不同，不需要在命令行上首先给出此选项。

详细模式。打印有关程序功能的更多信息。可以多次使用此选项以增加信息量。

显示版本信息并退出。

首页