返回连接的数据库名称。

char *PQdb(const PGconn *conn);

返回连接的用户名。

char *PQuser(const PGconn *conn);

返回连接的密码。

char *PQpass(const PGconn *conn);

PQpass 将返回连接参数中指定的密码，或者如果没有，则从 密码文件中获取的密码，它将返回该密码。 在后一种情况下，如果连接参数中指定了多个主机，则在建立连接之前，无法依赖 PQpass 的结果。 可以使用函数 PQstatus 检查连接的状态。

返回活动连接的服务器主机名。 如果连接是通过 Unix 套接字，则可以是主机名、IP 地址或目录路径。（路径情况可以区分，因为它始终是绝对路径，以 / 开头。）

char *PQhost(const PGconn *conn);

如果连接参数同时指定了 host 和 hostaddr，则 PQhost 将返回 host 信息。 如果仅指定了 hostaddr，则返回该信息。 如果连接参数中指定了多个主机，PQhost 将返回实际连接的主机。

如果 conn 参数为 NULL，则 PQhost 返回 NULL。 否则，如果产生主机信息时发生错误（可能如果连接尚未完全建立或发生错误），它将返回一个空字符串。

如果连接参数中指定了多个主机，则在建立连接之前，无法依赖 PQhost 的结果。 可以使用函数 PQstatus 检查连接的状态。

返回活动连接的服务器 IP 地址。 这可以是主机名解析到的地址，也可以是通过 hostaddr 参数提供的 IP 地址。

char *PQhostaddr(const PGconn *conn);

如果 conn 参数为 NULL，则 PQhostaddr 返回 NULL。 否则，如果产生主机信息时发生错误（可能如果连接尚未完全建立或发生错误），它将返回一个空字符串。

返回活动连接的端口。

char *PQport(const PGconn *conn);

如果连接参数中指定了多个端口，则 PQport 将返回实际连接的端口。

如果 conn 参数为 NULL，则 PQport 返回 NULL。 否则，如果产生端口信息时发生错误（可能如果连接尚未完全建立或发生错误），它将返回一个空字符串。

如果连接参数中指定了多个端口，则在建立连接之前，无法依赖 PQport 的结果。 可以使用函数 PQstatus 检查连接的状态。

此函数不再执行任何操作，但保留是为了向后兼容。 该函数始终返回一个空字符串，如果 conn 参数为 NULL，则返回 NULL。

char *PQtty(const PGconn *conn);

返回在连接请求中传递的命令行选项。

char *PQoptions(const PGconn *conn);

返回连接的状态。

ConnStatusType PQstatus(const PGconn *conn);

状态可以是多个值之一。 但是，只有两个值在异步连接过程之外可见：CONNECTION_OK 和 CONNECTION_BAD。 与数据库的良好连接的状态为 CONNECTION_OK。 连接尝试失败由状态 CONNECTION_BAD 表示。 通常，OK 状态将保持不变，直到 PQfinish，但通信故障可能会导致状态过早更改为 CONNECTION_BAD。 在这种情况下，应用程序可以尝试通过调用 PQreset 来恢复。

有关可能返回的其他状态代码，请参阅 PQconnectStartParams、PQconnectStart 和 PQconnectPoll 的条目。

返回服务器当前事务状态。

PGTransactionStatusType PQtransactionStatus(const PGconn *conn);

状态可以是 PQTRANS_IDLE（当前空闲）、PQTRANS_ACTIVE（命令正在执行中）、PQTRANS_INTRANS（空闲，处于有效的事务块中）或 PQTRANS_INERROR（空闲，处于失败的事务块中）。如果连接不正常，则会报告 PQTRANS_UNKNOWN。PQTRANS_ACTIVE 仅在查询已发送到服务器但尚未完成时报告。

查找服务器的当前参数设置。

const char *PQparameterStatus(const PGconn *conn, const char *paramName);

某些参数值会在连接启动时或值发生更改时由服务器自动报告。PQparameterStatus 可用于查询这些设置。如果已知参数的当前值，则返回该值；如果未知，则返回 NULL。

当前版本报告的参数包括

（default_transaction_read_only 和 in_hot_standby 在 14 版本之前未报告；scram_iterations 在 16 版本之前未报告。）请注意，server_version、server_encoding 和 integer_datetimes 在启动后无法更改。

如果未报告 standard_conforming_strings 的值，则应用程序可以假定它为 off，即反斜杠在字符串字面量中被视为转义符。此外，此参数的存在可以被视为接受转义字符串语法 (E'...') 的标志。

尽管返回的指针被声明为 const，但实际上它指向与 PGconn 结构关联的可变存储。假设指针在查询之间保持有效是不明智的。

查询正在使用的前端/后端协议。

int PQprotocolVersion(const PGconn *conn);

应用程序可能希望使用此函数来确定是否支持某些功能。目前，可能的值为 3 (3.0 协议) 或零（连接不良）。协议版本在连接启动完成后不会更改，但理论上可能会在连接重置期间更改。3.0 协议受 PostgreSQL 服务器 7.4 及更高版本支持。

返回表示服务器版本的整数。

int PQserverVersion(const PGconn *conn);

