Alpha.Community

В разделе Документация вы найдете все для уверенного старта и работы с Альфа платформой: от пошаговых инструкций по установке и конфигурированию до подробного описания работы компонентов и подсистем. Для поиска необходимых тем и вопросов в документации, воспользуйтесь поиском и фильтрацией результатов.

Назначение и принцип работы

Модуль SQL Клиент — коммуникационный модуль Alpha.Server, предназначенный для обмена данными с источником с помощью запросов языка SQL.

Функции модуля SQL Клиент:

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

В качестве источника данных для модуля SQL Клиент могут выступать СУБД PostgreSQL, MySQL, Microsoft SQL Server, Oracle. Модуль может обмениваться данными с несколькими различными источниками одновременно.

Поддержана работа с СУБД:

  • PostgreSQL версий от 9.5 до 17;
  • Postgres Pro Standard версий 14, 15, 16 и 17.6.

Для доступа к источнику данных модуль SQL Клиент использует интерфейсы OLE DB и ODBC.

Обмен данными с источником

Модуль SQL Клиент подключается к источнику по заданной в настройках модуля строке подключения и отправляет источнику SQL-запросы.

Для получения данных модуль SQL Клиент отправляет источнику SQL-запрос чтения данных. Полученные результаты запроса модуль записывает в сигналы Alpha.Server.

Для записи значений свойств сигналов Alpha.Server в источник модуль SQL Клиент отправляет SQL-запрос записи данных.

SQL-запросы модуль отправляет периодически, либо по команде, в зависимости от настроек каждого запроса.

Строка подключения

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

Модуль SQL Клиент позволяет шифровать часть параметров строки подключения. Для этого в настройках источника данных строка подключения разделена на две части:

  • Открытая часть - содержит параметры подключения, которые хранятся в конфигурации в открытом виде.
  • Секретная часть - содержит параметры подключения, которые хранятся в конфигурации в зашифрованном виде, например, пароль, имя пользователя или любые другие параметры, которые пользователь желает скрыть. Если шифрование параметров подключения не требуется, то секретную часть можно оставить пустой.

Полная строка подключения формируется в последовательности:

{Открытая часть} {Секретная часть}

Примеры строк подключения и возможные параметры приведены в приложении Приложение A: Строки подключения.

Используемые конструкции языка SQL

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

Получение данных источника

Для получения данных источника модуль SQL Клиент использует конструкцию SELECT или вызов хранимой процедуры.

SELECT

Выбор данных из таблицы. Общий вид запроса:

SELECT {столбцы} FROM {таблица}

где:

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

Дополнительные операторы, которые могут использоваться в запросе:

  • WHERE — условие, по которому будут выбраны данные. В условии могут использоваться конструкции AND, OR, BETWEEN, LIKE;
  • GROUP BY — столбец, по которому будут группироваться данные;
  • HAVING — условие, по которому сгруппированные данные будут отфильтрованы;
  • ORDER BY — столбец, по которому данные будут отсортированы.

Из таблицы tank_db выбрать все имеющиеся значения и их качества.

SELECT value,quality FROM tank_db

Из таблицы tank_db выбрать значения с качеством 192.

SELECT value FROM tank_db WHERE quality=192

Из таблицы tank_db выбрать значения сигнала с идентификатором 3 и качеством 192.

SELECT value FROM tank_db WHERE id=3 AND quality=192

SELECT обязательно должен содержать список возвращаемых столбцов таблицы. Конструкция SELECT * запрещена.

Запись данных в источник

Для записи данных в источник модуль SQL Клиент использует конструкции UPDATE, INSERT, DELETE или вызов хранимой процедуры.

UPDATE

Изменение данных в таблице. Общий вид запроса:

UPDATE {таблица} SET {столбец = значение} WHERE {условие}

где:

  • UPDATE — таблица, в которой требуется изменить данные;
  • SET — столбец, который требуется изменить, и новое значение;
  • WHERE — условие, по которому будут изменены данные.

В таблице tank_type изменить значение диаметра на 12 для типа резервуара с идентификатором 4.

UPDATE tank_type SET diameter=12 WHERE type_id=4
INSERT

Добавление новой строки в таблицу. Общий вид запроса:

INSERT INTO {таблица (столбцы)} VALUES {(значения)}

