CREATE PLUGIN plugin_name TYPE 'plugin_type' SONAME 'plugin_library'

Загружает указанную библиотеку (если она еще не загружена) и загружает из нее указанный плагин. Доступные типы плагинов включают:

• ranker
• index_token_filter
• query_token_filter

Для получения дополнительной информации о написании плагинов смотрите документацию plugins.

mysql> CREATE PLUGIN myranker TYPE 'ranker' SONAME 'myplugins.so';
Query OK, 0 rows affected (0.00 sec)

CREATE PLUGIN <username/package name on https://packagist.org/> TYPE 'buddy' VERSION <package version>

CREATE BUDDY PLUGIN <username/package name on https://packagist.org/> VERSION <package version>

CREATE PLUGIN manticoresoftware/buddy-plugin-show-hostname TYPE 'buddy' VERSION 'dev-main';
CREATE BUDDY PLUGIN manticoresoftware/buddy-plugin-show-hostname VERSION 'dev-main';

DROP PLUGIN plugin_name TYPE 'plugin_type'

Отмечает указанный плагин для выгрузки. Процесс выгрузки не является мгновенным, поскольку одновременные запросы могут всё ещё использовать его. Тем не менее, после выполнения DROP новые запросы больше не смогут получить доступ к плагину. Впоследствии, когда все текущие запросы, использующие плагин, завершатся, плагин будет выгружен. Если все плагины из указанной библиотеки выгружены, библиотека также будет автоматически выгружена.

mysql> DROP PLUGIN myranker TYPE 'ranker';
Query OK, 0 rows affected (0.00 sec)

DELETE BUDDY PLUGIN <username/package name on https://packagist.org/>

DELETE BUDDY PLUGIN manticoresoftware/buddy-plugin-show-hostname

Чтобы упростить управление плагинами Buddy, особенно при разработке нового или изменении существующего, предоставляются команды включения и отключения плагинов Buddy. Эти команды действуют временно во время выполнения и сбрасываются к настройкам по умолчанию после перезапуска демона или выполнения сброса Buddy. Чтобы навсегда отключить плагин, его нужно удалить.

Вам необходимо полное квалифицированное имя пакета плагина для его включения или отключения. Чтобы его найти, вы можете выполнить запрос SHOW BUDDY PLUGINS и посмотреть полное квалифицированное имя в поле package. Например, плагин SHOW имеет полное квалифицированное имя manticoresoftware/buddy-plugin-show.

ENABLE BUDDY PLUGIN <username/package name on https://packagist.org/>

ENABLE BUDDY PLUGIN manticoresoftware/buddy-plugin-show

POST /sql?mode=raw -d "ENABLE BUDDY PLUGIN manticoresoftware/buddy-plugin-show"

DISABLE BUDDY PLUGIN <username/package name on https://packagist.org/>

DISABLE BUDDY PLUGIN manticoresoftware/buddy-plugin-show

POST /sql?mode=raw -d "DISABLE BUDDY PLUGIN manticoresoftware/buddy-plugin-show"

RELOAD PLUGINS FROM SONAME 'plugin_library'

Перезагружает все плагины (UDF, ранкеры и т.д.) из указанной библиотеки. В определённом смысле процесс перезагрузки является транзакционным, обеспечивая следующее:

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

Во время RELOAD набор плагинов гарантированно согласован; они либо все старые, либо все новые.

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

Если возникнет какая-либо ошибка, RELOAD PLUGINS не делает ничего, сохраняет старые плагины и сообщает об ошибке.

В Windows перезаписывать или удалять DLL-библиотеку, которая в данный момент используется, может быть проблематично. Тем не менее, вы всё равно можете переименовать её, разместить новую версию под старым именем, а затем RELOAD сработает. После успешной перезагрузки вы также сможете удалить переименованную старую библиотеку.

mysql> RELOAD PLUGINS FROM SONAME 'udfexample.dll';
Query OK, 0 rows affected (0.00 sec)