MySQL插件开发全解析

### MySQL插件开发全解析 #### 一、MySQL插件信息查看与操作 在MySQL中，我们可以通过不同的命令来查看和操作插件。以下是具体介绍： | 命令 | 功能 | | ---- | ---- | | SHOW PLUGINS | 快速查看可用的插件 | | 查询mysql.plugin表 | 查看已加载的插件 | | 查询INFORMATION_SCHEMA.plugins视图 | 查看可用插件的元数据 | 例如，我们可以看到如下类似信息： ```plaintext PLUGIN_LICENSE: GPL LOAD_OPTION: ON *************************** 42. row *************************** PLUGIN_NAME: daemon_example PLUGIN_VERSION: 1.0 PLUGIN_STATUS: ACTIVE PLUGIN_TYPE: DAEMON PLUGIN_TYPE_VERSION: 50606.0 PLUGIN_LIBRARY: libdaemon_example.so PLUGIN_LIBRARY_VERSION: 1.4 PLUGIN_AUTHOR: Brian Aker PLUGIN_DESCRIPTION: Daemon example, creates a heartbeat beat file in mysql-heartbeat.log PLUGIN_LICENSE: GPL LOAD_OPTION: ON 42 rows in set (0.01 sec) ``` 这里展示了插件的详细信息，除了名称、类型和许可证信息外，还包括作者、版本和描述等。 #### 二、MySQL插件API 插件架构在`/include/mysql/plugin.h`文件中定义，下面我们来了解一些关键元素。 ##### 1. 插件类型定义 以下是常见插件类型的定义： ```c /* The allowable types of plugins */ #define MYSQL_UDF_PLUGIN 0 /* User-defined function */ #define MYSQL_STORAGE_ENGINE_PLUGIN 1 /* Storage Engine */ #define MYSQL_FTPARSER_PLUGIN 2 /* Full-text parser plugin */ #define MYSQL_DAEMON_PLUGIN 3 /* The daemon/raw plugin type */ #define MYSQL_INFORMATION_SCHEMA_PLUGIN 4 /* The I_S plugin type */ #define MYSQL_AUDIT_PLUGIN 5 /* The Audit plugin type */ #define MYSQL_REPLICATION_PLUGIN 6 /* The replication plugin type */ #define MYSQL_AUTHENTICATION_PLUGIN 7 /* The authentication plugin type */ #define MYSQL_VALIDATE_PASSWORD_PLUGIN 8 /* validate password plugin type */ #define MYSQL_MAX_PLUGIN_TYPE_NUM 9 /* The number of plugin types */ ``` ##### 2. 插件许可证定义 插件支持的许可证类型也有相应定义： ```c /* We use the following strings to define licenses for plugins */ #define PLUGIN_LICENSE_PROPRIETARY 0 #define PLUGIN_LICENSE_GPL 1 #define PLUGIN_LICENSE_BSD 2 #define PLUGIN_LICENSE_PROPRIETARY_STRING "PROPRIETARY" #define PLUGIN_LICENSE_GPL_STRING "GPL" #define PLUGIN_LICENSE_BSD_STRING "BSD" ``` 大多数标准MySQL插件的许可证是GPL，而仅在MySQL商业许可证中可用的插件，许可证设置为PROPRIETARY。 ##### 3. st_mysql_plugin结构 这是插件描述结构，定义如下： ```c /* Plugin description structure. */ struct st_mysql_plugin { int type; /* the plugin type (a MYSQL_XXX_PLUGIN value) */ void *info; /* pointer to type-specific plugin descriptor */ const char *name; /* plugin name */ const char *author; /* plugin author (for I_S.PLUGINS) */ const char *descr; /* general descriptive text (for I_S.PLUGINS) */ int license; /* the plugin license (PLUGIN_LICENSE_XXX) */ int (*init)(MYSQL_PLUGIN); /* the function to invoke when plugin is loaded */ int (*deinit)(MYSQL_PLUGIN);/* the function to invoke when plugin is unloaded */ unsigned int version; /* plugin version (for I_S.PLUGINS) */ struct st_mysql_show_var *status_vars; struct st_mysql_sys_var **system_vars; void * __reserved1; /* reserved for dependency checking */ unsigned long flags; /* flags for plugin */ }; ``` 该结构的前六个属性包含插件的元数据信息，接下来两个是加载和卸载插件的函数指针，后面是包含插件状态和系统变量的结构，最后一个属性用于设置标志以向服务器传达插件功能。 特别要注意的是`info`属性，它是指向每种插件类型专用结构的指针，这些结构在`/include/mysql`目录下以`plugin_*`命名的头文件中定义。例如，`plugin_auth.h`文件包含认证插件类型的结构定义。 以下是认证插件的结构示例： ```c /** Server authentication plugin descriptor */ struct st_mysql_auth { int interface_version; /** version plugin uses */ /** A plugin that a client must use for authentic ```