пакет требует tdbc::postgres 1.0 tdbc::postgres::connection createбаза данных ?-параметр значение...? tdbc::postgres::connection new ?-параметр значение...?
Описание
Драйвер tdbc::postgres предоставляет интерфейс к базам данных, соответствующий Tcl DataBase Connectivity (TDBC), и позволяет скрипту Tcl подключаться к базе данных Postgres.
Подключение к базе данных POSTGRES устанавливается вызовом tdbc::postgres::connection create, передавая ему имя для идентификации объекта подключения и набор пар -параметр-значение. Доступные параметры перечислены ниже в разделе ПАРАМЕТРЫ ПОДКЛЮЧЕНИЯ. В качестве альтернативы можно использовать tdbc::postgres::connection new для создания подключения к базе данных с автоматически присвоенным именем. Возвращаемое значение tdbc::postgres::connection new — это имя, выбранное для объекта подключения.
Побочным эффектом вызова tdbc::postgres::connection create является создание нового подключения к базе данных. Подробнее о том, как использовать это подключение для работы с базой данных, см. в tdbc::connection(n).
Параметры подключения
Команда объекта tdbc::postgres::connection create поддерживает параметры -encoding, -isolation, -readonly и -timeout, общие для всех драйверов TDBC. Параметр -timeout влияет только на процесс подключения; после подключения это значение игнорируется и его нельзя изменить.
Кроме того, распознаются следующие параметры (эти параметры необходимо задать при первоначальном создании подключения; их нельзя изменить после подключения):
-hostимя_хоста
Подключается к хосту, указанному в имя_хоста. По умолчанию используется локальный сокет Unix.
-hostaddrадрес
Подключается к хосту, указанному в заданном IP-адресе. Если заданы оба -host и -hostaddr, значение -host игнорируется. По умолчанию используется локальный сокет Unix.
-portчисло
Подключается к серверу Postgres, прослушивающему порт, указанный в число. Используется только при указании host или hostaddr.
-userимя
Представляет имя в качестве имени пользователя серверу Postgres. По умолчанию используется текущий идентификатор пользователя.
-passwdпароль
-passwordпароль
Эти два параметра являются синонимами. Они представляют указанный пароль как пароль пользователя серверу Postgres. По умолчанию пароль не предоставляется.
-databaseимя
-dbимя
Эти два параметра являются синонимами. Они представляют указанное имя в качестве имени используемой по умолчанию базы данных в запросах Postgres. Если не указано, используется база данных по умолчанию для текущего пользователя.
-optionsпараметры
Это устанавливает параметры в качестве дополнительных параметров командной строки, отправляемых на сервер.
-ttyфайл
Этот параметр игнорируется на всех серверах. Раньше он указывал, куда отправлять отладочные данные. Этот параметр оставлен для совместимости со старыми серверами.
-sslmodeрежим
Этот параметр определяет, как и с каким приоритетом будет осуществляться подключение SSL к серверу. Существует четыре режима: disable — попытка только нешифрованного SSL-соединения; allow — устанавливает соединение, сначала пытаясь подключиться без SSL, а затем, если это не удается, пытается подключиться по SSL; prefer (по умолчанию) — устанавливает соединение, сначала пытаясь подключиться по SSL, а затем, если это не удается, пытается подключиться без SSL; require — пытается подключиться только по SSL. Если PostgreSQL скомпилирован без поддержки SSL, использование параметра require вызовет ошибку, а параметры allow и prefer будут допустимы, но драйвер не сможет установить SSL-соединение.
-requiresslфлаг
Этот параметр устарел в пользу параметра -sslmode. Значение флаг должно быть булевым. Если оно true (или любой эквивалент), драйвер откажется от подключения, если сервер не поддерживает SSL-соединение. Значение по умолчанию false (или любой эквивалент), и действует также как -sslmode prefer
-serviceимя
Указывает имя имя в файле pg_service.conf, содержащем дополнительные параметры подключения. Это позволяет приложениям указать только имя службы, чтобы параметры подключения можно было централизованно поддерживать. Для получения подробной информации обратитесь к документации PostgreSQL или файлу PREFIX/share/pg_service.conf.sample.
Примеры
tdbc::postgres::connection -user joe -passwd sesame -db joes_database
Подключается к серверу Postgres на локальном хосте с использованием стандартного метода подключения, представляя пользователя 'joe' и пароль 'sesame'. Использует 'joes_database' в качестве имени базы данных по умолчанию.