где:

  • INSERT INTO — таблица, в которую требуется добавить строку, и столбцы, которые требуется заполнить;
  • VALUES — значения, которые требуется внести в столбцы.

В таблицу tank_type добавить новый тип резервуара с идентификатором 5, диаметром 10, высотой 9.

INSERT INTO tank_type(type_id,diameter,height) VALUES (5,10,9)
DELETE

Удаление строки из таблицы. Общий вид запроса:

DELETE FROM {таблица} WHERE {условие}

где:

  • DELETE FROM — таблица, из которой требуется удалить строки;
  • WHERE — условие, по которому будут удалены строки.

Из таблицы tank_db удалить все значения с качеством 0.

DELETE FROM tank_db WHERE quality=0

Вызов хранимой процедуры

Для получения данных источника и записи данных в источник модуль SQL Клиент может использовать инструкции:

  • CALL — вызов процедуры, которая хранится в базе данных;
  • EXECUTE — выполнение хранимой процедуры или SQL-запроса.

Запросы с параметрами

Помимо обычных SQL-запросов с заданными в запросе значениями столбцов, модуль SQL Клиент поддерживает запросы с параметрами. Запрос с параметрами вместо значений столбцов содержит символы ?. Модуль SQL Клиент вместо символов ? подставляет в запрос значения сигналов Alpha.Server и отправляет в источник динамически сформированный SQL-запрос.

Из таблицы tank_db требуется выбрать значения с заданными идентификатором и качеством.
Запрос с параметрами имеет вид:

SELECT value FROM tank_db WHERE id=? AND quality=?

При установке сигналам Alpha.Server, соответствующим идентификатору и качеству, значений 3 и 192, модуль SQL Клиент отправит в источник запрос:

SELECT value FROM tank_db WHERE id=3 AND quality=192

При установке этим же сигналам Alpha.Server значений 10 и 0 модуль SQL Клиент отправит в источник запрос:

SELECT value FROM tank_db WHERE id=10 AND quality=0

В таблицу tank_db требуется добавить новые типы резервуаров с заданными идентификатором, диаметром и высотой.

Запрос с параметрами имеет вид:

INSERT INTO tank_type(type_id,diameter,height) VALUES (?,?,?)

При установке сигналам Alpha.Server, соответствующим идентификатору, диаметру и высоте, значений 5, 10 и 9, модуль SQL Клиент отправит в источник запрос:

INSERT INTO tank_type(type_id,diameter,height) VALUES (5,10,9)

При установке этим же сигналам Alpha.Server значений 6, 15 и 8 модуль SQL Клиент отправит в источник запрос:

INSERT INTO tank_type(type_id,diameter,height) VALUES (6,15,8)

Типы привязок сигналов

Чтобы модуль SQL Клиент записывал результаты запроса в свойства сигналов Alpha.Server, а также подставлял значения сигналов Alpha.Server в запросы с параметрами, в карте адресов сигналам SQL Клиент нужно задать тип привязки - QRead или QParam.

Тип привязки QRead указывайте для сигналов Alpha.Server, в свойства которых требуется записывать результаты выполнения запроса.

Запись результатов запросов в свойства сигналов Alpha.Server с типом привязки QRead выполняется в соответствии с таблицей, приведенной в приложении Приложение C: Совместимость типов данных.

Тип привязки QParam указывайте для сигналов Alpha.Server, значения которых требуется подставлять в запросы с параметрами для динамического формирования SQL-запросов.

Для подстановки значений сигналов Alpha.Server с типом привязки QParam в запросы с параметрами, сигналы Alpha.Server должны быть хорошего качества.

Из таблицы tank_db требуется выбрать значения с заданными идентификатором и качеством.
Запрос с параметрами имеет вид:

SELECT value FROM tank_db WHERE id=? AND quality=?

Создайте сигналы:

  • Id с типом привязки QParam для задания идентификатора;
  • Quality с типом привязки QParam для задания качества;
  • Value с типом привязки QRead для получения значения с заданными идентификатором и качеством.

В карте адресов для каждого сигнала указан соответствующий тип привязки:

При установке сигналам Id и Quality некоторых значений, например, 3 и 192, модуль SQL Клиент отправит в источник запрос:

SELECT value FROM tank_level WHERE id=3 AND quality=192

В результате выполнения запроса в сигнал Value будет записано значение, соответствующее идентификатору 3 с качеством 192.