OpenSCADA

Модули/PostgreSQL

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

English • ‎mRussian • ‎Українська
Модуль Имя Версия Лицензия Источник Языки Платформы Тип Автор Описание
PostgreSQL БД PostgreSQL
  • Свойства: SQL, LIST, STRUCT, GET, SEEK, PRELOAD, SET, DEL, FIX, TR, ERR
3.1 GPL2 bd_PostgreSQL.so en,uk,ru,de x86,x86_64,ARM БД Роман Савоченко
  Максим Лысенко (2010-2011)
Модуль БД. Предоставляет поддержку СУБД PostgreSQL.

Модуль предоставляет в OpenSCADA поддержку СУБД PostgreSQL, которая является мощной реляционной и многоплатформенной СУБД, доступной по свободной лицензии и разрабатываемой сообществом PostgreSQL. Модуль основан на библиотеке API производителя СУБД PostgreSQL на языке "С" и позволяет выполнять действия над базами данных, таблицами и содержимым таблиц.

Contents

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

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

СУБД PostgreSQL адресуется строкой следующего типа: {host};{hostaddr};{user};{pass};{db};{port}[;{connect_timeout}]. Где:

В случае локального доступа к БД, в пределах одного хоста, строка адреса может выглядеть следующим образом: ;;user;password;OpenSCADA;;10

В случае удалённого доступа к СУБД нужно использовать имя хоста и порт сервера СУБД, например: server.nm.org;;user;password;OpenSCADA;;10

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

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

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

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

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

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

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

Типы полей OpenSCADA Типы полей СУБД PostgreSQL
TFld::String character(n), character varying(n), text
TFld::Integer integer, bigint, timestamp with time zone [для полей с флагом TFld::DateTimeDec]
TFld::Real double precision
TFld::Boolean smallint

4 Доступ к БД

СУБД PostgreSQL содержит механизм разделения доступа, который заключается в указании привилегий пользователя БД. В таблице ниже перечислены необходимые привилегии для полноценной работы.

Операция Привилегия
Создание БД CREATEDB
Создание соединения LOGIN

Для доступа к БД права нужно разрешать непосредственно для указанной БД, а в случае создания БД нужно также разрешать доступ к системной БД "template1", используемой для подключения на стадии создания новой БД.

Кратко рассмотрим процедуру первичной настройки сервера PostgreSQL, с целью подключения к нему с помощью данного модуля:

# Инициализация БД
$ service postgresql initdb
# Запуск БД
$ service postgresql start
local   all             all                                     trust
host    all             all             127.0.0.1/32            trust
$ service postgresql restart
$ psql -U postgres -d template1 -c "ALTER USER postgres PASSWORD '123456'"

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, PostgreSQL 8.3 (remote) AMD Turion L625 1.6, 2G, PostgreSQL 9.1 [local; 100Base-TX] Intel(R) Core(TM) i3 CPU 1.33GHz, 3G, HDD [100Base-TX]
Creating: 5 1.08; 1.6; 3.8 2.07
Updating: 4.8 1.12; 1.6; 3.9 2.35
Getting: 2.96 0.64; 1.2; 2.1 1.26
Seeking: - - 7.9
Seeking in preload: - - 0.038
Deleting: 1.73 0.39; 0.6; 1.6 0.94
Modules/PostgreSQL/ru - GFDLMarch 2024OpenSCADA 0.9.7