Модуль Запись в базу данных через ODBC для программ-логгеров

Последняя версия: 5.0.1 build 1126. November 28, 2025.

Модуль ODBC database обеспечивает экспорт разобранных данных в любую базу данных, совместимую с ODBC. Он выполняет операции INSERT и при необходимости UPDATE без необходимости писать SQL, используя только настройку с помощью диалогов. Процесс конфигурации включает выбор базы данных, атрибуты соединения, обработку ошибок и сопоставление полей. Список поддерживаемые баз данных включает как минимум MS SQL Server, Oracle, PostgreSQL, MySQL, Interbase, Microsoft Access, Excel и CSV файлы, представляемые как ODBC-источники данных.

Скачать  | PDF руководство

Что делает модуль

Модуль принимает переменные парсера и записывает их в столбцы таблицы. При необходимости он преобразует значения между схожими типами данных (например, строку в дату или целое число в число с плавающей точкой) или подставляет значения по умолчанию, если переменная парсера отсутствует или равна null. В диалоговом окне конфигурации доступны выбор источника данных ODBC, указание атрибутов соединения, логин и пароль, а также параметры драйвера, например "SERVER PORT=3306" для MySQL.

Практические примеры

Пример: Простая запись в таблицу MS SQL: парсер формирует переменные DATE_TIME_STAMP, TEMPERATURE и DEVICE_ID. Модуль автоматически выполняет INSERT при поступлении нового пакета данных.

Настройка и соединение

Откройте конфигурацию модуля: Опции → Настройка → Модули → ODBC database → Настроить. Создайте или выберите DSN: "Системный DSN" для режима службы или для всех пользователей, либо "Пользовательский DSN" для подключений одного пользователя. Для добавления или проверки соединения используйте ODBC Data Source Administrator.

Создание таблицы и привязка колонок

Спроектируйте нужную таблицу в соответствии с правилами ANSI SQL92: используйте латинские буквы, цифры и символ подчеркивания в именах столбцов. Избегайте зарезервированных слов SQL, если они не заключены в кавычки. Большинство СУБД предоставляет бесплатные визуальные инструменты для создания таблиц. Тогда можно импортировать существующую структуру таблицы с помощью кнопки "Импортировать" или добавить все столбцы вручную. После импорта сопоставьте (привяжите) каждый столбец к переменной парсера, установите тип данных столбца или задайте значение по умолчанию.

Подробнее о процессе привязки

1. Нажмите "Импортировать". Модуль покажет доступные таблицы для выбранного источника данных.
2. Выберите таблицу и нажмите ОК - импорт добавит столбцы в дерево настроек.
3. Свяжите переменные парсера (например, DATE_TIME_STAMP) со столбцами и проверьте тип данных.
4. Сохраните и протестируйте соединение с базой, получив тестовые данные с вашего устройства или источника данных.
5. Модуль попытается выполнить INSERT сразу и сообщит об ошибке в главном окне с подробным описанием.

Пример интеграции с Advanced Serial Data Logger (ASDL)

Сценарий: ASDL получает пакеты через последовательный порт от счетчика и извлекает переменные DATE_TIME_STAMP, METER_ID и ENERGY_KWH. Настройте модуль ODBC для подключения к системному DSN с именем "EnergyDB". Импортируйте таблицу "energy_logs" со следующими столбцами: recorded_at (DATETIME), meter (VARCHAR(32)), energy (FLOAT). Пример привязки:

Имя переменной парсера → Колонка
DATE_TIME_STAMP → recorded_at (DATETIME)
METER_ID → meter (VARCHAR)
ENERGY_KWH → energy (FLOAT)

Пример входящего пакета:

DATE_TIME_STAMP=2025-01-02 08:00:00
METER_ID=MTR-1002
ENERGY_KWH=42.7

SQL, выполняемый модулем (плагин автоматически формирует команду INSERT внутри себя):

INSERT INTO energy_logs (recorded_at,meter,energy)
VALUES ('2025-01-02 08:00:00','MTR-1002',42.7)

Ключевые возможности

• Конфигурация через диалоги: для базовых INSERT и UDPATE не требуется знать SQL.
• Поддержка любых ODBC-совместимых баз данных: MS SQL, Oracle, PostgreSQL, MySQL, Access, Excel, CSV и другие.
• Автоматическое преобразование типов между переменными парсера и типами столбцов.
• Импорт структуры таблицы и привязка переменных парсера к столбцам с поддержкой значений по умолчанию и обнаружения первичных ключей.
• Настраиваемая обработка ошибок: остановка, уведомление, запись в лог или повторное подключение при сбое.
• Поддержка файловых источников данных ODBC для MS Access, CSV и Excel.
• Возможность задавать собственные атрибуты соединения для точной настройки драйвера базы данных.

Краткое резюме

Модуль ODBC Database позволяет экспортировать разобранные данные в базы данных и файловые базы универсальным способом без написания SQL. Настройте DSN и сопоставьте переменные парсера со столбцами через конфигурацию с помощью диалогов.

Скачать  | PDF руководство