Присоединиться к БД

Элемент осуществляет подключение к базе данных (БД). Установленное соединение обеспечивает возможность передачи запросов и получения ответов между приложением и базой данных.

В сценарии компонент Присоединиться к БД выступает контейнером для других элементов, работающих с БД.

Свойства

Символ * в названии свойства указывает на обязательность заполнения. Описание общих свойств см. в разделе Свойства элемента.

Свойство	Тип	Описание	Пример
База данных:
Строка соединения*	String	Строка соединения с БД. Строку можно сформировать автоматически по кнопке — в этом случае откроется окно мастера (Wizard)	Ole DB: "Provider=SQLOLEDB;Data Source=<servername>;Initial Catalog=<dbname>;Integrated Security=SSPI" PostgreSQL: "Host=<host>;Port=5432;Password=<password>;Username=<username>;Database=<dbname>" ODBC: "DRIVER=<ODBC Driver>; SERVER=<host>; PORT=<port number>;DATABASE=<dbname>; USER=<username>; PASSWORD=<password>"
Тип БД*	LTools.Database.Model.DatabaseTypes	Выберите тип подсоединяемой базы данных. Доступные значения: 1. Ole DB — по умолчанию; 2. Postgre Sql; 3. ODBC	Ole DB
Вывод:
Соединение с БД	LTools.Database.DatabaseInst	Инстанс соединения с БД. Позволяет сохранить активное соединение в переменную, чтобы использовать в других местах сценария для более быстрого подключения или отключения от БД

Окно мастера

🔹 Для ODBC мастер отсутствует.

Свойство Строка соединения имеет кнопку — при ее нажатии появится мастер создания строки соединения. Окно мастера будет отличаться для разных БД — убедитесь, что свойство Тип БД заполнено верно.

Мастер для Ole DB:

Мастер для PostgreSQL:

После заполнения полей мастера и нажатия кнопки OK строка соединения сформируется автоматически и будет записана в соответствующее свойство.

Ниже рассмотрим пример заполнения мастера для PostgreSQL. В свойстве Тип БД указываем Postgre Sql. После чего вызываем мастер и заполняем параметры подключения:

Нажимаем Тест, чтобы убедиться, что подключение настроено успешно. После чего сохраняем настройки.

В свойстве Строка соединения автоматически сформировалось значение из нашего мастера: "Host=localhost;Port=5432;Password=pass;Username=postgres;Database=postgres".

Только код

Пример использования элемента в процессе с типом Только код (Pure code):

LTools.Database.DatabaseApp app = LTools.Database.DatabaseApp.Init(wf, "Provider=SQLOLEDB;Data Source=<servername>;Initial Catalog=<dbname>;Integrated Security=SSPI");

app = LTools.Database.DatabaseApp.Init(wf, "Provider=SQLOLEDB;Data Source=<servername>;Initial Catalog=<dbname>;Integrated Security=SSPI")

var app = _lib.LTools.Database.DatabaseApp.Init(wf, "Provider=SQLOLEDB;Data Source=<servername>;Initial Catalog=<dbname>;Integrated Security=SSPI");