Доступные версии документации

SQLDriverConnect

Назначение

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

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

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

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

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

Особенности

Значения аргументов функции 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 значительно ускоряет скорость массовой последовательной выборки данных.

Заметили ошибку?
Выделите текст и нажмите Ctrl + Enter