From OpenSCADAWiki
Jump to: navigation, search
This page is a translated version of the page Modules/SQLite and the translation is 100% complete.

Other languages:
English • ‎российский • ‎українська
Модуль Имя Версия Лицензия Источник Языки Платформы Тип Автор Описание
SQLite БД SQLite 2.6 GPL2 bd_SQLite.so en,uk,ru,de x86,x86_64,ARM БД Роман Савоченко Модуль БД. Предоставляет поддержку БД SQLite.

Модуль предоставляет в OpenSCADA поддержку БД SQLite. БД SQLite является небольшой и встраиваемой БД, поддерживающей SQL-запросы. БД SQLite распространяется под свободной лицензии. Ознакомиться с БД можно на сайте БД — http://sqlite.org. Модуль основан на библиотеке API производителя БД языка "C". Модуль позволяет выполнять действия над базами данных, таблицами и содержимым таблиц.

1 Операции над БД

Поддерживаются операции открытия и закрытия БД, с возможностью создания новой БД при открытии и удаления существующей при закрытии. В терминах подсистемы "БД" OpenSCADA, открытием БД является её регистрация для последующего использования программой. Также, поддерживается операция запроса перечня таблиц в БД.

БД SQLite адресуется путём указания имени файла БД в формате: "{FileDBPath}". Где:

  • FileDBPath — полный путь к файлу БД (./oscada/Main.db).
Используйте пустой путь для создания временной базы данных на диске.
Используйте ":memory:" для создания временной базы данных в памяти.

2 Операции над таблицей

Поддерживаются операции открытия, закрытия таблицы, с возможностью создания новой таблицы при открытии и удаления существующей при закрытии, а также запрос структуры таблицы.

3 Операции над содержимым таблицы

  • сканирование записей таблицы;
  • запрос значений указанных записей;
  • установка значений указанных записей;
  • удаление записей.

API подсистемы "БД" предполагает доступ к содержимому таблицы по значению ключевого(ых) полей. Так, операция запроса записи подразумевает предварительную установку ключевых колонок объекта TConfig, по которым будет выполнен запрос. Создание новой записи(строки) производится операцией установки значений записи, которая отсутствует.

Модуль позволяет динамически менять структуру таблиц БД SQLite, путём создания новой БД с требуемой структурой и копирования в неё данных из старой. Так, в случае несоответствия структуры таблицы и структуры устанавливаемой записи, структура таблицы будет приведена к требуемой структуре записи. В случае запроса значений записи и несоответствия структур записи и таблицы, будут получены только значения общих элементов записи и таблицы. Модуль не отслеживает порядка расположения элементов записи и структуры таблицы!

Модулем реализуется механизм поддержки многоязыковых текстовых переменных. Для полей с многоязыковой текстовой переменной создаются колонки отдельных языков в формате "{lang}#{FldID}" (en#NAME). При этом, базовая колонка содержит значение для базового языка. Колонки отдельных языков создаются по надобности, в момент сохранения в БД и при исполнении OpenSCADA в соответствующей локали. В случае отсутствия значения для конкретного языка будет использоваться значений для базового языка.

Типы элементов БД SQLite следующим образом соответствуют типам элементов OpenSCADA:

Типы полей OpenSCADA Типы полей БД SQLite
TFld::String TEXT
TFld::Integer, TFld::Boolean INTEGER
TFld::Real DOUBLE

4 Права доступа

Права доступа к БД определяются правами доступа к отдельно взятому файлу БД. Модулем поддерживается работа с файлами БД SQLite в режиме только для чтения, например, в демонстрациях.

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, SD 4GClass6
Nokia N900
RPi2 Debian8 Class10 UHS1;
RPi3 Debian8 Class10 UHS1;
OrangePiZero Debian8 Class2
AMD Turion L625 1.6, 2G [HDD; SSD]
Intel(R) Core(TM) i3 CPU 1.33GHz, 3G [HDD; SSD];
Intel(R) Core(TM) i7 CPU 2.6GHz, 12G FastSSD
Creating: 3.3; 1.96 0.78; 0.43; 0.48 [0.49; 0.2]; [0.39; 0.22]; 0.056
Updating: 3.2; 2.47 0.7; 0.41; 0.45 [0.48; 0.19]; [0.40; 0.21]; 0.053
Getting: 2.6; 1.81 0.69; 0.38; 0.45 [0.36; 0.19]; [0.31; 0.21]; 0.051
Seeking: 3.1; 1.48 0.76; 0.42; 0.51 [-; 0.22]; [0.21; 0.22]; 0.052
Seeking in preload: 0.53; 0.29 0.13; 0.071; 0.088 [-; 0.028]; [0.027; 0.028]; 0.0073
Deleting: 1.18; 0.43 0.20; 0.10; 0.13 [0.08; 0.058]; [0.067; 0.069]; 0.012