Установить соединение
Назначение
Метод Open создает объект Connection, если объект еще не создан, и устанавливает соединение с СУБД ЛИНТЕР.
Синтаксис
value {< объект Connect > | LinterConnection}.
Open (Name, Password[, Node[, Mode[, CharSet]]])
Конструкция LinterConnection.Open(…) создает объект Connection с заданными параметрами соединения и на его основе устанавливает соединение с СУБД ЛИНТЕР.
Конструкция < объект Connection >.Open(…) для соединения с СУБД ЛИНТЕР использует ранее созданный с помощью метода Create() объект Connection.
-
Name -
Имя пользователя БД. Символьная строка длиной не более 66 символов.
-
Password -
Пароль пользователя. Символьная строка длиной не более 18 символов.
-
Node -
Имя ЛИНТЕР-сервера, с которым необходимо установить соединение. Символьная строка длиной не более 8 символов. Если параметр не задан (указано значение
nil), то соединения осуществляется с сервером по умолчанию (локальным сервером). -
Mode -
Формат:
[< режим транзакции >] [| < кодовая страница >]
Возможные
< режимы транзакции >соединения:-
M_AUTOCOMMIT– режимAUTOCOMMIT; -
M_EXCLUSIVE– режимPESSIMISTIC; -
M_OPTIMISTIC– режимOPTIMISTIC;Примечание
Режим M_OPTIMISTIC устарел (использовать не рекомендуется).
Режим устанавливается как побитовая операция «|» между значением режима транзакции и кодовой страницей.
Значение
< кодовой страницы >см. в описании аргументаCharSet.Если
< режим транзакции >не задан (указано значениеnil), по умолчанию используетсяM_AUTOCOMMIT. -
-
CharSet -
Имя кодовой страницы соединения.
Список доступных кодовых страниц находится в системной таблице LINTER_SYSTEM_USER.$$$CHARSET.
Если кодовая страница не задана, содержит пустую строку или неверное имя кодовой страницы, то устанавливается кодовая страница по умолчанию (заданная через переменную окружения LINTER_CP или используемая по умолчанию интерфейсом нижнего уровня, см. документ «СУБД ЛИНТЕР. Интерфейс нижнего уровня»).
Возвращаемое значение
Объект Connection.