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

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

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)