Spec-Zone .ru
спецификации, руководства, описания, API
|
INSTALL PLUGINplugin_name
SONAME 'shared_library_name
'
Этот оператор устанавливает плагин сервера. Это требует INSERT privilege
для mysql.plugin
таблица.
plugin_name
имя плагина как определено в сменной структуре дескриптора,
содержавшейся в файле библиотеки (см. Раздел 22.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
таблица.
Если Вы перекомпилировали сменную библиотеку и должны переустановить ее, можно использовать любой из следующих методов:
Использовать UNINSTALL
PLUGIN
чтобы удалить все плагины в библиотеке, установите новый сменный файл библиотеки в
сменном каталоге, и затем используйте INSTALL
PLUGIN
устанавливать все плагины в библиотеке. У этой процедуры есть преимущество, что
это может использоваться, не останавливая сервер. Однако, если сменная библиотека содержит много
плагинов, следует выпустить многих INSTALL
PLUGIN
и UNINSTALL
PLUGIN
операторы.
Остановите сервер, установите новый сменный файл библиотеки в сменном каталоге, и перезапустите сервер.