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
允许多次使用:是。
输出目标:写入默认错误日志目标。