7.6.5.1 Installing or Uninstalling ddl_rewriter — MySQL 9.2

7.6.5.1 Установка или удаление ddl_rewriter

В этом разделе описано, как установить или удалить плагин ddl_rewriter. Дополнительную информацию об установке плагинов см. в разделе 7.6.1 «Установка и удаление плагинов».

Примечание

Если плагин ddl_rewriter установлен, он всё равно будет занимать небольшую часть ресурсов даже при отключении. Чтобы избежать этой нагрузки, устанавливайте ddl_rewriter только на период, когда вы планируете его использовать.

Основной сценарий использования – изменение инструкций, восстановленных из дамповых файлов, поэтому типичный порядок действий: 1) установить плагин; 2) восстановить дамповый файл или файлы; 3) удалить плагин.

Для использования плагином сервером, библиотечный файл плагина должен располагаться в каталоге плагинов MySQL (каталог, указанный переменной среды plugin_dir). При необходимости, настройте расположение каталога плагинов, задав значение переменной plugin_dir при запуске сервера.

Имя файла библиотеки плагина – ddl_rewriter. Расширение файла отличается в зависимости от платформы (например, .so для Unix и Unix-подобных систем, .dll для Windows).

Для установки плагина ddl_rewriter используйте инструкцию INSTALL PLUGIN, при необходимости скорректировав .so расширение в зависимости от вашей платформы:

INSTALL PLUGIN ddl_rewriter SONAME 'ddl_rewriter.so';

Для проверки установки плагина, изучите таблицу схемы информации PLUGINS или используйте инструкцию SHOW PLUGINS (см. раздел 7.6.2 «Получение информации о серверных плагинах»). Например:

mysql> SELECT PLUGIN_NAME, PLUGIN_STATUS, PLUGIN_TYPE
       FROM INFORMATION_SCHEMA.PLUGINS
       WHERE PLUGIN_NAME LIKE 'ddl%';
+--------------+---------------+-------------+
| PLUGIN_NAME  | PLUGIN_STATUS | PLUGIN_TYPE |
+--------------+---------------+-------------+
| ddl_rewriter | ACTIVE        | AUDIT       |
+--------------+---------------+-------------+

Как показывает результат, ddl_rewriter реализован как плагин аудита.

Если плагин не удалось инициализировать, проверьте журнал ошибок сервера на наличие диагностических сообщений.

После установки, как описано выше, плагин ddl_rewriter останется установленным до его удаления. Для удаления используйте UNINSTALL PLUGIN:

UNINSTALL PLUGIN ddl_rewriter;

Если ddl_rewriter установлен, вы можете использовать параметр --ddl-rewriter для последующих запусков сервера, чтобы управлять включением плагина ddl_rewriter. Например, чтобы предотвратить включение плагина во время выполнения, используйте этот параметр:

[mysqld]
ddl-rewriter=OFF