应用程序可以使用此函数来确定它们连接的数据库服务器的版本。结果是通过将服务器的主要版本号乘以 10000 并加上次要版本号而形成的。例如，版本 10.1 将返回 100001，版本 11.0 将返回 110000。如果连接不良，则返回零。

在主版本 10 之前，PostgreSQL 使用三部分版本号，其中前两部分共同表示主版本。对于这些版本，PQserverVersion 对每个部分使用两位数字；例如，版本 9.1.5 将返回 90105，版本 9.2.0 将返回 90200。

因此，为了确定功能兼容性，应用程序应将 PQserverVersion 的结果除以 100 而不是 10000，以确定逻辑主版本号。在所有发行系列中，只有最后两位数字在次要版本（错误修复版本）之间有所不同。

返回最近对连接执行操作时生成的错误消息。

char *PQerrorMessage(const PGconn *conn);

几乎所有 libpq 函数在失败时都会为 PQerrorMessage 设置消息。请注意，按照 libpq 约定，非空的 PQerrorMessage 结果可能包含多行，并将包含一个尾随换行符。调用者不应直接释放结果。当关联的 PGconn 句柄传递给 PQfinish 时，它将被释放。不应期望结果字符串在对 PGconn 结构进行操作时保持不变。

获取到服务器的连接套接字的文件描述符编号。有效的描述符将大于或等于 0；结果为 -1 表示当前没有打开的服务器连接。（这在正常操作期间不会更改，但在连接设置或重置期间可能会更改。）

int PQsocket(const PGconn *conn);

返回处理此连接的后端进程的进程ID(PID)。

int PQbackendPID(const PGconn *conn);

后端PID对于调试目的以及与 NOTIFY 消息进行比较很有用（其中包括通知后端进程的PID）。请注意，PID属于在数据库服务器主机上执行的进程，而不是本地主机！

如果连接身份验证方法需要密码，但没有可用密码，则返回 true (1)。如果不是，则返回 false (0)。

int PQconnectionNeedsPassword(const PGconn *conn);

可以在连接尝试失败后应用此函数，以决定是否提示用户输入密码。

如果连接身份验证方法使用了密码，则返回 true (1)。如果不是，则返回 false (0)。

int PQconnectionUsedPassword(const PGconn *conn);

可以在连接尝试失败或成功后应用此函数，以检测服务器是否要求密码。

如果连接身份验证方法使用了 GSSAPI，则返回 true (1)。如果不是，则返回 false (0)。

int PQconnectionUsedGSSAPI(const PGconn *conn);

可以应用此函数来检测连接是否使用 GSSAPI 进行了身份验证。

如果连接使用 SSL，则返回 true (1)；如果不是，则返回 false (0)。

int PQsslInUse(const PGconn *conn);

返回有关连接的 SSL 相关信息。

const char *PQsslAttribute(const PGconn *conn, const char *attribute_name);

可用属性列表因使用的 SSL 库和连接类型而异。如果连接不使用 SSL 或指定属性名称未为正在使用的库定义，则返回 NULL。

以下属性通常可用

在特殊情况下，可以通过传递 NULL 作为 conn 参数来查询 library 属性，而无需连接。结果将是默认的 SSL 库名称，如果 libpq 在编译时未包含任何 SSL 支持，则为 NULL。（在 PostgreSQL 15 版本之前，传递 NULL 作为 conn 参数总是导致 NULL。需要区分此案例的新旧实现的客户端程序可以检查 LIBPQ_HAS_SSL_LIBRARY_DETECTION 功能宏。）

返回可在 PQsslAttribute() 中使用的 SSL 属性名称数组。该数组以 NULL 指针结尾。

const char * const * PQsslAttributeNames(const PGconn *conn);

如果 conn 为 NULL，则返回默认 SSL 库可用的属性，如果 libpq 在编译时未包含任何 SSL 支持，则返回空列表。如果 conn 不为 NULL，则返回连接正在使用的 SSL 库可用的属性，如果连接未加密，则返回空列表。

返回一个指向描述连接的 SSL 实现特定对象的指针。如果连接未加密或连接的 SSL 实现无法提供请求类型的对象，则返回 NULL。

void *PQsslStruct(const PGconn *conn, const char *struct_name);

可用的结构体取决于所使用的 SSL 实现。对于 OpenSSL，只有一个结构体，可以使用名称 OpenSSL 访问，它返回一个指向 OpenSSL 的 SSL 结构体的指针。要使用此函数，可以使用类似如下的代码：

#include <libpq-fe.h>
#include <openssl/ssl.h>

...

    SSL *ssl;

    dbconn = PQconnectdb(...);
    ...

    ssl = PQsslStruct(dbconn, "OpenSSL");
    if (ssl)
    {
        /* use OpenSSL functions to access ssl */
    }

此结构可用于验证加密级别、检查服务器证书等。有关此结构的信息，请参阅 OpenSSL 文档。

返回连接中使用的 SSL 结构体，如果未使用 SSL，则返回 NULL。

void *PQgetssl(const PGconn *conn);

此函数等效于 PQsslStruct(conn, "OpenSSL")。它不应在新应用程序中使用，因为返回的结构体特定于 OpenSSL，如果使用其他SSL实现，则不可用。要检查连接是否使用 SSL，请改为调用 PQsslInUse，有关连接的更多详细信息，请使用 PQsslAttribute。