MySQL服务器组件

MySQL Server包括用于扩展服务器功能的基于组件的基础结构。组件提供服务器和其他组件可用的服务。(就服务使用而言，服务器是一个组件，与其他组件相同。)组件仅通过它们提供的服务进行交互。

MySQL发行版包含几个实现服务器扩展的组件：用于配置错误日志记录的组件。请参见“MySQL服务器错误日志”和“错误日志组件”。

用于检查密码的组件。请参见“密码验证组件”。

使应用程序能够将其自己的消息事件添加到审核日志的组件。请参见“审核消息组件(audit_api_message_emit)”。

服务器组件实现的系统和状态变量在安装组件时会公开，并且其名称以特定于组件的前缀开头。例如，log_filter_dragnet错误日志过滤器组件实现了名为的系统变量log_error_filter_rules，其全名是dragnet.log_error_filter_rules。要引用此变量，请使用全名。

以下各节介绍如何安装和卸载组件，以及如何在运行时确定安装了哪些组件并获取有关它们的信息。

有关组件内部实现的信息，请参见MySQL Server Doxygen文档，网址为 https://dev.mysql.com/doc/index-other.html。例如，如果您打算编写自己的组件，那么此信息对于理解组件的工作方式非常重要。

安装和卸载组件

必须先将服务器组件装入服务器，然后才能使用它们。MySQL支持在运行时加载组件。

在INSTALL COMPONENT与UNINSTALL COMPONENTSQL语句使组件装卸。例如：INSTALL COMPONENT 'file://component_validate_password';

UNINSTALL COMPONENT 'file://component_validate_password';

加载程序服务处理组件的加载和卸载，并在用作注册表component的mysql系统数据库表中列出已加载的组件。

用于组件操作的SQL语句会影响服务器操作和mysql.component系统表，如下所示：INSTALL COMPONENT将组件加载到服务器中。组件立即变为活动状态。加载程序服务还将已加载的组件注册到mysql.component系统表中。对于随后的服务器重新启动，加载程序服务将加载mysql.component启动顺序中列出的所有组件。即使使用该--skip-grant-tables选项启动服务器，也会发生这种情况。

UNINSTALL COMPONENT停用组件并从服务器卸载它们。加载程序服务还会从mysql.component系统表中注销组件，以便在启动序列期间不再为后续服务器重新启动而加载它们。

与INSTALL PLUGIN服务器插件的相应语句相比INSTALL COMPONENT，组件的语句具有明显的优势，即无需知道用于命名组件的任何特定于平台的文件名后缀。这意味着INSTALL COMPONENT可以跨平台统一执行给定的语句。

获取服务器组件信息

系统数据库中的component表mysql包含有关当前加载的组件的信息，并显示已向其中注册了哪些组件INSTALL COMPONENT。要参见安装了哪些组件，请使用以下语句：SELECT * FROM mysql.component;

错误日志组件

本节描述各个错误日志组件的特征。有关配置错误日志记录的一般信息，请参见“MySQL服务器错误日志”。

日志组件可以是过滤器或接收器：过滤器处理日志事件，以添加，删除或修改事件字段，或完全删除事件。结果事件将传递到log_error_services系统变量值中命名的下一个日志组件。

接收器是日志事件的目标(写入器)。通常，接收器将日志事件处理为具有特定格式的日志消息，并将这些消息写入其关联的输出，例如文件或系统日志。

服务器log_error_services按照名称的顺序执行过滤器和接收器。因此，最右边的组件应该是一个接收器。如果最右边的组件是过滤器，则它对事件的任何更改都不会影响输出。

以下各节介绍了按组件类型分组的单个日志组件：错误日志过滤器组件

错误日志接收器组件

组件说明包括以下类型的信息：组件名称和预期用途。

组件是内置的还是必须加载的。对于可加载的组件，该说明指定了用于使用INSTALL COMPONENT nd UNINSTALL COMPONENT语句加载和卸载组件的URN 。

该组件是否可以在log_error_services值中多次列出。

对于接收器组件，该组件将输出写入的目标。

错误日志过滤器组件

错误日志过滤器组件实现错误日志事件的过滤：如果未启用任何筛选器组件，则不会进行筛选。

任何启用的筛选器组件都只会影响log_error_services值中稍后列出的组件的日志事件。特别是，对于任何log_error_services过滤器组件之前列出的任何日志接收器组件，都不会发生日志事件过滤。

log_filter_internal组件目的：结合和log_error_verbosity和log_error_suppression_list系统变量，根据日志事件优先级和错误代码实施过滤。

URN：此组件是内置的，INSTALL COMPONENT在使用前无需加载。

允许多次使用：否。

如果log_filter_internal被禁用，log_error_verbosity并且log_error_suppression_list没有任何效果。

log_filter_dragnet组件用途：根据dragnet.log_error_filter_rules系统变量设置定义的规则实施过滤。请参见“基于规则的错误日志过滤(log_filter_dragnet)”。

瓮：file://component_log_filter_dragnet

允许多次使用：否。

错误日志接收器组件

错误日志接收器组件是实现错误日志输出的编写器。如果未启用任何接收器组件，则不会发生日志输出。

一些接收器组件描述引用默认错误日志目标。这是控制台或文件，由log_error系统变量的错误指示，如“默认错误日志目标配置”中所述。

log_sink_internal组件目的：实现传统的错误日志消息输出格式。

URN：此组件是内置的，INSTALL COMPONENT在使用前无需加载。

允许多次使用：否。

输出目标：写入默认错误日志目标。

log_sink_json组件目的：实现JSON格式的错误日志记录。请参见“ JSON格式的错误记录”。

瓮：file://component_log_sink_json

允许多次使用：是。

输出目的地：JSON日志编写器根据默认错误日志目的地(由log_error系统变量指定)确定其输出目的地：如果log_error命名文件，则JSON 编写器将基于该文件名加上一个带编号的后缀(从00开始)来命名输出文件。例如，如果 is 为，则值中连续的named 实例将写入，等等。.NN.jsonNNlog_errorfile_namelog_sink_jsonlog_error_servicesfile_name.00.jsonfile_name.01.json

如果log_error为stderr，则JSON编写器将写入控制台。如果log_json_writer在log_error_services值中多次命名它们，它们都将写入控制台，这可能没有用。

log_sink_syseventlog组件目的：将错误记录到系统日志。这是Windows，syslogUnix和类似Unix的系统上的事件日志。

瓮：file://component_log_sink_syseventlog

允许多次使用：否。

输出目标：写入系统日志。不使用默认错误日志目标。

log_sink_test组件目的：供编写测试用例内部使用。不适用于生产用途。

瓮：file://component_log_sink_test

允许多次使用：是。

输出目标：写入默认错误日志目标。