Модуль <MySQL> предоставляет в систему OpenSCADA поддержку БД MySQL. БД MySQL является мощной реляционной и многоплатформенной БД, доступной по свободной лицензии. Настоящим разработчиком БД MySQL является Корпорация Oracle. Полностью свободной реализацией MySQL является проект MariaDB. Модуль основан на библиотеке API БД MySQL на языке "С". Модуль позволяет выполнять действия над базами данных, таблицами и содержимым таблиц.
1. Операции над БД
Поддерживаются операции открытия и закрытия БД с возможностью создания новой БД при открытии и удаления существующей при закрытии. В терминах подсистемы "БД" системы OpenSCADA открытием БД является её регистрация для последующего использования в системе. Также поддерживается операция запроса списка таблиц в БД.
БД MySQL адресуется строкой следующего типа: "{host};{user};{pass};{db};{port}[;{u_sock}[;{charset-collation}[;{tms}]]]". Где:
host — имя хоста на котором работает сервер БД MySQL;
user — имя пользователя БД;
pass — пароль пользователя для доступа к БД;
bd — имя БД;
port — порт, который слушает сервер БД (по умолчанию 3306);
u_sock — имя UNIX-сокета в случае локального доступа к БД (/var/lib/mysql/mysql.sock);
tms — таймауты MySQL в формате "{connect},{read},{write}" и секундах.
В случае локального доступа к БД, в пределах одного хоста, нужно использовать UNIX сокет. Например: ";roman;123456;OpenSCADA;;/var/lib/mysql/mysql.sock;utf8-utf8_general_ci-MyISAM;5,2,2"
В случае удалённого доступа к БД нужно использовать имя хоста и порт сервера БД. Например: "server.nm.org;roman;123456;OpenSCADA;3306"
2. Операции над таблицей
Поддерживаются операции открытия, закрытия таблицы с возможностью создания новой таблицы при открытии и удаления существующей при закрытии, а также запрос структуры таблицы.
3. Операции над содержимым таблицы
сканирование записей таблицы;
запрос значений указанных записей;
установка значения указанных записей;
удаление записей.
API подсистемы “БД” предполагает доступ к содержимому таблицы по значению ключевого(ых) поля(ей). Так, операция запроса записи подразумевает предварительную установку ключевых колонок объекта TConfig, по которым будет выполнен запрос. Создание новой записи(строки) производится операцией установки значений записи, которая отсутствует.
Модуль позволяет динамически изменять структуру таблиц БД MySQL. Так, в случае несоответствия структуры таблицы и структуры устанавливаемой записи, структура таблицы будет приведена к требуемой структуре записи. В случае запроса значений записи и несоответствия структур записи и таблицы, будут получены только значения общих элементов записи и таблицы. Модуль не отслеживает порядок расположения элементов в записи и структуре таблицы.
Модулем реализуется механизм поддержки многоязыковых текстовых переменных. Для полей с многоязыковой текстовой переменной создаются колонки отдельных языков в формате <lang>#<FldID> (en#NAME). При этом базовая колонка содержит значение для базового языка. Колонки отдельных языков создаются по надобности, в момент сохранения в БД и при исполнении OpenSCADA в соответствующей локали. В случае отсутствия значения для конкретного языка будет использоваться значение для базового языка.
Типы элементов БД MySQL следующим образом соответствуют типам элементов системы OpenSCADA:
Типы полей системы OpenSCADA
Типы полей БД MySQL
TFld::String
char(n), text, mediumtext
TFld::Integer
int(n), DATETIME [для полей с флагом TFld::DateTimeDec]
TFld::Real
double(n,m)
TFld::Boolean
tinyint(1)
4. Доступ к БД
БД MySQL содержит мощный механизм разделения доступа, который заключается в выборочном указании доступа пользователя БД к отдельным SQL-командам. В таблице ниже перечислены операции над БД и требуемый доступ к командам для этих операций.
Операция
SQL-команды
Создание БД и таблиц
CREATE
Удаление БД и таблиц
DROP
Добавление записей
INSERT
Удаление записей
DELETE
Получение значений записей
SELECT
Установка значений записей
UPDATE
Манипуляция структурой таблицы
ALTER
Кратко рассмотрим процедуру первичной настройки сервера MySQL с целью подключения к нему с помощью данного модуля:
Установка сервера СУБД MySQL в виде пакета или сборкой.
Запуск сервера БД, если не запустился сразу:
$ service mysqld start
Устанавливаем нужный пароль для системного пользователя "root":
$ mysqladmin -u root password '123456'
Подключаемся к серверу БД локально с помощью данного модуля, введя адрес БД: "localhost;root;123456;test;;;utf8"
Разрешаем внешний доступ:
my.cnf: Меняем значение "bind-address" на "0.0.0.0" для доступа со всех интерфейсов.
Подключаемся к СУБД локально, для управления пользователями "$ mysql -u root -p":
Получаем перечень пользователей: "SELECT Host,User,Password FROM mysql.user;"
Добавляем пользователя: "CREATE USER 'newuser'@'%' IDENTIFIED BY 'password';"
Удаляем пользователя: "DROP USER 'newuser'@'%’;"
Изменить пароль: "UPDATE mysql.user SET Password=PASSWORD('newpass') WHERE User='newuser';
Устанавливаем пользователю все права: "GRANT ALL PRIVILEGES ON *.* TO 'newuser'@'%';"
Применяем привилегии: "FLUSH PRIVILEGES;"
5. Производительность БД
Замер производительности БД выполнялся тестом "БД" модуля системных тестов "SystemTests", путём выполнения операций над записями структурой: <name char (20), descr char (50), val double (10.2), id int (7), stat bool, reqKey string, reqVal string>.