Утилита mysql_plugin позволяет администраторам MySQL управлять тем, какие плагины загружает сервер MySQL. Это альтернатива ручному указанию параметра --plugin-load при запуске сервера или использованию инструкций INSTALL PLUGIN и UNINSTALL PLUGIN во время работы.

В зависимости от того, используется ли mysql_plugin для включения или отключения плагинов, он вставляет или удаляет строки в таблице mysql.plugin, которая служит реестром плагинов. (Для выполнения этой операции mysql_plugin вызывает сервер MySQL в режиме загрузки. Это означает, что сервер не должен быть уже запущен.) При нормальном запуске сервера сервер автоматически загружает и включает плагины, перечисленные в mysql.plugin. Для дополнительного управления активацией плагинов используйте параметры --plugin_name, имеющие названия конкретных плагинов, как описано в разделе 5.5.1, «Установка и удаление плагинов».

Каждое обращение к mysql_plugin считывает файл конфигурации, чтобы определить, как настроить плагины, содержащиеся в одном файле библиотеки плагинов. Для вызова mysql_plugin используйте следующий синтаксис:

mysql_plugin [options] plugin {ENABLE|DISABLE}

plugin — имя плагина для настройки. ENABLE или DISABLE (регистр не учитывается) указывают, следует ли включить или отключить компоненты библиотеки плагинов, имя которой указано в файле конфигурации. Порядок аргументов plugin и ENABLE или DISABLE не имеет значения.

Например, для настройки компонентов файла библиотеки плагинов, названного myplugins.so на Linux или myplugins.dll на Windows, укажите значение plugin как myplugins. Предположим, что эта библиотека плагинов содержит три плагина: plugin1, plugin2 и plugin3, все из которых должны быть настроены под управлением mysql_plugin. По соглашению, файлы конфигурации имеют суффикс .ini и то же имя, что и библиотека плагинов, поэтому имя файла конфигурации для этой библиотеки плагинов по умолчанию — myplugins.ini. Содержимое файла конфигурации выглядит так:

myplugins
plugin1
plugin2
plugin3

Первая строка в файле myplugins.ini — это имя файла библиотеки без каких-либо расширений, таких как .so или .dll. Остальные строки — это имена компонентов, которые должны быть включены или отключены. Каждое значение в файле должно находиться на отдельной строке. Строки, в которых первый символ — '#', рассматриваются как комментарии и игнорируются.

Чтобы включить плагины, перечисленные в файле конфигурации, вызовите mysql_plugin следующим образом:

mysql_plugin myplugins ENABLE

Для отключения плагинов используйте DISABLE вместо ENABLE.

Возникает ошибка, если mysql_plugin не может найти файл конфигурации или файл библиотеки плагинов, или если mysql_plugin не может запустить сервер MySQL.

mysql_plugin поддерживает следующие параметры, которые можно указать в командной строке или в группе параметров [mysqld] любого файла параметров. Для параметров, указанных в группе [mysqld], mysql_plugin распознаёт параметры --basedir, --datadir и --plugin-dir и игнорирует остальные. Сведения о файлах параметров, используемых программами MySQL, см. в разделе 4.2.2.2, «Использование файлов параметров».