4.1.1.2.5.6.3. Добавление базы данных
Для того, чтобы добавить базу данных для обмена данными, необходимо:
1. В исполняемом приложении добавьте модуль "База данных SQL"
2. В модуле SQL Connector нажмите на кнопку "Добавить базы данных SQL..."
3. В открывшемся окне выберите необходимые базы данных для подключения
4. Заполните параметры взаимодействия с базой данных, которые описаны в таблице ниже:
Параметр
|
Описание
|
База данных SQL
|
Идентификатор источника
|
Поставщик данных
|
Интерфейс доступа к данным:
OLE DB
ODBC
|
Строка подключения
|
Параметры подключения к источнику. Значение по умолчанию: Provider=SQLOLEDB; Data Source=ServerName; Initial Catalog=DatabaseName; User ID=UserID; Password=password;
|
Пароль
|
Пароль пользователя из строки подключения
|
Параметры строки подключения
Параметр
|
Описание
|
Provider
|
Имя провайдера для работы с источником. Определение значения параметра описано ниже
|
Data Source
|
Имя источника
|
Initial Catalog
|
Имя базы данных в составе источника
|
User ID
|
Логин пользователя
|
Password
|
Пароль для подключения к базе данных
|
Соединение с SQL Server 2008 R2
Имеется локальный экземпляр сервера SQLEXPRESS, в его составе есть база mydb. Подключение проходит по логину test_user и паролю qwerty123.
Строка подключения к подобному источнику с помощью модуля SQL Connector показана ниже:
Provider=SQLOLEDB; Data Source=localhost\SQLEXPRESS; Initial Catalog=mydb; User ID=test_user; Password=qwerty123;
|
Соединение с MySQL
Есть локальная база MySQL, подключение к которой сконфигурировано через инструмент Администратор источников данных ODBC (Панель управления → Администрирование → Источники данных ODBC), как показано на рисунках ниже.
Строка подключения к подобному источнику с помощью модуля SQL Connector показана ниже.
Provider=MSDASQL.1; Data Source=MyDSN;
|
Соединение с Oracle XE
Есть локальная база Oracle XE со стандартным пользователем system (пароль qwerty123). Чтобы протестировать подключение к базе сконфигурируйте подключение через инструмент Администратор источников данных ODBC (Панель управления → Администрирование → Источники данных ODBC), как показано на рисунках ниже.
Строка подключения к подобному источнику с помощью модуля SQL Connector показана ниже.
Provider=OraOLEDB.Oracle.1; Data Source=XE; User ID=system; Password=qwerty123;
|
Определение значения параметра Provider для строки подключения
Чтобы определить значение параметра Provider для сроки подключения SQL Connector выполните следующие действия:
1. Создайте новый текстовый файл и переименуйте его в MyUdl.udl.
2. Запустите файл MyUdl.udl.
3. На вкладке Поставщик данных выберите нужного провайдера.
4. На вкладке Соединение укажите Источник данных, Пользователя и Пароль. Затем протестируйте соединение.
5. Если соединение прошло успешно, то закройте файл MyUdl.udl, переименуйте его в файл MyUdl.txt и откройте в текстовом редакторе.
В сформированной строке будет присутствовать значение параметра Provider, которое можно применять в строке подключения для модуля SQL Connector.
Provider=OraOLEDB.Oracle.1; User ID=system; Data Source=XE;
|
При возникновении трудностей с подключением к источникам данных обратитесь к журналу работы модуля, который можно просмотреть через сервисное приложение Просмотрщик лога кадров.
Настройка запросов к источникам данных
Модуль SQL Connector посылает SQL-запросы к источнику данных. Запросы добавляются в ветку модуля Список запросов.
Каждый запрос имеет уникальный Идентификатор, основные параметры и значения по умолчанию.
Основные параметры
Параметр
|
Описание
|
Текст запроса
|
Инструкция типа SELECT для выборки данных из источника, инструкции типа UPDATE, INSERT для модификации данных в источнике или инструкции вызова хранимых процедур (EXECUTE или CALL)
|
Имя ключевого поля
|
Имя столбца таблицы, по которому будет организована дополнительная фильтрация выбранных данных
|
Период исполнения запроса
|
Интервал в миллисекундах, с которым будет выполняться SQL-запрос. Если указан «0», то запрос будет выполняться только по отдельной команде
|
Возможность результатов запроса быть пустым
|
Если установлено значение Да, то сигналы не будут менять качества даже при пустых результатах запроса
|
Часовой пояс
|
Параметр указывает, в каком часовом поясе UTC хранятся метки времени в базе данных. Все метки времени, отправляемые в базу данных (запросами типа UPDATE, INSERT), будут скорректированы к указанному часовому поясу. Все метки времени, полученные из базы данных (запросами типа SELECT), будут скорректированы к UTC
|
Значения по умолчанию
Параметр
|
Описание
|
Качество при неполном значении
|
Значение качества, устанавливаемое в случае если результатом запроса является пустое значение (NULL). По умолчанию устанавливается значение качества 64 (Uncertain)
|
Значения по умолчанию
|
Значения столбцов, устанавливаемые в случае если результатом запроса является пустое значение (NULL)
|
Если параметр Значения по умолчанию не задан и при чтении значений столбца встречается пустое значение (NULL), последующие значения столбца считываться не будут. В этом случае запрос выдаёт ошибку, которая отображается в журнале приложений.
|
Текст запроса может строиться динамически. Для этого он должен иметь неизвестные параметры, отмеченные знаками "?".
|