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

13.7.3.3. INSTALL PLUGIN Синтаксис

INSTALL PLUGIN plugin_name SONAME 'shared_library_name'

Этот оператор устанавливает плагин сервера. Это требует INSERT privilege для mysql.plugin таблица.

plugin_name имя плагина как определено в сменной структуре дескриптора, содержавшейся в файле библиотеки (см. Раздел 23.2.4.2, "Сменные Структуры данных"). Сменные имена не являются чувствительными к регистру. Для максимальной совместимости сменные имена должны быть ограничены буквами ASCII, цифры, и подчеркивание, потому что они используются в исходных файлах C, окружают командные строки, M4 и сценарии Оболочки Bourne, и среды SQL.

shared_library_name имя совместно используемой библиотеки, которая содержит сменный код. Имя включает расширение файла (например, libmyplugin.so, libmyplugin.dll, или libmyplugin.dylib).

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

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

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

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

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

Сменная библиотека может содержать многократные плагины. Для каждого из них, чтобы быть установленными, используйте отдельное INSTALL PLUGIN оператор. Каждый оператор называет различный плагин, но все они определяют то же самое имя библиотеки.

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

Для опций, которые управляют отдельным плагином, загружающимся при запуске сервера, см. Раздел 5.1.8.1, "Устанавливая и Удаляя Плагины". Если Вы должны загрузить плагины для единственного запуска сервера когда --skip-grant-tables опция дается (который говорит серверу не читать системные таблицы), используйте --plugin-load опция. См. Раздел 5.1.3, "Опции Команды Сервера".

Чтобы удалить плагин, используйте UNINSTALL PLUGIN оператор.

Для дополнительной информации о сменной загрузке см. Раздел 5.1.8.1, "Устанавливая и Удаляя Плагины".

Чтобы видеть, какие плагины устанавливаются, используйте SHOW PLUGINS оператор или запрос INFORMATION_SCHEMA.PLUGINS таблица.

Если Вы перекомпилировали сменную библиотеку и должны переустановить ее, можно использовать любой из следующих методов: