Модули/SQLite - OpenSCADAWiki

# Модули/SQLite

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

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

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

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

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

## 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

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