7.6.5.1 Installing or Uninstalling ddl_rewriter — MySQL 8.4

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-подобных систем и .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