Подключение ODBC

Используется для подключения к одному из источников данных ODBC.

Параметры подключения

При настройке подключения задаются следующие параметры:

• Метка — содержит задаваемое пользователем имя подключения.
• Строка подключения — строка вида DSN | ODBC connection string. Выбирается один из настроенных в системе источников данных или указывается строка подключения в формате установленного в системе драйвера ODBC.

Примечание: В Loginom Desktop может указываться File DSN (файл с настройками подключения).

Список источников вызывается при клике мышью по кнопке . В списке выводятся доступные источники данных ODBC.

• Тестировать — тест указанных настроек подключения.

Примечание: Если опция Спрашивать пароль активна, то при тестировании подключения будет запрошен логин/пароль.

• Логин — логин пользователя БД.
• Пароль — пароль пользователя БД.
• Спрашивать пароль — при установке этого флага, пароль, введенный в мастере настройки, не сохранится. Он будет запрошен единовременно при первой активации Импорта или Экспорта из БД и больше не будет запрашиваться до деактивации узла Подключения. Диалоговое окно ввода логина/пароля имеет тайм-аут 60 секунд.

Примечание: во время работы в Пакетном режиме, а также при запуске пакета из Планировщика задач или через Loginom Integrator при включенной опции Спрашивать пароль, будет выполняться попытка подключения без пароля (логи будут содержать сообщение о том, что пароль не указан).

• Показывать системные таблицы — при установке этого флага в мастере импорта, использующего данное подключение, становятся видимы доступные пользователю системные таблицы БД (необходимо ставить при подключении к файлу Excel).
• Обрамлять имена кавычками — если имена объектов базы данных (например, имена таблиц, полей) содержат пробелы или зарезервированные символы, то необходимо использовать обрамляющие символы, фиксирующие начало и конец имени.
• Не использовать клиент СУБД — для подключений ODBC эта опция не используется.
• Очищать пул при деактивации — очищает пул часто используемых в пакетной обработке и пакетов Loginom Integrator, сохраненных для быстрого вызова, после деактивации узла. По умолчанию этот параметр отключен.
• Тайм-аут подключения (c) — задает предельное время подключения, значение по умолчанию 20 секунд. Если импорт из базы данных или экспорт в базу данных будет выполняться в режиме игнорирования ошибок, то в случае неудавшегося подключения в течение установленного времени, соответствующая ошибка будет записана в выходной порт Статус выполнения узла Импорт из БД/Экспорт в БД, а при импорте/экспорте в обычном режиме — выполнение узла завершится ошибкой. Параметр активен, если поддерживается драйвером.
• Комментарий — в этой форме можно оставить любую справочную информацию о подключении.

Настройка источников данных ODBC для Windows

Настройка источников осуществляется в администраторе источников данных ODBC Windows. Там же содержится информация об установленных в системе драйверах и можно узнать формат строки подключения.

Необходимо учитывать, что источники данных, заданные в разделе «Пользовательский DSN» администратора источников данных ODBC, доступны только создавшим их пользователям. Поэтому эти источники могут быть недоступны пользователю, из-под которого запускается приложение/служба Loginom. Рекомендуется создавать источники данных ODBC в разделе «Системный DSN», поскольку они доступны всем пользователям.

Настройка источников данных ODBC для Linux

В unixODBC для Linux настройка источников данных осуществляется с помощью файлов конфигурации. Для пользовательских DSN используется файл /.odbc.ini, а для системных DSN — /etc/odbc.ini. Для каждого драйвера системы управления базами данных (СУБД) предусмотрен свой набор параметров подключения. Подробные сведения об этих параметрах можно найти в документации соответствующей СУБД.

В unixODBC драйверы ODBC указываются в файле odbcinst.ini, который обычно находится в каталоге /etc/. В разных дистрибутивах Linux расположение файла может отличаться. Например, в Ubuntu файл находится по пути /etc/odbcinst.ini.

Для поиска файла можно воспользоваться командой sudo find / -name odbcinst.ini.

Список драйверов для unixODBC может варьироваться в зависимости от операционной системы и доступных пакетов.

Установка драйвера в Docker Compose

При создании образа необходимо поместить драйвер соответствующей СУБД в папку server/libs. Для этого нужно добавить директиву RUN, которая установит этот драйвер. Например, для операционной системы Ubuntu: RUN apt install -y /app/<имя пакета>.deb.

В файлах odbcinst.ini и odbc.ini следует прописать конфигурацию БД.

Существует два способа проброса конфигурации в контейнер:

• При сборке образа. Драйвер помещается в образ с использованием директивы COPY. Она уже присутствует в Dockerfile и копирует все необходимые библиотеки Loginom.

• При запуске контейнера в Docker Compose на хост-системе клиента добавляется директива volumes, чтобы обеспечить сохранение данных и возможность их обновления без пересборки образа. Директива volumes монтирует файлы или каталоги с хост-машины внутрь контейнера, что дает возможность изменять их прямо на хосте, а изменения моментально отражаются внутри контейнера.

Смотри также:

• Информация в русском разделе википедии
• Сайт с описанием правил и примеров написания строк подключения
• Примеры написания строк подключения к разным источникам данных