В разделе Документация вы найдете все для уверенного старта и работы с Альфа платформой: от пошаговых инструкций по установке и конфигурированию до подробного описания работы компонентов и подсистем. Для поиска необходимых тем и вопросов в документации, воспользуйтесь поиском и фильтрацией результатов.
-
Альфа платформа (ред. 26)
-
Лицензирование Альфа платформы
-
Ключи Guardant
-
Ключи Sentinel
-
-
Правила брандмауэра
-
Настройка DCOM
-
Работа в ОС Linux
-
Alpha.Server 6.5 (ред. 2. Предварительная)
-
Alpha.Server
-
Основные механизмы
-
Приложения
-
Модули
-
Коммуникационные модули
-
Link
-
TCP Сервер
-
-
Modbus
-
Modbus RTU Опросчик
-
Настройка обмена данными со станцией
-
Modbus RTU Станция
-
Modbus TCP Опросчик
-
Modbus TCP Станция
-
-
OPC
-
OPC AE Сервер
-
Функциональные возможности
-
OPC DA
-
OPC DA Клиент
-
OPC DA Сервер
-
-
OPC HDA
-
OPC HDA Клиент
-
OPC HDA Сервер
-
-
OPC UA
-
OPC UA Клиент
-
Настройка обмена данными с OPC UA сервером
-
Установка безопасного соединения
-
Приложения
-
OPC UA Сервер
-
Сертификаты
-
Приложения
-
-
-
МЭК 60870-5
-
МЭК 60870-5-101 Опросчик
-
Приложения
-
МЭК 60870-5-101 Станция
-
МЭК 60870-5-104 Опросчик
-
МЭК 60870-5-104 Станция
-
-
Универсальный модуль Опросчик (Меркурий, DCON)
-
МЭК 61850 Клиент
-
Обмен данными с устройствами
-
Набор данных устройства и сигналы сервера
-
ПОРТАЛ Клиент
-
Настройка обмена данными с ППД
-
ТЭМ-104
-
Приложения
-
BACnet Клиент
-
Настройка обмена данными с устройством
-
Приложения
-
EtherNet/IP Сканер
-
Приложения
-
FINS Клиент
-
Настройка обмена данными с ПЛК
-
MDLC Клиент
-
Настройка обмена данными с устройством MDLC
-
MQTT Клиент
-
Настройка обмена данными
-
Siemens S7 Клиент
-
Настройка обмена данными с ПЛК
-
Приложения
-
SNMP Менеджер
-
SQL Клиент
-
Настройка обмена данными с источником
-
Приложения
-
UNET Клиент
-
-
Служебные модули
-
Клиент безопасности
-
Получение значений из Alpha.Security
-
Модуль вычислений
-
Модуль истории
-
Приложения
-
Подсистема резервирования
-
Data Buffer
-
NetDiag, NetDiag2
-
Приложения
-
ProcessMonitor
-
SMTP
-
Snapshot
-
Запись данных в файл-срез
-
Модули Syslog
-
Syslog Клиент
-
Syslog Сервер
-
Приложения
-
Приложения
-
-
Write VQT
-
FS Generator
-
-
-
Сервисные приложения
-
Конфигуратор
-
Статистика
-
Просмотрщик лога кадров
-
-
Alpha.AccessPoint 6.5 (ред. 2. Предварительная)
-
Alpha.Imitator 6.5 (ред. 2. Предварительная)
-
Приложения
-
Alpha.Historian 4.0 (ред. 3. Предварительная)
-
Устройство и принципы работы
-
Управление базами данных
-
Общие
-
4x
-
3x
-
-
Устаревшие разделы
-
Справочник
-
Настройки базы данных
-
Alpha.Domain 1.5 (ред. 1)
-
Принципы настройки подсистемы
-
Приложения
-
Alpha.DevStudio 4.2 (ред. 4. Предварительная)
-
Руководство пользователя
-
Знакомство с Alpha.DevStudio
-
Разработка проекта
-
Описание домена
-
Добавление компонентов домена
-
-
Добавление объектов
-
Описание объектов
-
Добавление атрибутов
-
-
Пользовательский интерфейс
-
Инструменты
-
Редакторы
-
-
Интерфейс командной строки
-
Справочник
-
Элементы
-
Автоматизация
-
ВНИИАЭС
-
Карты адресов
-
Коммуникационные модули
-
-
Гидроуклон
-
Служебные модули
-
-
Инконтрол
-
Инконтрол
-
-
Контроллеры Modicon
-
Modbus
-
Контроллеры
-
-
Контроллеры OMRON
-
Карты адресов
-
Коммуникационные модули
-
Контроллеры
-
-
Контроллеры REGUL
-
Modbus
-
OPC
-
Контроллеры
-
МЭК 60870-5
-
-
Контроллеры SIMATIC
-
Карты адресов
-
Коммуникационные модули
-
Контроллеры
-
-
Контроллеры ТРЭИ
-
Modbus
-
Карты адресов
-
Коммуникационные модули
-
Контроллеры
-
-
Обобщенные устройства
-
Карты адресов
-
Коммуникационные модули
-
Настройки по умолчанию
-
-
Общие элементы
-
Последовательная шина
-
Устройства
-
-
Программируемые логические контроллеры
-
Modbus
-
OPC
-
Контроллеры
-
-
Развёртывание
-
Компьютеры
-
Устройства
-
-
Связи
-
Ссылки
-
-
Сервер истории
-
Сети BACnet
-
Карты адресов
-
Коммуникационные модули
-
Настройки по умолчанию
-
-
Сети CANopen
-
Карты адресов
-
Коммуникационные модули
-
Настройки по умолчанию
-
-
Сети EtherNet/IP
-
Карты адресов
-
Коммуникационные модули
-
Настройки по умолчанию
-
-
Сети Ethernet
-
Сети KNX
-
Карты адресов
-
Коммуникационные модули
-
Настройки по умолчанию
-
Устройства
-
-
Сети Link
-
Link
-
Карты адресов
-
-
Сети MDLC
-
Карты адресов
-
Коммуникационные модули
-
Настройки по умолчанию
-
-
Сети MQTT
-
Карты адресов
-
Коммуникационные модули
-
-
Сети Modbus
-
Modbus
-
Карты адресов
-
-
Сети NFL
-
Карты адресов
-
Коммуникационные модули
-
-
Сети OPC
-
OPC
-
Карты адресов
-
-
Сети SMTP
-
Карты адресов
-
Служебные модули
-
-
Сети SNMP
-
Карты адресов
-
-
Сети SQL
-
Карты адресов
-
Коммуникационные модули
-
-
Сети Syslog
-
Карты адресов
-
Служебные модули
-
-
Сети МЭК 60870-5
-
Карты адресов
-
МЭК 60870-5
-
-
Сети МЭК 61850
-
Карты адресов
-
Устройства
-
-
ТПТС-НТ
-
Инконтрол
-
Контроллеры
-
-
Теплосчетчики ТЭМ
-
Карты адресов
-
Коммуникационные модули
-
Устройства
-
-
Уровень управления
-
Вычисления
-
-
Файловый обмен
-
Физический уровень
-
Элементы HMI
-
Элементы сервера
-
Карты адресов
-
Коммуникационные модули
-
Коммуникационные модули\Link
-
Коммуникационные модули\Modbus
-
Коммуникационные модули\OPC
-
Коммуникационные модули\МЭК 60870-5
-
Настройки по умолчанию
-
Служебные модули
-
-
-
Атрибуты
-
Om.BACnet
-
Om.CANopen
-
Om.EtherNetIP
-
Om.GenericDevices
-
Om.HMI
-
Om.Hydroslope
-
Om.IEC60870
-
Om.KNX
-
Om.MDLC
-
Om.MQTT
-
Om.OPC
-
Om.PLC
-
Om.Server
-
Om.System
-
-
-
Alpha.Security 1.7 (ред. 18)
-
LDAP-сервер и его настройка
-
Редактирование конфигурации на LDAP-сервере с помощью SecurityConfigurator
-
Приложения
-
Alpha.Om 1.4 (ред. 6. Предварительная)
-
Функции
-
Математические функции
-
Строковые функции
-
Функции обработки времени
-
Функции типа variant
-
-
Приложения
-
Alpha.HMI 2.0 (ред. 31. Предварительная)
-
Руководство пользователя
-
О продукте
-
Основные этапы работы с проектом
-
Запуск дизайнера
-
Запуск на исполнение
-
-
Разработка мнемосхем
-
Экранные формы
-
Компоненты
-
Графические примитивы
-
Готовые компоненты
-
-
Действия с объектами и экранными формами
-
Просмотр характеристик
-
Свойства объектов
-
Свойства в рантайме
-
Обработчики событий
-
Функции объектов
-
-
Заливка градиентом
-
Демонстрационный проект Резервуарный парк
-
-
Источники данных
-
OPC DA
-
TCP
-
Получение событий
-
-
Взаимодействие с окружением проекта
-
Приложения
-
Справочное руководство
-
Компоненты для работы с данными
-
Источник OPC
-
Элемент OPC
-
Источник AP
-
Элемент AP
-
Учетные данные АР
-
Браузер источника АР
-
Запрос алармов
-
Менеджер алармов
-
Запрос значений элемента AP
-
Запрос значений множества сигналов АР
-
Запрос значений сигналов АР
-
Очередь активных алармов
-
-
Компоненты окружения
-
Окружение: архиватор
-
Окружение: группа окон
-
Окружение: окно
-
Окружение: сеть
-
Окружение: файлы
-
Окружение: ошибка работы с файлами
-
Окружение: система
-
Окружение: запрос системного журнала
-
Окружение: браузер файлов
-
Окружение: процесс
-
Окружение: этот процесс
-
Окружение: переменные среды процесса
-
Текстовый файл
-
Оборудование: клавиатура
-
Оборудование: монитор
-
Снимок экрана
-
-
Компоненты для предоставления сервисных функций
-
Статистика: браузер
-
Статистика: JSON-браузер
-
Статистика: узел
-
Статистика: источник данных
-
-
Данные: агрегатор
-
Компоненты печати
-
Печать
-
Принтер
-
Системные принтеры
-
Размеры страницы
-
-
Компоненты для выполнения SQL-запросов
-
Источник SQL
-
Запрос источника SQL
-
Запрос SQL
-
-
Компоненты разметки
-
Линейная разметка
-
Плоская разметка
-
Вес элемента разметки
-
Ограничение размеров элемента разметки
-
Сворачивание элемента разметки
-
Выравнивание элемента разметки
-
Отступы элемента разметки
-
-
Графические компоненты
-
Линейный градиент
-
Радиальный градиент
-
Соединительная линия
-
Место соединения
-
Линия
-
Кривая линия
-
Прямоугольник
-
Эллипс
-
Изображение
-
Точка трансформации
-
-
Компоненты для построения пользовательского интерфейса
-
Индикатор гистограммы
-
Всплывающая подсказка
-
Уведомление
-
Перемещение
-
Кнопка
-
Курсор
-
Глобальный курсор
-
Полоса прокрутки
-
Панель вкладок
-
Системная кнопка
-
Флажок
-
Текст
-
Расширенный текст
-
Поле ввода
-
Редактор текста
-
Индикатор прогресса
-
Ползунок
-
Выпадающий список
-
Фрейм
-
-
Встраиваемые компоненты
-
Alpha.Alarms
-
Свойства
-
Функции
-
События
-
-
Alpha.Trends
-
Свойства
-
Функции
-
События
-
-
-
Компоненты для проверки ввода и преобразования форматов
-
Входной формат
-
Выходной формат
-
Формат булевского значения
-
Формат даты/времени
-
Формат числа с плавающей запятой
-
Проверка ввода
-
Проверка ввода целого числа
-
Проверка ввода беззнакового целого числа
-
Проверка ввода числа с плавающей запятой
-
Проверка ввода регулярного выражения
-
-
Компоненты периодичного выполнения
-
Таймер
-
Мигание
-
Команда
-
Звук
-
Инициализатор
-
Сессия
-
-
Буфер обмена
-
Веб содержимое
-
Компоненты для работы с графиками
-
График: данные
-
График: декоратор линии
-
График: линия
-
График: ось
-
График: поле графика
-
График: реперная линия
-
График: точка пересечения
-
График: экспорт
-
-
Компоненты для формирования древовидной структуры
-
Дерево
-
Источник данных дерева
-
Колонка дерева
-
-
Экранные формы
-
Средство отладки
-
Менеджер проекта
-
Среда исполнения
-
-
Alpha.HMI.WebViewer 2.0 (ред. 31. Предварительная)
-
О продукте
-
-
Alpha.HMI - дополнительные модули
-
Alpha.HMI.Security 2.0 (ред. 15)
-
Руководство пользователя
-
Справочное руководство
-
Контекст безопасности (SecurityContext)
-
Список пользователей (UserList)
-
Настройка безопасности: Контроль целостности (SecurityIntegrityControl)
-
Числовой элемент безопасности (NumericTokenProxy)
-
Строковый элемент безопасности (StringTokenProxy)
-
Булевский элемент безопасности (BoolTokenProxy)
-
Настройка безопасности: Менеджер (SecurityManager)
-
Настройка безопасности: Приложение (SecurityManagerApplication)
-
Настройка безопасности: Пользователь (SecurityManagerUser)
-
Настройка безопасности: Группа (SecurityManagerGroup)
-
Мастер конфигурирования Security (Configurator)
-
Информация лицензирования: Получение (LicenseInfo)
-
-
-
Alpha.HMI.Tables 2.1 (ред. 1)
-
Построение таблицы модели данных
-
Справочник API
-
Таблицы
-
Таблица
-
Свойства
-
Функции
-
События
-
-
Таблица: декоратор
-
Свойства
-
-
Таблица: итератор
-
Свойства
-
Функции
-
-
Таблица: модель данных
-
Свойства
-
Функции
-
События
-
-
Таблица: столбец
-
Свойства
-
Функции
-
События
-
-
Таблица: устойчивый итератор
-
Функции
-
-
-
-
-
Alpha.HMI - библиотеки
-
Alpha.HMI.CommonLib 3.0 (ред. 2)
-
Руководство пользователя
-
Примеры использования компонентов расширения
-
Справочное руководство
-
Типы
-
Тема оформления
-
Конвертер значений
-
Утилиты для работы со строками
-
Утилиты для работы с окном
-
Утилиты для работы с файлами
-
Информация о продукте
-
Буфер аргументов события
-
Обработчик события
-
Пользовательская команда
-
Текстовые шаблоны
-
Редакторы
-
Редактор целого числа
-
Редактор даты
-
Редактор времени
-
Редактор интервала времени
-
Горизонтальный сплиттер
-
Вертикальный сплиттер
-
Рамка с ошибкой
-
Редактор даты и времени
-
-
Меню
-
Элемент меню
-
Результат выбора меню
-
-
Панель инструментов
-
Кнопка панели инструментов
-
Кнопка выпадающего списка
-
Разделитель панели инструментов
-
Панель поиска
-
Тема оформления панели инструментов
-
-
Строка статуса
-
Кнопка авторизации
-
Кнопка-индикатор журнала сообщений
-
Индикатор подключения к серверу
-
Кнопка вызова экранной клавиатуры
-
Параметры вызова экранной клавиатуры
-
-
Диалоги
-
Результат выбора папки
-
Результат выбора цвета
-
Результат выбора параметров подключения
-
Результат выбора даты и времени
-
Результат ввода значения
-
Результат редактирования колонтитула
-
Результат выбора файла
-
Результат диалога авторизации
-
Список файлов
-
Дерево сигналов
-
Журнал сообщений
-
Редактируемая таблица
-
Редактор ячейки таблицы
-
-
Экранные формы
-
Меню
-
Календарь
-
Сообщение
-
Диалог ввода значения
-
Диалог выбора цвета
-
Диалог подключения к серверу
-
Редактор колонтитула
-
Файлы
-
Диалог открытия файла
-
Диалог сохранения файла
-
Диалог выбора папки
-
-
Безопасность
-
Диалог авторизации пользователя
-
Диалог смены пароля
-
Диалог ввода учетных данных
-
-
Общие свойства компонентов библиотеки
-
-
-
-
Alpha.HMI - приложения
-
Alpha.HMI.AdminConsole 1.0 (ред. 3)
-
Руководство пользователя
-
Справочное руководство
-
Консоль администрирования
-
Инструментальная панель
-
Разрешения
-
AdminConsole_Page
-
-
-
Alpha.HMI.Alarms 3.3 (ред. 1. Предварительная)
-
Руководство пользователя
-
Встраивание в проект
-
Привлечение внимания к важным событиям
-
Квитирование событий
-
Экспорт сообщений в файл
-
Справочное руководство
-
Alarms
-
Свойства
-
Функции
-
-
Alarms_Table
-
Свойства
-
Функции
-
-
Alarms_Sounds
-
Свойства
-
Функции
-
-
EventStatistics
-
Свойства
-
-
Разрешения пользователя
-
Свойства
-
Функции
-
-
-
-
Alpha.HMI.ComtradeViewer 1.1 (ред. 1)
-
Встраивание в проект
-
API
-
ComtradeViewer
-
Свойства
-
Функции
-
-
Разрешения (ComtradeViewer_Permissions)
-
Свойства
-
-
-
Alpha.HMI.Explorer 4.0 (ред. 2)
-
Руководство пользователя
-
Справочное руководство
-
Explorer_Form
-
-
Alpha.HMI.IntegrityControl 2.8 (ред. 1)
-
Руководство пользователя
-
Контроль целостности
-
Справочное руководство
-
IntegrityControl
-
IntegrityConfiguration
-
Разрешения
-
Настройки
-
IntegrityControl_KTN
-
IntegrityControl_Form
-
IntegrityConfiguration_Form
-
-
-
Alpha.HMI.SecurityConfigurator 4.0 (ред. 1)
-
Руководство пользователя
-
Редактирование конфигурации
-
Приложения
-
Справочное руководство
-
SecurityConfigurator
-
Настройки
-
Разрешения
-
SecurityConfigurator_Page
-
SecurityConfigurator_Form
-
-
-
Alpha.HMI.SetPoints 2.5 (ред. 2)
-
Руководство пользователя
-
Приложения
-
Справочное руководство
-
SetPoints
-
SetPoints_Settings
-
Разрешения
-
Тема оформления Уставок
-
SetPoints_Page
-
SetPoints_Form
-
-
-
Alpha.HMI.Statistics 1.2 (ред. 1)
-
Руководство пользователя
-
Справочное руководство
-
Statistics
-
Разрешения
-
Настройки
-
Statistics_Form
-
-
-
Alpha.HMI.SystemLogViewer 2.0 (ред. 1)
-
Руководство пользователя
-
Справочное руководство
-
SystemLogViewer
-
Разрешения
-
Тема оформления Журнала событий
-
SystemLogViewer_Form
-
-
-
Alpha.HMI.Trends 2.4 (ред. 1. Предварительная)
-
Руководство пользователя
-
Встраивание в проект
-
Сохранение и загрузка данных
-
Справочное руководство
-
Свойства
-
Функции
-
-
-
-
Alpha.Alarms 3.30 (ред. 1)
-
Варианты запуска
-
Начало работы
-
Аспекты безопасности
-
Просмотр оперативных событий
-
Подавление и блокирование событий источника/объекта
-
Аналитика событий
-
Фильтрация сообщений о событиях
-
Дополнительные возможности
-
Работа со встраиваемым компонентом
-
Alarms-API
-
Свойства
-
Функции
-
События
-
-
-
Alpha.Trends 3.33 (ред. 3. Предварительная)
-
Начало работы
-
Просмотр значений сигналов
-
Аналитика графиков
-
Использование реперных линий
-
Вертикальные реперы
-
-
Вспомогательные функции
-
Работа со встраиваемым компонентом Alpha.Trends
-
Свойства
-
Функции
-
События
-
-
Alpha.Tools 1.6 (ред. 8)
-
EventLogViewer
-
Приложения
-
OpcExplorer
-
Настройка и подключение к источнику данных
-
Просмотр адресного пространства
-
Приложения
-
-
Alpha.RMap 1.7 (ред. 2)
-
Приложения
-
Установка и настройка
-
-
Alpha.Diagnostics 2.2
-
Alpha.AuditReport
-
Настройка Alpha.AuditReport
-
Alpha.SystemMonitor
-
Интерфейс
-
Настройка
-
Alpha.Hashcheck
-
Настройка конфигурации
-
Alpha.NTPClient
-
Alpha.Utilities
-
Приложения
-
Alpha.Reports 1.1 (ред. 18)
-
Руководство администратора
-
Приложения
-
Конфигуратор
-
Конструктор отчётов
-
Описание интерфейса и функций программы
-
Приложения
-
Поддерживаемые функции
-
Текстовые
-
Числовые
-
Математические
-
Информационные
-
Логические
-
Поиск и ссылки
-
Дата и время
-
База данных
-
Финансовые
-
-
-
Библиотека
-
Функции библиотеки
-
Приложения
-
Просмотр отчётов
-
-
Alpha.SmartControl 9.3 (ред. 1)
-
Администрирование
-
Отчеты
-
Бланки переключений
-
Специальные возможности
Получение данных из БД SQL
Для выполнения SQL-запросов используйте набор компонентов из юнита SQL:
- Источник SQL — управляет подключением к базе данных: устанавливает и разрывает соединение.
- Запрос источника SQL — выполняет SQL-запросы к базе данных.
Компоненты Источник SQL и Запрос источника SQL работают через ODBC-драйверы и совместимы с популярными системами управления базами данных (СУБД):
- PostgreSQL
- MySQL
- Microsoft SQL Server
- Oracle Database
- Другие СУБД с поддержкой ODBC
Результаты SQL-запросов могут быть представлены в проекте только в виде таблицы, так как таблицы являются основным способом организации и хранения данных в SQL базах данных. Чтобы отобразить результаты SQL-запросов, подключите компонент Запрос источника SQL к компоненту Таблица. Подробный пример настройки подключения и выполнения запросов рассмотрен ниже.
Как запросить данные из БД (на примере PostgreSQL)
В этом разделе рассмотрен демонстрационный проект (
В проекте показано как:
-
Настроить источник подключения к базе данных.
- Подготовить таблицу для вывода результатов SQL-запросов.
- Выводить информацию в текстовое поле о количестве затронутых изменениями строк в базе данных.
-
Выполнить SQL-запрос из редактора текста по нажатию кнопки и отобразить результаты в таблице.
-
Разорвать соединение с базой данных после завершения всех операций с ней.
В результате будет подготовлена форма, позволяющая подключаться к базе данных, выполнять SQL-запросы и отображать полученные данные.
Настройка подключения к базе данных
- Добавьте на экранную форму компонент Источник SQL.
- В свойстве Строка подключения укажите параметры подключения к вашей базе данных. Можно использовать один из следующих форматов:
Через системный источник данных ODBC (DSN):
DSN — это предопределённый набор настроек подключения, сохранённый в системе, который можно использовать вместо явного указания всех параметров в строке подключения.
DSN=ИмяВашегоDSN
Явная строка подключения (без DSN):
Driver={PostgreSQL};
Server=localhost;
Port=5434;
Database=postgres;
Uid=postgres;
Pwd=password
-
В свойстве Состояние соединения с БД укажите объект Состояние соединения SQL для отслеживания состояния подключения. Для этого дважды щелкните левой кнопкой мыши по свойству.
Подготовка таблицы для отображения результатов
-
Добавьте на экранную форму компонент Таблица, который будет отображать результаты запроса.
-
Добавьте компонент Таблица: модель данных дочерним компоненту Таблица.
-
Укажите ссылку на добавленный компонент Таблица: модель данных. Для этого нажмите правой кнопкой мыши по свойству Модель данных → Сослаться → TableModel_1.
-
Добавьте компонент Запрос источника SQL дочерним компоненту Таблица: модель данных. В свойстве Источник SQL укажите ссылку на добавленный ранее Источник SQL. Для этого нажмите правой кнопкой мыши по свойству Источник SQL → Сослаться → SqlSource_1.
-
Добавьте к компоненту Таблица дочерние компоненты Таблица: столбец. Вы можете настроить отображение в таблице на форме всех столбцов из базы данных либо только отдельных столбцов. Для каждого объекта Таблица: столбец укажите идентификатор столбца в свойстве Идентификатор, который соответствует идентификатору (имени) столбцов в базе данных.
Установка соединения с базой данных
- Добавьте на экранную форму компонент Кнопка, при нажатии на которую будет устанавливаться соединение с базой данных.
-
Добавьте на экранную форму компонент Текст, в который будет выводиться статус подключения (успех или ошибка).
-
Настройте обработчик ButtonPressed для кнопки:
// Установить соединение с базой данных
SqlSource_1.Connect(); -
Для отслеживания состояния подключения настройте обработчик события OnConnectionStateChanged у компонента Источник SQL:
// Проверяем код состояния (0 - не подключено, 1 - подключение, 2 - подключено, 3 - отключение) if (state.Code == 2) { // Соединение успешно установлено Text_1.Text = "Соединение установлено\n"; } else if (state.Code == 0) { // Соединение не установлено Text_1.Text = "Соединение не установлено\n"; }
Выполнение SQL-запроса
-
Добавьте на экранную форму два компонента:
-
Редактор текста — в него будет вводиться текст SQL-запроса.
-
Кнопка — при нажатии на неё будет выполняться запрос и обновляться таблица.
-
-
Настройте обработчик ButtonPressed у кнопки:
// Проверка состояния соединения (2 - Connected) if (SqlSource_1.ConnectionState.Code == 2) { // Получаем текст запроса из текстового поля sqlQuery: var = TextEdit_1.Text; // Выполнить SQL запрос напрямую Table_1.TableModel_1.SqlSourceQuery_1.ExecuteDirectly(sqlQuery); // Заполнить таблицу полученными данными из БД Table_1.TableModel_1.BeginReadAsync(); } else { Text_1.Text = "Ошибка: соединение не установлено\n"; }После запуска в рантайме введите SQL-запрос в редактор текста и нажмите кнопку для его выполнения. Результаты запроса отобразятся в таблице.
Пример SQL-запроса:
SELECT user_id, product_name, price, status FROM orders
Отображение статуса операций
Чтобы в процессе выполнения SQL-запросов к базе данных получать информацию о результатах операций, подготовьте текстовое поле и настройте событие OnRequestStatusChanged компонента Запрос источника SQL. Пример кода JavaScript:
// Проверяем, что запрос завершён (код статуса 4 - Finished)
if (requestStatusCode == 4) {
// Парсим JSON стандартной функцией JavaScript
var statusData = JSON.parse(requestStatusData);
// Получаем код результата (0 - успех, 1 - успех с предупреждениями, 2 - ошибка)
var resultCode = statusData.result_code;
if (resultCode == 0) {
// Успешное выполнение
var rowCount = statusData.result_description.row_count;
Text_2.Text = "Успех: обработано строк - " + rowCount + "\n";
} else if (resultCode == 1) {
// Выполнено с предупреждениями
Text_2.Text = "Выполнено с предупреждениями\n";
} else {
// Ошибка выполнения
Text_2.Text = "Ошибка выполнения запроса\n";
}
}
Этот код обрабатывает событие завершения запроса и выводит информацию о результате выполнения. Параметр requestStatusCode содержит код статуса (4 означает завершение операции), а requestStatusData содержит детальную информацию в формате JSON.
Разрыв соединения с базой данных
После завершения всех операций с базой данных рекомендуется разрывать соединение с ней. Это действие позволяет эффективно освободить системные ресурсы и избежать потенциальных утечек памяти.
Добавьте на экранную форму компонент Кнопка, при нажатии на которую будет разрываться соединение с базой данных. В обработчике ButtonPressed добавьте следующий код:
// Разорвать соединение с базой данных
SqlSource_1.Disconnect();
Этот код вызывает метод Disconnect() у экземпляра Источник SQL, который разрывает соединение.
Примеры выполнения запросов к базе данных
Ниже рассмотрены несколько примеров выполнения базовых SQL-запросов для вставки, изменения, чтения и удаления данных из БД.
Для избежания возможных проблем, связанных с дублированием идентификаторов столбцов в результирующей выборке SQL-запроса, рекомендуется использовать уникальные идентификаторы столбцов при их выборе. Если в SQL-запросе присутствуют операции объединения таблиц или другие ситуации, когда имена столбцов могут дублироваться, то рекомендуется использовать SQL псевдонимы (временные имена) для столбцов, чтобы обеспечить уникальность идентификаторов.
Пример правильного использования SQL псевдонимов:
Вместо:
SELECT * FROM nodes_history h JOIN nodes n ON n.NodeId=h.NodeId WHERE n.TagName ='Test.Parameter' AND
(h.time BETWEEN '2023-03-02 07:39:00' AND '2023-03-02 07:39:01')
Рекомендуется:
SELECT n.nodeid, h.valint, h.quality, h.actualtime FROM nodes_history h JOIN nodes n ON
n.NodeId=h.NodeId WHERE n.TagName ='Test.Parameter' AND
(h.time BETWEEN '2023-03-02 07:39:00' AND '2023-03-02 07:39:01')
Перед выполнением приведённых ниже примеров убедитесь, что соединение с базой данных уже установлено методом:
SqlSource_1.Connect();
Не вызывайте Connect() и Disconnect() для каждого запроса.
Повторные вызовы Connect() закрывают текущее соединение и открывают новое, что приводит к потере контекста временных таблиц и может вызвать ошибки выполнения операций.
Соединение рекомендуется устанавливать один раз в начале работы с базой данных и закрывать его только по завершении всех операций, вызвав:
SqlSource_1.Disconnect();
Как добавить данные в БД (INSERT)
В этом примере добавляется новая запись в таблицу testtables для столбцов Id, Value, Category, Text с указанными значениями.
Добавить в таблицу testtables новую запись для столбцов Id = 1, Value = 6, Category = Even, Text = Six
// Добавляет запись в таблицу testtables
if (SqlSource_1.ConnectionState.Code == 2) {
Table_1.TableModel_1.SqlSourceQuery_1.ExecuteDirectly(
"INSERT INTO testtables (Id, Value, Category, Text) VALUES (1, 6, 'Even', 'Six')"
);
// Заполнить таблицу данными, полученными из БД
Table_1.TableModel_1.BeginReadAsync();
} else {
Text_1.Text = "Ошибка: соединение не установлено";
}
Как обновить данные в БД (UPDATE)
В этом примере обновляется значение столбца Value в строке, где значение столбца Id равно 2.
Обновить в таблице testtables значение столбца Value на 343, где Id = 2.
// Проверка состояния соединения с БД (2 - подключено)
if (SqlSource_1.ConnectionState.Code == 2) {
// Выполнить запрос UPDATE
Table_1.TableModel_1.SqlSourceQuery_1.ExecuteDirectly(
"UPDATE testtables SET Value = 343 WHERE Id = 2"
);
// Заполнить таблицу данными, полученными из БД
Table_1.TableModel_1.BeginReadAsync();
} else {
Text_1.Text = "Ошибка: соединение не установлено";
}
Как получить данные из БД (SELECT)
В этом примере получены все данные из таблицы testtables.
Получить значения всех столбцов таблицы testtables.
// Проверка состояния соединения с БД (2 - подключено)
if (SqlSource_1.ConnectionState.Code == 2) {
// Выполнить запрос SELECT
Table_1.TableModel_1.SqlSourceQuery_1.ExecuteDirectly(
"SELECT * FROM testtables"
);
// Заполнить таблицу данными, полученными из БД
Table_1.TableModel_1.BeginReadAsync();
} else {
Text_1.Text = "Ошибка: соединение не установлено";
}
В этом примере получены только записи, где Category = 'Even'.
Получить только записи, где Category = 'Even'
// Проверка состояния соединения с БД (2 - подключено)
if (SqlSource_1.ConnectionState.Code == 2) {
Table_1.TableModel_1.SqlSourceQuery_1.ExecuteDirectly(
"SELECT * FROM testtables WHERE Category = 'Even'"
);
// Заполнить таблицу данными, полученными из БД
Table_1.TableModel_1.BeginReadAsync();
} else {
Text_1.Text = "Ошибка: соединение не установлено";
}
Как удалить данные из БД (DELETE)
В этом примере удаляются все строки из таблицы testtables, где значение столбца Category равно Even.
Удалить все строки из таблицы testtables, где значение столбца Category равно Even.
// Проверка состояния соединения с БД (2 - подключено)
if (SqlSource_1.ConnectionState.Code == 2) {
// Выполнить запрос DELETE
Table_1.TableModel_1.SqlSourceQuery_1.ExecuteDirectly(
"DELETE FROM testtables WHERE Category = 'Even'"
);
// Заполнить таблицу данными, полученными из БД
Table_1.TableModel_1.BeginReadAsync();
} else {
Text_1.Text = "Ошибка: соединение не установлено";
}
Команда DELETE без условия WHERE удалит все строки из таблицы. Всегда проверяйте условия перед выполнением.
Это всего лишь несколько примеров сценариев работы с компонентами Источник SQL и Запрос источника SQL. Вы можете создавать более сложные запросы, использовать условия, соединять таблицы, применять агрегатные функции и многое другое в зависимости от ваших потребностей.
Настройка переменных окружения для взаимодействия с SQL базой данных на Linux
При взаимодействии с SQL базой данных через Alpha.HMI на операционных системах семейства Linux необходимо предварительно настроить переменные окружения ODBCSYSINI и LD_LIBRARY_PATH. Эти переменные окружения необходимы для того, чтобы система знала, где искать конфигурационные файлы для корректной работы с SQL базой данных через ODBC (интерфейс между базой данных и приложением, взаимодействующим с ней).
Самый распространенный способ настройки переменных окружения на Linux- это добавить переменные в системный файл .bashrc. Для этого:
-
Откройте файл .bashrc для редактирования в текстовом редакторе (например, nano).
nano ~/.bashrc -
Добавьте в файл следующие строки:
# Эта строка устанавливает переменную ODBCSYSINI в значение "/etc"
export ODBCSYSINI="/etc"
# Эта строка устанавливает переменную LD_LIBRARY_PATH в значение "/usr/lib/x86_64-linux-gnu/odbc"
export LD_LIBRARY_PATH="/usr/lib/x86_64-linux-gnu/odbc" - Сохраните файл, нажав Ctrl + X, затем Y, затем Enter.
-
Обновите текущий сеанс оболочки, чтобы изменения вступили в силу:
source ~/.bashrc