✎ database [ПромАвтоматика]

Эта страница только для чтения. Вы можете посмотреть исходный текст, но не можете его изменить. Сообщите администратору, если считаете, что это неправильно.
====== database ======

Модуль выполняет подключение к базе данных и предоставляет к ней доступ другим модулям.

<code xml>
    <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"
    />

</code>

===== Параметры =====

==== driver ====
  * PSQL
  * FIREBIRD
  * MSSQL

==== host ====
Имя или ip-адрес сервера баз данных. По умолчанию ''localhost''.

==== port ====
Порт подключения к серверу баз данных. По умолчанию:
  * PSQL: ''5432'' 
  * FIREBIRD: ''3050''
  * MSSQL: ''1433''

<html>
<!--
Внимание **FIREBIRD**! Данный параметр игнорируется драйвером. Пока не будет исправлено, пользоваться параметром ''host'', указывая порт через косую черту. Пример:
  host="localhost/3051"
-->
</html>

==== 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.