Модули/MySQL - OpenSCADAWiki

# Модули/MySQL

This page is a translated version of the page Modules/MySQL and the translation is 100% complete.

English • ‎mRussian • ‎Українська

Модуль | Имя | Версия | Лицензия | Источник | Языки | Платформы | Тип | Автор | Описание
--- | --- | --- | --- | --- | --- | --- | --- | --- | ---
MySQL | БД MySQL Свойства: SQL, LIST, STRUCT, GET, SEEK, PRELOAD, SET, DEL, FIX, TR, ERR | 4.0 | GPL2 | bd_MySQL.so | en,uk,ru,de | x86,x86_64,ARM | БД | Роман Савоченко | Модуль БД. Предоставляет поддержку СУБД MySQL.

Модуль предоставляет в OpenSCADA поддержку СУБД 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);
- charset-collation-engine — таблица символов, режим сравнения и движок хранилища БД для "CREATE DATABASE" и "SET";
- tms — таймауты MySQL в формате "{connect},{read},{write}" и секундах, значение по умолчанию "10,5,5".

В случае локального доступа к СУБД, в пределах одного хоста, нужно использовать UNIX сокет, например: ";user;password;OpenSCADA;;/var/lib/mysql/mysql.sock;utf8-utf8_general_ci-MyISAM;5,2,2"

В случае удалённого доступа к СУБД нужно использовать имя хоста и порт сервера СУБД, например: "server.nm.org;user;password;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".

Operations for 1000 records, seconds | Nokia N800, MySQL 5.0.89 MyISAM WLAN | AMD Turion L625 1.6, 2G, MySQL [5.0.51 MyISAM 100Base-TX; WLAN]; [5.1.62 MyISAM local; 100Base-TX]; [5.5.41 MyISAM local; InnoDB; MyISAM 100Base-TX; InnoDB] | Intel(R) Core(TM) i3 CPU 1.33GHz, 3G, HDD [5.5.49 MyISAM 100Base-TX; InnoDB]
--- | --- | --- | ---
Creating: | 4.53 | [1.1; 3.6]; [0.7; 1.00]; [0.57; 0.73; 2.1; 2.0] | [1.68; 1.56]
Updating: | 4.2 | [1.12; 3.8]; [0.7; 1.07]; [0.6; 0.66; 2.0; 2.0] | [1.75; 1.87]
Getting: | 2.88 | [0.8; 2.1]; [0.38; 0.69]; [0.38; 0.4; 1.3; 1.4] | [1.056; 1.12]
Seeking: | - | - | [1.89; 2.23]
Seeking in preload: | - | - | [0.03; 0.03]
Deleting: | 1.47 | [0.43; 1.7]; [0.27; 0.42]; [0.23; 0.2; 0.79; 0.6] | [0.66; 0.67]

Modules/MySQL/ru - GFDL | July 2026 | OpenSCADA 1+r3070