PostgreSQL数据库学习手册之libpq可编辑范本.docVIP

ＰosｔgｒeSQＬ数据库学习手册之libpｑ－C库-—介绍(转）[@moｒe＠]

Cｈａpteｒ1。lｉbｐq—C库

TａbｌeofＣontents

１.1。介绍

１。２.数据库联接函数

1。3。命令执行函数

1.3。1.主过程

1。3。2。为包含在SＱL查询中逃逸字串

1.3。3.逃逸包含在SＱＬ查询中的二进制字串

1.３。4。检索SＥＬECT的结果信息

1。３．5。检索SELECT结果数值

1。3。6．检索非—SELECT结果信息

１.4.异步查询处理

1.5.捷径接口

1。6。异步通知

１.７。与COPＹ命令相关的函数

１。8。libｐｑ跟踪函数

1。９。lｉbpq控制函数

1。1０。环境变量

1．11.文件

1。12。线程特性

１.13。制作Ｌibpq程序

1。1４。例子程序

1.1。介绍

ｌibpｑ是PostgreSQL的Ｃ应用程序员的接口.lｉbpｑ是一套允许客户程序向PｏsｔgrｅSQL后端服务进程发送查询并且获得查询返回的库过程．libpq同时也是其他几个PｏstgrｅSQL应用接口下面的引擎,包括libpq＋＋(C+＋),ｌibｐgtcｌ(Tcl）,Ｐｅrl,和eｃpg．所以如果你使用这些软件包,lｉbｐq某些方面的特性会对你非常重要．

本节末尾有三个小程序显示如何利用libpｑ书写程序．在下面目录里面有几个完整的lｉbpｑ应用的例子：

ｓｒc/tｅｓｔ/ｅxaｍｐｌes

src/bin/ｐsql

使用liｂｐq的前端程序必须包括头文件libpｑ-ｆe。ｈ并且必须与liｂpｑ库链接．

PostgreSQL数据库学习手册之ｌｉbpq—C库-——数据库联接函数(转)［＠morｅ＠]

１．2。数据库联接函数

下面的过程处理与PostgｒeＳQL后端服务器联接的事情．一个应用程序一次可以与多个后端建立联接.（这么做的原因之一是访问多于一个数据库.)每个连接都是用一个从PQｃonnｅcｔdb（)或PQｓetｄbLoｇｉｎ()获得的PGcoｎn对象表示．注意，这些函数总是返回一个非空的对象指针，除非存储器少得连个ＰGconn对象都分配不出来.在把查询发送给联接对象之前,可以调用ＰＱstatuｓ函数来检查一下联接是否成功.

*

ＰQcｏｎｎectdb与后端数据库服务器建立一个新的联接．

PGcoｎn＊ＰQｃonnectdｂ(ｃｏｎstchaｒ*cｏnnｉｎfo）

这个过程用从一个字符串connｉnfo来的参数与数据库打开一个新的联接．与下面的PＱsetdbＬogｉn()不同的是，我们可以不必更换函数签名（名字)就可以扩展参数集,所以我们建议应用程序中使用这个函数或者是它的非阻塞的相似函数ＰQcoｎnecｔStａrt和PQconnｅｃtＰoll.传入的参数可以为空,表明使用所有缺省的参数,或者可以包含一个或更多个用空白间隔的参数设置．

每个参数以关键字=数值的形式设置．(要写一个空值或者一个包含空白的值,你可以用一对单引号包围它们，例如,ｋｅｙword＝＇avalue’．数值内部的单引号和反斜扛必须用一个反斜扛逃逸，也就是说，或．)等号周围的空白是可选的.目前可识别的参数键字是：

host

要联接的主机（ｈoｓt).如果主机名以斜扛开头，则它声明使用Unix域套接字通讯而不是ＴCP/ＩP通讯;该值就是套接字文件所存储的目录．缺省时是与位于/ｔmp里面的Unix—域套接字联接.

hoｓtａddr

与之联接的主机的IＰ地址。这个可以是标准的数字-点的形式,象在BSD函数inet_atoｎ等里面用的那样。如果声明了一个非零长的字符串,那么使用ＴCP/IＰ通讯机制。

使用hｏｓtaｄdr取代hｏsｔ可以让应用避免一次主机名查找，这一点对于那些有时间约束的应用来说可能是非常重要的。不过,Ｋerberos认证系统要求主机(ｈｏｓt)名。因此,应用下面的规则。如果声明了不带hostａddr的hｏｓt那么就强制进行主机名查找。如果声明中没有hosｔ,ｈｏsｔaｄｄｒ的值给出远端的地址；如果使用了Kｅrberｏs，将导致一次反向名字查询.如果同时声明了ｈｏst和hｏｓｔadｄｒ,除非使用了Ｋeｒbeｒos,否则将使用hostaddr的值作为远端地址;hoｓt的值将被忽略,如果使用了Kerberｏs,hｏst的值用于Ｋeｒbeｒoｓ认证。要注意如果传递给libpq的主机名（ｈｏst)不是地址hostaddr处的机器名,那么认