УСТАНОВКА SONAME

Синтаксис

INSTALL SONAME 'plugin_library'

Описание

Это утверждение является вариантом УСТАНОВКИ ПЛАГИНА. Оно устанавливает все плагины из заданного plugin_library. Подробности см. в УСТАНОВКЕ ПЛАГИНА.

plugin_library — это имя общей библиотеки, содержащей код плагина. Расширение файла (например, libmyplugin.so или libmyplugin.dll) можно опустить (что делает утверждение одинаковым на всех архитектурах).

Общая библиотека должна находиться в каталоге плагинов (то есть, каталоге, заданном переменной системы plugin_dir). Библиотека должна быть в самом каталоге плагинов, а не в подкаталоге. По умолчанию plugin_dir — это каталог плагинов в каталоге, заданном переменной конфигурации pkglibdir, но его можно изменить, установив значение plugin_dir при запуске сервера. Например, установите его значение в файле my.cnf.

[mysqld]
plugin_dir=/path/to/plugin/directory

Если значение plugin_dir — относительный путь, он считается относительным к базовому каталогу MySQL (значению переменной системы basedir).

INSTALL SONAME добавляет одну или несколько строк в таблицу mysql.plugin, описывающую плагин. Эта таблица содержит имя плагина и имя файла библиотеки.

INSTALL SONAME заставляет сервер читать файлы опций (my.cnf) так же, как во время запуска сервера. Это позволяет плагину подбирать любые соответствующие параметры из этих файлов. Можно добавить параметры плагина в файл параметров даже до загрузки плагина (если используется префикс). Также можно удалить плагин, отредактировать my.cnf, и снова установить плагин. Перезапуск плагина таким образом позволит ему использовать новые значения параметров без перезапуска сервера.

INSTALL SONAME также загружает и инициализирует код плагина, чтобы сделать плагин доступным для использования. Плагин инициализируется путём выполнения его функции инициализации, которая обрабатывает любую настройку, которую плагин должен выполнить, прежде чем его можно использовать.

Для использования INSTALL SONAME, у вас должна быть привилегия INSERT для таблицы mysql.plugin.

При запуске сервера сервер загружает и инициализирует любой плагин, который указан в таблице mysql.plugin. Это означает, что плагин устанавливается с помощью INSTALL SONAME только один раз, а не каждый раз при запуске сервера. Загрузка плагина при запуске не происходит, если сервер запускается с параметром --skip-grant-tables.

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

Если вам нужно загрузить плагины для одного запуска сервера, когда задан параметр --skip-grant-tables (который сообщает серверу не читать системные таблицы), используйте параметр --plugin-load mysqld.

Если вам нужно установить только один плагин из библиотеки, используйте оператор УСТАНОВИТЬ ПЛАГИН.

Примеры

Для загрузки движка хранения XtraDB и всех его information_schema таблиц с помощью одного оператора используйте

INSTALL SONAME 'ha_xtradb';

Этот оператор можно использовать вместо INSTALL PLUGIN даже если библиотека содержит только один плагин:

INSTALL SONAME 'ha_sequence';

См. также

• Список плагинов
• Обзор плагинов
• SHOW PLUGINS
• УСТАНОВИТЬ ПЛАГИН
• УДАЛИТЬ ПЛАГИН
• УДАЛИТЬ SONAME
• SHOW PLUGINS
• Таблица INFORMATION_SCHEMA.PLUGINS
• mysql_plugin