Spec-Zone .ru
спецификации, руководства, описания, API

4.4.4. mysql_plugin — Плагины Сервера MySQL Configure

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

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

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

mysql_plugin [options] plugin {ENABLE|DISABLE}

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

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

mypluginsplugin1plugin2plugin3

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

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

shell> mysql_plugin myplugins ENABLE

Чтобы отключить плагины, использовать DISABLE вместо ENABLE.

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

mysql_plugin поддерживает следующие опции, которые могут быть определены на командной строке или в [mysqld] группа любого файла опции. Для опций, определенных в a [mysqld] группа, mysql_plugin распознает --basedir, --datadir, и --plugin-dir опции и игнорируют других. Для получения информации о файлах опции см. Раздел 4.2.3.3, "Используя Файлы Опции".

Таблица 4.2. mysql_plugin Опции

Формат Файл опции Описание
- basedir=path basedir=path Каталог основы сервера
- datadir=path datadir=path Каталог серверных данных
- справка Сообщение справки дисплея и выход
- my-print-defaults=path my-print-defaults=path Путь к my_print_defaults
- mysqld=path mysqld=path Путь к серверу
- без значений по умолчанию без значений по умолчанию Не читайте конфигурационный файл
- plugin-dir=path plugin-dir=path Каталог, где плагины располагаются
- plugin-ini=file_name plugin-ini=file_name Сменный конфигурационный файл
- значения по умолчанию печати значения по умолчанию печати Покажите значения по умолчанию конфигурационного файла
- многословный Многословный режим
- версия Выведите на экран информацию о версии и выход