Секция [Oracle]

В секции [Oracle] собраны настройки взаимодействия Dr.Web MailD с СУБД Oracle:

Lib = {путь к файлу}

Путь к библиотеке, поддерживающей Oracle OTL версии 8 или выше.

Библиотека должна быть собрана с поддержкой потоков. Поиск библиотеки осуществляется в соответствии с правилами системного вызова dlopen (см. документацию по dlopen).

В текущей версии продукта изменение этого параметра не может быть применено с помощью сигнала HUP. Необходимо перезапустить Dr.Web MailD.

Значение по умолчанию:

Lib =

ConnectData = {текст}

Параметры Oracle-соединения.

Поддерживаются два формата задания параметра:

"USER/PASSWORD@СONNECTION" – синтаксис Oracle;

"DSN=value;UID=value;PWD=value" – синтаксис ODBC.

Для начала работы необходимо, как минимум, задать название DSN, который ссылается на нужную базу данных.

Правила задания ConnectData в случае использования синтаксиса Oracle см. в примечании под таблицей.

Дополнительно рекомендуется использовать параметр connect_timeout, задающий время ожидания подключения.

Значение параметра может быть указано в локальных настройках Lookup.

Значение по умолчанию:

ConnectData =

SizeLimit = {числовое значение}

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

При значении 0 ограничения отсутствуют.

Значение параметра может быть указано в локальных настройках Lookup.

Значение по умолчанию:

SizeLimit = 0

SkipDomains = {LookupLite}

Список доменов, для которых не нужно выполнять запрос к базе данных.

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

Обратите внимание, что значение параметра – LookupLite.

Значение параметра может быть указано в локальных настройках Lookup

Значение по умолчанию:

SkipDomains =

OnError = {ignore | exception}

Задает процедуру обработки ошибок, возникающих в обработке Lookup при обращении к указанному источнику данных.

ignore – следует игнорировать возникшую ошибку и продолжить обработку письма (происходит только регистрация ошибки в журнале);

exception – следует сгенерировать исключение, которое будет обрабатываться как ошибка обработки письма, в соответствии со значением параметра ProcessingError, заданного в настройках того компонента, при работе которого эта ошибка возникла.

Значение параметра может быть указано в локальных настройках Lookup.

Значение по умолчанию:

OnError = ignore

Примечания:

1.C Oracle Dr.Web MailD работает через библиотеку libclntsh, которая поставляется совместно с клиентом Oracle и поддерживает версию OTL v8 или выше.

2.Для подключения к Oracle необходимо указать в значении параметра ConnectData имя пользователя, пароль и название подключения: user/password@CONNECTION.

Название подключения можно задать двумя способами:

если Dr.Web MailD установлен на том же компьютере, что и Oracle, то сперва необходимо задать для Dr.Web MailD переменную окружения ORACLE_HOME согласно документации на СУБД Oracle. Потом нужно указать в качестве названия подключения одно из имен TNS в файле $ORACLE_HOME/network/admin/tnsnames.ora;

также можно скопировать (без символов переноса строки) описание подключения непосредственно из $ORACLE_HOME/network/admin/tnsnames.ora, расположенного на сервере.

Пример:

Имеется файл tnsnames.ora:

CONNECTIONNAME =
(DESCRIPTION =
 (ADDRESS = (PROTOCOL = TCP)(HOST = localhost)(PORT = 1521))
 (CONNECT_DATA =
   (SERVER = DEDICATED)
   (SERVICE_NAME = CONNECTIONNAME)
 )
)

Соответственно, можно указать в качестве строки подключения:

user/password@CONNECTIONNAME

либо:

user/pasword@(DESCRIPTION = (ADDRESS = (PROTOCOL = TCP)(HOST = localhost)(PORT = 1521))(CONNECT_DATA = SERVER = DEDICATED)(SERVICE_NAME = CONNECTIONNAME)))

3.В случае если указанный хост или сама база данных недоступна, попытка установления подключения к СУБД будет производиться в течение таймаута, заданного в строке подключения при помощи параметра connect_timeout. По его истечении будет зафиксирована ошибка, которая будет обработана в соответствии со значением параметра OnError.