Начало работы с MyRocks

MyRocks — это движок хранения, который добавляет базу данных RocksDB в MariaDB. RocksDB — это LSM-база данных с высокой степенью сжатия, оптимизированная для флэш-хранилища.

Движок хранения необходимо установить, прежде чем использовать его.

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

Общий библиотечный файл движка хранения MyRocks включён в пакеты MariaDB в качестве ha_rocksdb.so или ha_rocksdb.dll общего библиотечного файла на системах, где его можно скомпилировать. Плагин был впервые включён в MariaDB 10.2.5.

Установка на Linux

Движок хранения MyRocks включён в бинарные tar-архивы на Linux.

Установка с помощью менеджера пакетов

Движок хранения MyRocks также можно установить с помощью менеджера пакетов на Linux. Для этого система должна быть настроена на установку из одного из репозиториев MariaDB.

Вы можете настроить менеджер пакетов на установку из репозитория пакетов MariaDB Corporation MariaDB, используя скрипт настройки репозитория пакетов MariaDB.

Вы также можете настроить менеджер пакетов на установку из репозитория MariaDB Foundation MariaDB, используя инструмент настройки репозитория MariaDB.

Установка с помощью yum/dnf

В дистрибутивах Linux, таких как RHEL, CentOS, Fedora и аналогичных, настоятельно рекомендуется установить соответствующий пакет RPM из репозитория MariaDB, используя yum или dnf. Начиная с RHEL 8 и Fedora 22, yum был заменён на dnf, который является следующей основной версией yum. Однако команды yum всё ещё работают на многих системах, использующих dnf. Например:

sudo yum install MariaDB-rocksdb-engine

Установка с помощью apt-get

В дистрибутивах Linux, таких как Debian, Ubuntu и аналогичных, настоятельно рекомендуется установить соответствующий пакет DEB из репозитория MariaDB, используя apt-get. Например:

sudo apt-get install mariadb-plugin-rocksdb

Установка с помощью zypper

В дистрибутивах Linux, таких как SLES, OpenSUSE и аналогичных, настоятельно рекомендуется установить соответствующий пакет RPM из репозитория MariaDB, используя zypper. Например:

sudo zypper install MariaDB-rocksdb-engine

Установка на Windows

Движок хранения MyRocks включён в пакеты MSI и ZIP на Windows.

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

После установки общего библиотечного файла плагин фактически не устанавливается в MariaDB по умолчанию. Существует два способа установки плагина с MariaDB.

Первый метод можно использовать для установки плагина без перезапуска сервера. Вы можете установить плагин динамически, выполнив INSTALL SONAME или INSTALL PLUGIN. Например:

INSTALL SONAME 'ha_rocksdb';

Второй метод можно использовать для указания серверу загружать плагин при запуске. Плагин можно установить таким образом, предоставив --plugin-load или --plugin-load-add параметры. Это можно указать как аргумент командной строки для mysqld или указать в соответствующей группе параметров сервера в файле параметров группа параметров в файле параметров. Например:

[mariadb]
...
plugin_load_add = ha_rocksdb

Примечание: при установке с помощью менеджера пакетов также может быть установлен файл параметров, содержащий --plugin-load-add параметр. Пакет RPM устанавливает его как /etc/my.cnf.d/rocksdb.cnf, а пакет DEB — как /etc/mysql/mariadb.conf.d/rocksdb.cnf

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

Вы можете удалить плагин динамически, выполнив UNINSTALL SONAME или UNINSTALL PLUGIN. Например:

UNINSTALL SONAME 'ha_rocksdb';

Если вы установили плагин, предоставив --plugin-load или --plugin-load-add параметры в соответствующей группе параметров сервера в файле параметров группа параметров в файле параметров, эти параметры следует удалить, чтобы предотвратить загрузку плагина при следующем перезапуске сервера.

Проверка установки

После установки MyRocks вы увидите RocksDB в списке плагинов:

SHOW PLUGINS;
+-------------------------------+----------+--------------------+---------------+---------+
| Name                          | Status   | Type               | Library       | License |
+-------------------------------+----------+--------------------+---------------+---------+
...
| ROCKSDB                       | ACTIVE   | STORAGE ENGINE     | ha_rocksdb.so | GPL     |
| ROCKSDB_CFSTATS               | ACTIVE   | INFORMATION SCHEMA | ha_rocksdb.so | GPL     |
| ROCKSDB_DBSTATS               | ACTIVE   | INFORMATION SCHEMA | ha_rocksdb.so | GPL     |
| ROCKSDB_PERF_CONTEXT          | ACTIVE   | INFORMATION SCHEMA | ha_rocksdb.so | GPL     |
| ROCKSDB_PERF_CONTEXT_GLOBAL   | ACTIVE   | INFORMATION SCHEMA | ha_rocksdb.so | GPL     |
| ROCKSDB_CF_OPTIONS            | ACTIVE   | INFORMATION SCHEMA | ha_rocksdb.so | GPL     |
| ROCKSDB_COMPACTION_STATS      | ACTIVE   | INFORMATION SCHEMA | ha_rocksdb.so | GPL     |
| ROCKSDB_GLOBAL_INFO           | ACTIVE   | INFORMATION SCHEMA | ha_rocksdb.so | GPL     |
| ROCKSDB_DDL                   | ACTIVE   | INFORMATION SCHEMA | ha_rocksdb.so | GPL     |
| ROCKSDB_INDEX_FILE_MAP        | ACTIVE   | INFORMATION SCHEMA | ha_rocksdb.so | GPL     |
| ROCKSDB_LOCKS                 | ACTIVE   | INFORMATION SCHEMA | ha_rocksdb.so | GPL     |
| ROCKSDB_TRX                   | ACTIVE   | INFORMATION SCHEMA | ha_rocksdb.so | GPL     |
...
+-------------------------------+----------+--------------------+---------------+---------+

Сжатие

Поддерживаемые типы сжатия указаны в переменной rocksdb_supported_compression_types. Например:

SHOW VARIABLES LIKE 'rocksdb_supported_compression_types';
+-------------------------------------+-------------+
| Variable_name                       | Value       |
+-------------------------------------+-------------+
| rocksdb_supported_compression_types | Snappy,Zlib |
+-------------------------------------+-------------+

См. MyRocks и сжатие данных для получения дополнительной информации.

Системные и статусные переменные

Все системные переменные и статусные переменные MyRocks начинаются с «rocksdb», поэтому вы можете запросить их, например:

SHOW VARIABLES LIKE 'rocksdb%';
SHOW STATUS LIKE 'rocksdb%';