ExternalDBase.Connect

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");