与数据库服务器建立一个新连接。

PGconn *PQconnectdb(const char *conninfo);

此函数使用从字符串 conninfo 中取得的参数打开一个新的数据库连接。与下面的 PQsetdbLogin 不同，该函数的参数集可以在不改变函数签名的情况下扩展，因此新的应用程序编程首选使用此函数（或其非阻塞版本 PQconnectStart 和 PQconnectPoll）。

传入的字符串可以为空以使用全部默认参数，也可以包含一个或多个用空白分隔的参数设置。每个参数设置的形式为 keyword = value。（要写入空值或包含空格的值，请用单引号包围，例如 keyword = 'a value'。值中的单引号和反斜杠必须用反斜杠转义，即 \' 和 \\。）等号两边的空格是可选的。

目前可识别的参数关键字有：

如果任何参数未指定，则检查相应的环境变量（见第 27.10 节）。如果环境变量也未设置，则使用内建默认值。

与数据库服务器建立一个新连接。

PGconn *PQsetdbLogin(const char *pghost,
                     const char *pgport,
                     const char *pgoptions,
                     const char *pgtty,
                     const char *dbName,
                     const char *login,
                     const char *pwd);

这是 PQconnectdb 的前身，带有一组固定参数。除缺失的参数总是取默认值外，功能相同。对任何一个要取默认值的固定参数，可写 NULL 或空字符串。

与数据库服务器建立一个新连接。

PGconn *PQsetdb(char *pghost,
                char *pgport,
                char *pgoptions,
                char *pgtty,
                char *dbName);

这是一个宏，以空指针作为 login 和 pwd 参数调用 PQsetdbLogin。它只是为了与很老的程序保持向后兼容而保留。

以非阻塞方式建立与数据库服务器的连接。

PGconn *PQconnectStart(const char *conninfo);

PostgresPollingStatusType PQconnectPoll(PGconn *conn);

这两个函数用于打开到数据库服务器的连接，同时应用程序的执行线程不会在远程 I/O 上阻塞。这种做法的意义在于，对 I/O 完成的等待可以发生在应用的主循环中，而不是在 PQconnectdb 内部，因此应用可以将此操作与其他活动并行管理。

数据库连接使用传给 PQconnectStart 的字符串 conninfo 中的参数建立。该字符串的格式与上面 PQconnectdb 中描述的相同。

只要满足若干限制条件，PQconnectStart 和 PQconnectPoll 都不会阻塞：

要开始一个非阻塞连接请求，调用 conn = PQconnectStart("connection_info_string")。如果 conn 为空，说明 libpq 无法分配新的 PGconn 结构。否则返回一个有效的 PGconn 指针（尽管它尚未表示一个有效的数据库连接）。从 PQconnectStart 返回后，调用 status = PQstatus(conn)。如果 status 等于 CONNECTION_BAD，则 PQconnectStart 失败。

如果 PQconnectStart 成功，下一阶段是轮询 libpq，使其继续进行连接序列。使用 PQsocket(conn) 获取数据库连接底层套接字的描述符。循环如下：如果 PQconnectPoll(conn) 上次返回 PGRES_POLLING_READING，则等待套接字可读（由 select()、poll() 或类似的系统函数指示），然后再次调用 PQconnectPoll(conn)。反之，如果 PQconnectPoll(conn) 上次返回 PGRES_POLLING_WRITING，则等待套接字可写，然后再次调用 PQconnectPoll(conn)。如果尚未调用过 PQconnectPoll（即刚调用完 PQconnectStart 之后），则视同它上次返回的是 PGRES_POLLING_WRITING。持续此循环，直到 PQconnectPoll(conn) 返回 PGRES_POLLING_FAILED（表示连接过程失败）或 PGRES_POLLING_OK（表示连接成功建立）为止。

在连接期间的任何时刻，都可以调用 PQstatus 检查连接状态。如果返回 CONNECTION_BAD，则连接过程已失败；如果返回 CONNECTION_OK，则连接已就绪。这两种状态同样可以从上面描述的 PQconnectPoll 的返回值中检测到。其他状态只在（且仅会在）异步连接过程中出现，它们指示连接过程的当前阶段，例如可用于向用户提供反馈。这些状态是：

注意，尽管这些常量会保留（为了维护兼容性），应用程序绝不应依赖它们按特定顺序出现、依赖它们全都出现，或依赖状态总是这些已记录的值之一。应用程序可以这样做：

switch(PQstatus(conn))
{
    case CONNECTION_STARTED:
        feedback = "Connecting...";
        break;

    case CONNECTION_MADE:
        feedback = "Connected to server...";
        break;
.
.
.
    default:
        feedback = "Connecting...";
}

使用 PQconnectPoll 时会忽略 connect_timeout 连接参数；由应用负责判断是否已经耗时过长。除此之外，PQconnectStart 加上 PQconnectPoll 循环等价于 PQconnectdb。

注意，如果 PQconnectStart 返回非空指针，使用完毕后必须调用 PQfinish，以释放该结构和所有关联的内存块。即使连接尝试失败或被放弃，也必须这样做。

返回默认的连接选项。

PQconninfoOption *PQconndefaults(void);

typedef struct
{
    char   *keyword;   /* The keyword of the option */
    char   *envvar;    /* Fallback environment variable name */
    char   *compiled;  /* Fallback compiled in default value */
    char   *val;       /* Option's current value, or NULL */
    char   *label;     /* Label for field in connect dialog */
    char   *dispchar;  /* Character to display for this field
                          in a connect dialog. Values are:
                          ""        Display entered value as is
                          "*"       Password field - hide value
                          "D"       Debug option - don't show by default */
    int     dispsize;  /* Field size in characters for dialog */
} PQconninfoOption;

返回一个连接选项数组。它可用来确定 PQconnectdb 的所有可用选项及其当前默认值。返回值指向一个 PQconninfoOption 结构数组，该数组以一个 keyword 指针为空的条目结尾。注意，当前默认值（val 字段）依赖于环境变量和其他上下文。调用者必须将连接选项数据视为只读。

处理完选项数组后，将它传递给 PQconninfoFree 释放。如果不这样做，每次调用 PQconndefaults 都会泄漏少量内存。

关闭与服务器的连接，同时释放 PGconn 对象使用的内存。

void PQfinish(PGconn *conn);

注意，即使与服务器的连接尝试失败（由 PQstatus 指示），应用也应调用 PQfinish 释放 PGconn 对象使用的内存。在调用过 PQfinish 之后，不得再使用该 PGconn 指针。

重置与服务器的通信通道。

void PQreset(PGconn *conn);

此函数将关闭与服务器的连接，并尝试使用先前使用的全部相同参数与同一服务器重新建立新连接。如果工作中的连接丢失，这可用于错误恢复。

以非阻塞方式重置与服务器的通信通道。

int PQresetStart(PGconn *conn);

PostgresPollingStatusType PQresetPoll(PGconn *conn);

这些函数将关闭与服务器的连接，并尝试使用先前使用的全部相同参数与同一服务器重新建立新连接。如果工作中的连接丢失，这可用于错误恢复。它们与上面的 PQreset 的不同之处在于以非阻塞方式运作。这些函数受到与 PQconnectStart 和 PQconnectPoll 相同的限制。

要发起连接重置，调用 PQresetStart。如果返回 0，重置失败。如果返回 1，用与使用 PQconnectPoll 建立连接完全相同的方式，使用 PQresetPoll 对重置进行轮询。