Debian MariaDB插件怎么安装

Debian 上 MariaDB 插件的安装与卸载

一、准备与检查

• 确认 MariaDB 版本与运行状态：
  • 查看版本：mysql -V
  • 登录数据库：mysql -u root -p
• 确认插件目录与文件是否存在：
  • 查看插件目录：SHOW VARIABLES LIKE 'plugin_dir';
  • 在插件目录检查共享库（示例）：ls /usr/lib/x86_64-linux-gnu/mariadb19/plugin/ | grep semisync
• 权限要求：执行安装/卸载插件需要对系统表 mysql.plugin 具备 INSERT/DELETE 权限（通常 root 具备）。

二、安装插件的标准方式

• 临时安装（重启后不自动加载）：
  • 语法：INSTALL PLUGIN plugin_name SONAME 'shared_library.so';
  • 示例（半同步复制从库插件）：
    • INSTALL PLUGIN rpl_semi_sync_slave SONAME 'semisync_slave.so';
• 永久生效（推荐）：
  • 方式一：在配置文件中预加载
    • 编辑 /etc/mysql/mariadb.conf.d/50-server.cnf（或 /etc/my.cnf.d/server.cnf），在 [mariadb] 段添加：
      • plugin_load_add=semisync_slave.so
  • 方式二：写入系统表后重启也会自动加载
    • 先执行 INSTALL PLUGIN ... SONAME '...';，插件会被注册到 mysql.plugin，后续启动会自动加载。
• 说明：
  • 插件库文件必须位于 plugin_dir 目录中，文件名需与 SONAME 一致（含扩展名，如 .so）。
  • 若插件库包含多个插件，需对每个插件分别执行 INSTALL PLUGIN。

三、卸载与验证

• 卸载插件：
  • 语法：UNINSTALL PLUGIN plugin_name;
  • 示例：UNINSTALL PLUGIN rpl_semi_sync_slave;
  • 说明：该语句会从 mysql.plugin 移除记录并反初始化插件，但不会删除共享库文件。
• 验证插件状态与参数：
  • 列出已安装插件：SHOW PLUGINS;
  • 查看变量：SHOW VARIABLES LIKE '%semi_sync%';（以半同步为例）

四、常见插件示例

• 半同步复制（rpl_semi_sync）
  • 安装从库插件：INSTALL PLUGIN rpl_semi_sync_slave SONAME 'semisync_slave.so';
  • 安装主库插件：INSTALL PLUGIN rpl_semi_sync_master SONAME 'semisync_master.so';
  • 持久化（任选其一）：
    • 配置：plugin_load_add=semisync_master.so,semisync_slave.so
    • 或分别执行两条 INSTALL PLUGIN 语句。
• 审计日志（MariaDB Audit Plugin）
  • 安装：INSTALL PLUGIN server_audit SONAME 'server_audit.so';
  • 启用与配置（示例）：
    • SET GLOBAL server_audit_logging=ON;
    • SET GLOBAL server_audit_events='QUERY_DML,QUERY_DDL,CONNECTION';
    • SET GLOBAL server_audit_file_path='/var/log/mysql/audit.log';
  • 持久化（示例）：
    • 在 [mariadb] 段添加：
      • plugin_load_add=server_audit.so
      • server_audit_logging=ON
      • server_audit_events=QUERY_DML,QUERY_DDL,CONNECTION
      • server_audit_file_path=/var/log/mysql/audit.log
      • server_audit_file_rotate_size=100000000
      • server_audit_file_rotations=10
  • 注意：审计日志路径需确保 mysql 用户可写，且磁盘空间充足。

五、故障排查要点

• 库文件找不到或无法打开
  • 确认 .so 位于 plugin_dir，文件名与 SONAME 完全一致（含 .so）。
  • 若库文件来自外部，先将其复制到 plugin_dir，再执行 INSTALL PLUGIN。
• 权限不足
  • 使用具备对 mysql.plugin 表 INSERT/DELETE 权限的账户（如 root）。
• 插件已存在或版本不兼容
  • 已存在时先 UNINSTALL PLUGIN 再安装；更换与当前 MariaDB 版本匹配的插件版本。
• 配置文件未生效
  • 修改 /etc/mysql/mariadb.conf.d/*.cnf 后执行 systemctl restart mariadb 使配置生效。