7.6.7.1 Installing the Clone Plugin — MySQL 8.4

7.6.7.1 Установка плагина Clone

В этом разделе описывается, как установить и настроить плагин clone. Для удалённых операций клонирования плагин clone должен быть установлен на донорском и получателе MySQL серверах.

Для общей информации об установке или удалении плагинов, см. Раздел 7.6.1, «Установка и удаление плагинов».

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

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

Для загрузки плагина при запуске сервера используйте опцию --plugin-load-add для указания имени файла библиотеки, содержащей плагин. С этим методом загрузки плагина, опция должна указываться каждый раз при запуске сервера. Например, поместите эти строки в свой файл my.cnf, подкорректировав расширение имени файла библиотеки плагина в соответствии с вашей платформой. (Расширение файла библиотеки плагина зависит от вашей платформы. Распространённые расширения — .so для Unix и Unix-подобных систем, .dll для Windows).

[mysqld]
plugin-load-add=mysql_clone.so

После изменения my.cnf перезапустите сервер, чтобы новые настройки вступили в силу.

Примечание

Опция --plugin-load-add не может быть использована для загрузки плагина clone при перезапуске сервера во время обновления с предыдущей версии MySQL. В таких случаях попытка перезапуска сервера с использованием plugin-load-add=mysql_clone.so приводит к ошибке [ERROR] [MY-013238] [Server] Ошибка установки плагина 'clone': Невозможно установить во время обновления. Чтобы этого избежать, обновите сервер перед запуском сервера с использованием plugin-load-add=mysql_clone.so.

В качестве альтернативы, для загрузки плагина во время выполнения, используйте данное утверждение, подкорректировав расширение .so в соответствии с вашей платформой:

INSTALL PLUGIN clone SONAME 'mysql_clone.so';

INSTALL PLUGIN загружает плагин и также регистрирует его в таблице системы mysql.plugins, чтобы плагин загружался для каждого последующего нормального запуска сервера без необходимости использования --plugin-load-add.

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

mysql> SELECT PLUGIN_NAME, PLUGIN_STATUS
       FROM INFORMATION_SCHEMA.PLUGINS
       WHERE PLUGIN_NAME = 'clone';
+------------------------+---------------+
| PLUGIN_NAME            | PLUGIN_STATUS |
+------------------------+---------------+
| clone                  | ACTIVE        |
+------------------------+---------------+

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

Если плагин был ранее зарегистрирован с помощью INSTALL PLUGIN или загружен с помощью --plugin-load-add, вы можете использовать опцию --clone при запуске сервера для управления состоянием активации плагина. Например, чтобы загрузить плагин при запуске и предотвратить его удаление во время выполнения, используйте следующие опции:

[mysqld]
plugin-load-add=mysql_clone.so
clone=FORCE_PLUS_PERMANENT

Если вы хотите предотвратить запуск сервера без плагина clone, используйте --clone со значением FORCE или FORCE_PLUS_PERMANENT, чтобы заставить запуск сервера завершиться неудачно, если плагин не был успешно инициализирован.

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