Это старая версия документа.
Содержание
database
Модуль выполняет подключение к базе данных и предоставляет к ней доступ другим модулям.
<module id="db2" class="database" enabled="false" driver="PSQL" host="192.168.2.13" port="5432" dbname="petshop" username="denis" password="admin" reconnect_time_sec="5" /> <module id="db3" class="database" enabled="false" driver="FIREBIRD" host="192.168.2.44" port="3050" dbname="/db/fb25/arccntdb5.fdb" username="SYSDBA" password="masterkey" reconnect_time_sec="5" sql_live_check="select 2-1 from rdb$database" />
Параметры
driver
- PSQL
- FIREBIRD
- MSSQL
host
Имя или ip-адрес сервера баз данных. По умолчанию localhost
.
port
Порт подключения к серверу баз данных. По умолчанию:
- PSQL:
5432
- FIREBIRD:
3050
- MSSQL:
1433
Внимание FIREBIRD! Данный параметр игнорируется драйвером. Пока не будет исправлено, пользоваться параметром host
, указывая порт через косую черту. Пример:
host="localhost/3051"
dbname
Имя или алиас базы данных.
username
Имя пользователя.
password
Пароль пользователя.
reconnect_time_sec
Время переподключения при потере связи с базой данных в секундах. По умолчанию 60.
sql_live_check
Запрос для тестирования подключения. По умолчанию:
- PSQL:
select 1
- FIREBIRD:
select 1 from rdb$database
- MSSQL:
select 1
regex_error_notexists
Регулярное выражение для определения ошибки подключения к базе данных. Если при первой попытке подключения модуля к базе данных произошла ошибка ввода/вывода, текст которой соответствует данному выражению, то выполняется попытка создания базы данных.
- PSQL:
(database .* does not exist)|(база данных .* не существует)
- FIREBIRD:
I/O error during .* operation for file .* - Error while trying to open
- MSSQL: не используется
postgres_service_db
Только для PSQL. Имя сервисной базы данных, которая необходима при создании баз данных. По умолчанию postgres
.
firebird_isql
Только для FIREBIRD. Имя до поставляемой с firebird утилиты isql, которая необходима при создании баз данных. Можно также указать путь, если утилита не в PATH. По умолчанию:
- linux: isql-fb
- windows: isql.exe
Драйвера
Для работы с СУБД необходимы соответствующие драйвера и клиентские библиотеки.
Драйвера собираются средствами qt под определенную целевую платформу и под определенную версию клиентской библиотеки. Собранные драйвера поместить в каталог sqldrivers
на одном уровне с исполняемым файлом.
Клиентские библиотеки также можно положить рядом с исполняемым файлом, либо в каталог, прописанный в PATH.