Перейти к содержанию

CREATE PLUGIN

DDL-команда CREATE PLUGIN используется для регистрации плагина в кластере.

Синтаксис

CREATE PLUGIN IF NOT EXISTS plugin version WAIT APPLIED GLOBALLY LOCALLY OPTION ( TIMEOUT = double )

Параметры

  • PLUGIN — имя плагина. Соответствует правилам имен для всех объектов в кластере. Версия плагина указывается в формате semver
  • IF NOT EXISTS — позволяет избежать ошибки в случае, если такой плагин в кластере уже есть
  • WAIT APPLIED — при использовании этого параметра контроль пользователю будет возвращен только после того как данная операция будет применена либо во всем кластере (GLOBALLY), либо в рамках текущего инстанса (LOCALLY). По умолчанию — GLOBALLY.
  • TIMEOUT — интервал времени, за который Picodata пытается создать плагин в кластере. Если времени не хватило и вернулась ошибка, то или плагин не успел создаться, или создался, но нам не хватило времени получить об этом подтверждение. Чтобы проверить статус плагина, можно повторить еще раз команду его создания. Если плагин создан, то в результате вернется нуль строк. Если же плагин не был создан, то вернется одна строка. Если параметр не указан, используется значение системного параметра sql_ddl_timeout (по умолчанию 86400 секунд).

Требуемые привилегии

Данная команда требует привилегии Администратора СУБД (admin).

См. также:

Примеры

CREATE PLUGIN weather_cache 0.1.0;