SQLDriverConnect

Назначение

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

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

  • строку соединения, содержащую наименование источника данных, один или несколько идентификаторов пользователей, один или несколько паролей и другую информацию, требуемую источником данных;

  • диалоговое окно для приема от пользователя информации (рис. 6).

Окно ввода параметров соединения
Рисунок 6. Окно ввода параметров соединения

Особенности

Значения аргументов функции SQLDriverConnect представлены в таблице 5.

Таблица 5. Аргументы функции SQLDriverConnect
АргументДопустимые значения

SzConnStrIn

Строка формата

DSN=< dsn >;UID=< uid >;{PWD|PASSWORD}=< pwd >;
SERVER=< server >;TXN=< txn >;
WCHARDEFAULT=< wchardefault >;
BUFFERED_FETCH=< buffered_fetch >;
TRUSTED_CONNECTION=< trusted_connection >

где:

  • dsn: наименование источника данных;

  • uid: имя пользователя;

  • pwd: пароль пользователя;

  • server: удаленный ЛИНТЕР-сервер;

  • txn: режим обработки транзакций. Допустимые значения: OPTIMISTIC, PESSIMISTIC, AUTOCOMMIT;

    Примечание

    Режим OPTIMISTIC устарел. Применять не рекомендуется.

  • wchardefault: тип символьных данных SQL_C_DEFAULT: SQL_C_WCHAR или SQL_C_CHAR;

  • buffered_fetch: управляет режимом оптимизации буферизированного чтения. Даже когда пользователь не задаёт массив ответов, данные будут выбираться всё равно пакетами: TRUE – режим включен, FALSE – отключен. По умолчанию режим отключен;

  • trusted_connection: дает возможность осуществить подключение к БД без указания учетных данных пользователя (имени/пароля). В качестве примера может служить подключение через протокол Kerberos (см. документ «СУБД ЛИНТЕР. Архитектура СУБД» («Авторизация пользователей»)). Допустимые значения: TRUE, FALSE, YES, NO.


Примечание

Режим BUFFERED_FETCH значительно увеличивает скорость массовой последовательной выборки данных, но не действует на выборку, в которой присутствует хотя бы один BLOB-столбец.