7.6.7.1 Installing the Clone Plugin — MySQL 9.2

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, чтобы заставить запуск сервера завершиться неудачей, если плагин не инициализируется успешно.

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