↑↓ 选择↵ 打开⌫ 切换范围完整搜索

PG.CENTER 连接 PostgreSQL 文档、百科与生态知识。由 Pigsty 维护。

已结束支持的版本: 7.4 / 7.3 / 7.2 / 7.1 / 7.0 / 6.5 / 6.4
历史版本。 PostgreSQL 7.4 已结束支持。 请参阅 当前版本手册.

pg_connect

pg_connect — 打开一个到服务器的连接

大纲

pg_connect -conninfo connectOptions
pg_connect dbName ?-host hostName? ?-port portNumber? ?-tty tty? ?-options serverOptions?

描述

pg_connect 打开一个到 PostgreSQL 服务器的连接。

有两种可用的语法。在较老的一种中,每个可能的选项在 pg_connect 命令中都有一个单独的选项开关。在较新的一种中,提供的是单个选项字符串,其中可以包含多个选项值。可以用 pg_conndefaults 获取关于较新语法中可用选项的信息。

参数

新风格

connectOptions

一个连接选项字符串,每个选项都写成 keyword = value 的形式。有效选项的列表可以在 libpq 函数 PQconnectdb 的描述中找到。

旧风格

dbName

要连接的数据库名。

-host hostName

要连接的数据库服务器的主机名。

-port portNumber

要连接的数据库服务器的 TCP 端口号。

-tty tty

用于服务器可选调试输出的文件或 TTY。

-options serverOptions

要传递给服务器的额外配置选项。

返回值

如果成功,返回一个数据库连接的句柄。句柄以 pgsql 前缀开头。

报告文档问题

阅读 上游文档. 反馈更正前请先核对 当前版本手册.