Difference between revisions of "ExternalDBase.Connect"
1>Admin |
m (1 revision imported) |
||
(2 intermediate revisions by 2 users not shown) | |||
Line 25: | Line 25: | ||
* <code>''<Пароль (STRING)>''</code> - Пароль пользователя для входа после установки соединения. | * <code>''<Пароль (STRING)>''</code> - Пароль пользователя для входа после установки соединения. | ||
* <code>''<Дополнительные установки (INT)>''</code> - {{Optional}} Число, задающее битовую маску с дополнительными установками соединения. Доступны следующие значения битов: | * <code>''<Дополнительные установки (INT)>''</code> - {{Optional}} Число, задающее битовую маску с дополнительными установками соединения. Доступны следующие значения битов: | ||
− | ** '''Бит 0''' -- Использовать сжатие данных при передаче пакетов ( | + | ** '''Бит 0''' -- (рекомендуется, по умолчанию) Использовать сжатие данных при передаче пакетов. |
+ | ** '''Бит 1''' -- Устанавливает флаг "медленное соединение" для этой базы данных (см. [[IsSlowConnection]]). | ||
+ | ** '''Бит 2''' -- Производит соединение в режиме, когда регистрация на сервере и выход не создают записей login/logout в таблице журнала регистрации событий. Этот режим может быть полезен, чтобы не увеличивать базу данных при каждом соединении, если они происходят достаточно часто (см. ключ ''GhostLogin'' в статье [[Основной файл инициализации клиента]]). | ||
== Примеры == | == Примеры == |
Latest revision as of 12:11, 8 June 2023
Connect (Соединиться с внешней базой данных) | |||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Функция выполяет соединение с базой данных по указанному адресу под указанным пользователем с заданным паролем. Если в процессе соединения произошла ошибка, функция вызовет исключение. Внимание: запись о новой внешней базе данных создается в памяти после успешного соединения, а не в момент создания объекта внешней базы данных. Это означает, что если соединение в процессе работы будет разорвано, и программа произведет его снова с помощью этой функции с тем же объектом, все объекты базы данных, оставшиеся в памяти, не будут принадлежать заново установленному соединению (т.е., будут внешними по отношению к нему).
Синтаксис
ExternalDBase.Connect(<Адрес базы данных (STRING)>,<Имя пользователя (STRING)>,<Пароль (STRING)>,<Дополнительные установки (INT)>=1)
Аргументы
<Адрес базы данных (STRING)>
- Строка содержит адрес внешней базы данных, с которой необходимо установить соединение. Строка имеет формат:<IP-адрес>:<Порт>:<TCP пароль сервера>
.<Имя пользователя (STRING)>
- Имя пользователя для входа после установки соединения.<Пароль (STRING)>
- Пароль пользователя для входа после установки соединения.<Дополнительные установки (INT)>
- (необязательный аргумент) Число, задающее битовую маску с дополнительными установками соединения. Доступны следующие значения битов:- Бит 0 -- (рекомендуется, по умолчанию) Использовать сжатие данных при передаче пакетов.
- Бит 1 -- Устанавливает флаг "медленное соединение" для этой базы данных (см. IsSlowConnection).
- Бит 2 -- Производит соединение в режиме, когда регистрация на сервере и выход не создают записей login/logout в таблице журнала регистрации событий. Этот режим может быть полезен, чтобы не увеличивать базу данных при каждом соединении, если они происходят достаточно часто (см. ключ GhostLogin в статье Основной файл инициализации клиента).
Примеры
db2:=exdb.create(); db2.Connect("127.0.0.1:13521:TCPPassword","User","Password"); aEl:=db2.Ref.Контрагенты; //Будет выведена единица Message(db2.IsConnected()); db2.Disconnect; //Будет выведен ноль Message(db2.IsConnected()); //Будет вызвано исключение, так как соединение в данный момент не установлено aEl.Find("Code","000000000603");