第 34 章 libpq - C 库

目录

34.1. 数据库连接控制函数 : 34.1.1. 连接字符串

[34.1.2. 参数关键词](libpq-connect.md#LIBPQ-PARAMKEYWORDS)

34.2. 连接状态函数

34.3. 命令执行函数 : 34.3.1. 主要函数

[34.3.2. 检索查询结果信息](libpq-exec.md#LIBPQ-EXEC-SELECT-INFO)

[34.3.3. 检索其他结果信息](libpq-exec.md#LIBPQ-EXEC-NONSELECT)

[34.3.4. 用于包含在 SQL 命令中的转移串](libpq-exec.md#LIBPQ-EXEC-ESCAPE-STRING)

34.4. 异步命令处理

34.5. 一行一行地检索查询结果

34.6. 取消进行中的查询

34.7. 快速路径接口

34.8. 异步提示

34.9. COPY命令相关的函数 : 34.9.1. 用于发送COPY数据的函数

[34.9.2. 用于接收`COPY`数据的函数](libpq-copy.md#LIBPQ-COPY-RECEIVE)

[34.9.3. 用于`COPY`的废弃函数](libpq-copy.md#LIBPQ-COPY-DEPRECATED)

34.10. 控制函数

34.11. 杂项函数

34.12. 通知处理

34.13. 事件系统 : 34.13.1. 事件类型

[34.13.2. 事件回调函数](libpq-events.md#LIBPQ-EVENTS-PROC)

[34.13.3. 事件支持函数](libpq-events.md#LIBPQ-EVENTS-FUNCS)

[34.13.4. 事件实例](libpq-events.md#LIBPQ-EVENTS-EXAMPLE)

34.14. 环境变量

34.15. 口令文件

34.16. 连接服务文件

34.17. 连接参数的 LDAP 查找

34.18. SSL 支持 : 34.18.1. 服务器证书的客户端验证

[34.18.2. 客户端证书](libpq-ssl.md#LIBPQ-SSL-CLIENTCERT)

[34.18.3. 不同模式中提供的保护](libpq-ssl.md#LIBPQ-SSL-PROTECTION)

[34.18.4. SSL 客户端文件使用](libpq-ssl.md#LIBPQ-SSL-FILEUSAGE)

[34.18.5. SSL 库初始化](libpq-ssl.md#LIBPQ-SSL-INITIALIZE)

34.19. 在线程化程序中的行为

34.20. 编译 libpq 程序

34.21. 例子程序

libpq是应用程序员使用PostgreSQL的C接口。libpq是一个库函数的集合，它们允许客户端程序传递查询给PostgreSQL后端服务器并且接收这些查询的结果。

libpq也是很多其他PostgreSQL应用接口的底层引擎，包括为 C++、Perl、Python、Tcl 和 ECPG编写的接口。如果你使用那些包，某些方面的libpq行为将会对你很重要。特别是，第 34.14 节、第 34.15 节和第 34.18 节描述了任何使用libpq的应用的用户可见的行为。

在本章的末尾（第 34.21 节）包括了一些短程序来展示如何编写使用libpq的应用。在源代码发布的src/test/examples目录中还有一些完整的libpq应用的例子。

使用libpq的客户端程序必须包括头文件libpq-fe.h并必须与libpq库链接在一起。