10bet网址
MySQL 8.0参考手册
相关的文档10bet官方网站 本手册下载 本手册节选

5.6.1安装和卸载插件

服务器插件必须在使用之前加载到服务器中。MySQL支持在服务器启动和运行时加载插件。也可以在启动时控制加载插件的激活状态,并在运行时卸载它们。

当一个插件被加载时,它的相关信息可以在第5.6.2节,“获取服务器插件信息”

安装插件

在使用服务器插件之前,必须使用以下方法之一安装它。的描述,plugin_name表示插件名称,如innodbcsv,或validate_password

内置插件

一个内置的插件是服务器自动知道的。默认情况下,服务器在启动时启用插件。一些内置插件允许用--plugin_name(=activation_state选择。

在mysql中注册。插件系统表

mysql.plugin系统表是插件的注册表(内置插件除外,不需要注册)。在正常启动过程中,服务器加载表中注册的插件。默认情况下,对于从mysql.plugin表中,服务器也启用了插件。可以用--plugin_name(=activation_state选择。

如果服务器以——skip-grant-tables选项中注册的插件mysql.plugin表未加载且不可用。

用命令行选项命名的插件

位于插件库文件中的插件可以在服务器启动时使用——plugin-load——plugin-load-add,或——early-plugin-load选择。通常,对于一个在启动时加载的插件,服务器也会启用该插件。可以用--plugin_name(=activation_state选择。

——plugin-load而且——plugin-load-add在服务器启动顺序中,内置插件和存储引擎初始化后,选项加载插件。的——early-plugin-load选项用于加载内置插件和存储引擎初始化之前必须可用的插件。

每个插件加载选项的值是一个以分号分隔的列表plugin_library而且的名字plugin_library值。每一个plugin_library包含插件代码的库文件的名称,和的名字要加载的插件的名称。如果一个插件库的命名没有任何前面的插件名称,服务器将加载该库中的所有插件。使用前面的插件名称,服务器只从库中加载命名的插件。的目录中查找插件库文件plugin_dir系统变量。

插件加载选项不注册任何插件mysql.plugin表格对于后续的重启,服务器将再次加载插件——plugin-load——plugin-load-add,或——early-plugin-load给出了。也就是说,该选项产生一次性的插件安装操作,该操作对于单个服务器调用持续存在。

——plugin-load——plugin-load-add,——early-plugin-load启用插件加载,即使当——skip-grant-tables是给定的(这导致服务器忽略mysql.plugin表)。——plugin-load——plugin-load-add,——early-plugin-load也允许在启动时加载运行时不能加载的插件。

——plugin-load-add选择的补充——plugin-load选择:

例如,这些选项:

——plugin-load = x plugin-load-add = y

等价于以下选项:

——plugin-load-add = x plugin-load-add = y

和也等价于这个选项:

——plugin-load = " x, y "

但这些选项:

——plugin-load-add = y plugin-load = x

等价于以下选项:

——plugin-load = x
使用INSTALL PLUGIN语句安装的插件

位于插件库文件中的插件可以在运行时使用安装插件声明。语句还将插件注册到mysql.plugin表以使服务器在后续重启时加载它。由于这个原因,安装插件要求插入特权的mysql.plugin表格

插件库文件的基本名称取决于您的平台。常见的后缀是所以对于Unix和类Unix系统,. dll对于Windows。

例子:——plugin-load-add选项在服务器启动时安装插件。安装一个名为并且来自一个名为somepluglib.so,使用这些线在一个my.cnf文件:

(mysqld) plugin-load-add =并且= somepluglib.so

在这种情况下,插件没有注册mysql.plugin.重新启动服务器,而不需要——plugin-load-add选项导致插件在启动时不加载。

或者,安装插件语句会导致服务器在运行时从库文件中加载插件代码:

安装myplugin的SONAME somepluglib.so

安装插件也会引起永久插件注册:插件列在mysql.plugin表,以确保服务器在后续重启时加载它。

许多插件可以在服务器启动或运行时加载。然而,如果一个插件被设计成必须在服务器启动时加载和初始化,那么尝试在运行时使用安装插件产生一个错误:

mysql> INSTALL PLUGIN myplugin .so错误1721 (HY000):插件myplugin被标记为不可动态安装。你必须停止服务器才能安装它。

在这种情况下,必须使用——plugin-load——plugin-load-add,或——early-plugin-load

如果一个插件的命名都使用——plugin-load——plugin-load-add,或——early-plugin-load选项和(作为较早的安装插件声明)mysql.plugin表中,服务器启动,但将这些消息写入错误日志:

(错误)函数的plugin_name'已经存在[警告]无法加载名为'的插件plugin_name' with soname 'plugin_object_file”。

控制插件激活状态

如果服务器在启动时知道一个插件(例如,因为插件的命名使用——plugin-load-add选项中注册的mysql.plugin表),服务器默认加载并启用插件。这是可能的控制激活状态为这样的插件使用--plugin_name(=activation_state启动选项,plugin_name是否要影响插件的名称,例如innodbcsv,或validate_password.与其他选项一样,在选项名称中,破折号和下划线是可以互换的。此外,激活状态值不区分大小写。例如,——my_plugin =而且——my-plugin =是等价的。

  • --plugin_name=下

    告诉服务器禁用插件。对于某些内置插件来说,这可能是不可能的,例如mysql_native_password

  • --plugin_name(=)

    告诉服务器启用插件。(指定选项为--plugin_name没有值也有相同的效果。)如果插件初始化失败,服务器将禁用插件运行。

  • --plugin_name=力

    告诉服务器启用插件,但是如果插件初始化失败,服务器不会启动。换句话说,这个选项强制服务器在启用插件的情况下运行,或者根本不运行。

  • --plugin_name= FORCE_PLUS_PERMANENT

    就像,但另外还可以防止插件在运行时被卸载。如果用户试图使用卸载插件,则错误发生。

插件的激活状态在LOAD_OPTION列的INFORMATION_SCHEMA。插件表格

假设CSV黑洞,存档是内置的可插拔存储引擎,并且您希望服务器在启动时加载它们,但需要满足以下条件:服务器允许在CSV初始化失败,必须要求黑洞初始化成功,应该禁用存档.要实现这一点,请在一个选项文件中使用以下几行:

[mysqld] csv=ON blackhole=FORCE archive=OFF

——使plugin_name选项格式是--plugin_name=对.的——禁用plugin_name而且——跳过plugin_name选项格式的同义词--plugin_name=下

如果一个插件被禁用,可以显式地使用或者是隐式的,因为它是启用的但初始化失败,服务器操作方面需要更改插件。例如,如果插件实现了存储引擎,那么存储引擎的现有表将无法访问,并且尝试为存储引擎创建新表将导致表使用默认的存储引擎,除非NO_ENGINE_SUBSTITUTION启用SQL模式会导致发生错误。

禁用一个插件可能需要调整到其他选项。例如,如果您使用——skip-innodb禁用InnoDB,其他innodb_xxx在启动时可能也需要忽略选项。此外,由于InnoDB是默认的存储引擎,它不能启动,除非您指定另一个可用的存储引擎——default_storage_engine.您还必须设置——default_tmp_storage_engine

卸载插件

在运行时,卸载插件语句禁用和卸载服务器已知的插件。语句卸载插件并将其从mysql.plugin系统表,如果它在那里注册。由于这个原因,卸载插件声明要求删除特权的mysql.plugin表格由于插件不再在表中注册,服务器在随后的重启过程中不会加载插件。

卸载插件可以卸载插件,无论它是否加载在运行时安装插件或者在启动时使用插件加载选项,遵循以下条件:

  • 它不能卸载内置在服务器上的插件。可以将它们标识为具有库名的类的输出中INFORMATION_SCHEMA。插件显示插件

  • 它无法卸载服务器启动时使用的插件--plugin_name= FORCE_PLUS_PERMANENT,防止插件在运行时卸载。这些可以从LOAD_OPTION列的INFORMATION_SCHEMA。插件表格

要卸载当前在服务器启动时通过插件加载选项加载的插件,请使用这个过程。

  1. 删除的my.cnf将所有与插件相关的选项和系统变量文件化。如果任何插件系统变量被持久化到mysqld-auto.cnf文件,删除它们使用重置持续var_name为了每一个人去除掉它。

  2. 重新启动服务器。

  3. 插件通常是在启动时使用插件加载选项安装的安装插件在运行时,但不是同时进行。但是,删除插件选项my.cnf文件可能不足以卸载它,如果在某些时候安装插件也被使用过。如果插件仍然出现在输出中INFORMATION_SCHEMA。插件显示插件,使用卸载插件把它从mysql.plugin表格然后重新启动服务器。

插件和可加载函数

插件安装后也可以自动安装相关的可加载函数。如果是这样,在卸载插件时,插件也会自动卸载这些函数。