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), последующие значения столбца считываться не будут. В этом случае запрос выдаёт ошибку, которая отображается в журнале приложений.

	Текст запроса может строиться динамически. Для этого он должен иметь неизвестные параметры, отмеченные знаками "?".