19.2 Setting Up MySQL as a Document Store — MySQL 5.7

19.2 Настройка MySQL в качестве хранилища документов

Для использования MySQL 5.7 в качестве хранилища документов необходимо установить плагин X. Затем можно использовать протокол X для связи с сервером. Без работающего плагина X клиенты, использующие протокол X, не смогут подключиться к серверу. Плагин X поставляется с MySQL (5.7.12 или выше) — его установка не требует отдельной загрузки. В этом разделе описывается, как установить плагин X.

Следуйте приведенным ниже шагам:

Установите или обновите MySQL до версии 5.7.12 или выше.

После завершения установки или обновления запустите сервер. Инструкции по запуску сервера см. в разделе 2.9.2 «Запуск сервера».

Примечание

Установщик MySQL позволяет выполнить эти действия (и следующий шаг — установку плагина X) одновременно при новых установках на Microsoft Windows. В окне Плагины и расширения установите флажок Включить протокол X/MySQL в качестве хранилища документов. После установки убедитесь, что плагин X установлен.
Установите плагин X. Для установки плагина может быть использован пользователь, не обладающий правами суперпользователя (root), при условии, что у него есть разрешение INSERT для таблицы mysql.plugin.

Всегда сохраняйте существующие настройки конфигурации перед переконфигурированием сервера.

Для установки встроенного плагина X выполните одно из следующих действий:
- Используя Установщик MySQL для Windows:
  1. Запустите Установщик MySQL для Windows. Откроется панель управления Установщиком MySQL.
  2. Нажмите быструю команду Переконфигурировать для сервера MySQL. Используйте Далее и Назад для настройки следующих параметров:
    
    В разделе Учетные записи и роли подтвердите пароль текущей учетной записи root.
    
    В разделе Плагины и расширения установите флажок Включить протокол X/MySQL в качестве хранилища документов. Установщик MySQL предоставляет значение по умолчанию для номера порта и открывает порт брандмауэра для сетевого доступа.
    
    В разделе Применить настройки сервера нажмите Выполнить.
    
    Нажмите Готово, чтобы закрыть Установщик MySQL.
  3. Установите MySQL Shell.
- Используя MySQL Shell:
  1. Установите MySQL Shell.
  2. Откройте окно терминала (командную строку в Windows) и перейдите к расположению двоичных файлов MySQL (например, /usr/bin/ в Linux).
  3. Выполните следующую команду:
    
    mysqlsh -u user -h localhost --classic --dba enableXProtocol
- Используя программу MySQL Client:
  1. Откройте окно терминала (командную строку в Windows) и перейдите к расположению двоичных файлов MySQL (например, /usr/bin/ в Linux).
  2. Запустите командную строку клиента MySQL:
    
    mysql -u user -p
  3. Выполните следующее утверждение:
    
    mysql> INSTALL PLUGIN mysqlx SONAME 'mysqlx.so';
    
    Замените mysqlx.so на mysqlx.dll для Windows.
    
    Важно
    
    Пользователь mysql.session должен существовать перед загрузкой плагина X. mysql.session был добавлен в версию MySQL 5.7.19. Если словарь данных был инициализирован с использованием более ранней версии, необходимо запустить процедуру mysql_upgrade. Если обновление не выполнено, плагин X не запускается с сообщением об ошибке Произошла ошибка при попытке доступа к серверу с пользователем: mysql.session@localhost. Убедитесь, что пользователь присутствует на сервере и что mysql_upgrade был запущен после обновления сервера..
  4. Установите MySQL Shell.
Проверьте, что плагин X был установлен.

При правильной установке плагина X он отображается в списке при запросе активных плагинов на сервере с помощью одной из следующих команд:
- Команда MySQL Shell:
```
mysqlsh -u user --sqlc -e "show plugins"
```
- Команда программы MySQL Client:
```
mysql -u user -p -e "show plugins"
```
Если у вас возникли проблемы с установкой плагина X, или вы хотите узнать о других способах установки, настройки или удаления плагинов сервера, см. раздел 5.5.1 «Установка и удаление плагинов».

`mysqlxsys@localhost` Пользовательская учетная запись

При установке плагина X создается учетная запись пользователя mysqlxsys@localhost. Если по какой-либо причине создание учетной записи пользователя не удалось, установка плагина X также завершится неудачно. Вот объяснение того, для чего предназначена учетная запись пользователя mysqlxsys@localhost, и что делать, если ее создание не удалось.

Процесс установки плагина X использует пользователя MySQL root для создания внутренней учетной записи для пользователя mysqlxsys@localhost. Учетная запись mysqlxsys@localhost используется плагином X для аутентификации внешних пользователей в системе учетных записей MySQL и для завершения сеансов по запросу привилегированного пользователя. Учетная запись mysqlxsys@localhost создается заблокированной, поэтому ее нельзя использовать для входа внешним пользователям. Если по какой-либо причине учетная запись пользователя MySQL root недоступна, перед началом установки плагина X необходимо вручную создать пользователя mysqlxsys@localhost, выполнив следующие команды в командной строке клиента MySQL:

CREATE USER IF NOT EXISTS mysqlxsys@localhost IDENTIFIED WITH
mysql_native_password AS 'password' ACCOUNT LOCK;
GRANT SELECT ON mysql.user TO mysqlxsys@localhost;
GRANT SUPER ON *.* TO mysqlxsys@localhost;

Удаление плагина X

Если вам когда-либо потребуется удалить (деактивировать) плагин X, выполните следующую команду в командной строке клиента MySQL:

UNINSTALL PLUGIN mysqlx;

Не используйте MySQL Shell для выполнения предыдущей команды. Она работает в MySQL Shell, но вы получите ошибку (код 1130). Кроме того, удаление плагина также удаляет пользователя mysqlxsys.

19.2 Настройка MySQL в качестве хранилища документов

mysqlxsys@localhost Пользовательская учетная запись

Удаление плагина X

`mysqlxsys@localhost` Пользовательская учетная запись