编程接口 - libpq 获取连接
数据查询和数据操纵
终止连接
libpq是PostgreSQL的 C应用程序接口。Libpq 由相关库函数组成，可以允许客户端程序通过将查询传递 给 PostgreSQL 后台服务器并接收这些查询返回的结果。同时，libpq 也是其它几个 PostgreSQL 应用程 序接口的基础引擎，包括 C++，Perl，Python，Tcl和ECPGC编程的嵌入式 SQL。OushuDB与 PostgreSQL兼容，同样可以通过libpq来进行数据库连接和数据操纵。
获取连接
一个应用程序同时可以有多个打开的连接，这也是 PostgreSQL 服务器能够同时访问多个库的原因。每 一个连接都通过 PGconn 对象表示，该对象可以从函数 PQconnectdb，PQconnectdbParams 中或者 PQsetdbLogin 获取信息。需要注意的是，这些对象通常返回一个非空的对象指针。除非由于内存太小 导致无法分配 PGconn 对象。PQstatus 函数用来检查在执行查询前连接是否成功的状态。
在要使用libpq连接OushuDB数据库之前，首先要引用libpq的头文件libpq-fe.h。 然后创建连接字符串和PGconn结构体，设定连接字符串后就可以通过连接字符串获取连接了，例如:
这里使用了PQconnectdb函数来创建一个连接到数据库服务器的新连接 注意如果这里缺省连接关键字的话，libpq将使用缺省关键字的默认值进行连接，连接关键字的默认值可
以参考官方手册。 在连接过程中，在libpq中也提供了判断连接是否成功建立的接口:连接状态函数 PQstatus
这个函数返回一个连接的状态，在异步连接过程之外可以返回两个状态:CONNECTION_OK 和 CONNECTION_BAD。若连接到数据库正常则返回 CONNECTION_OK，否则返回 CONNECTION_BAD。通常一个 OK 的状态将会持续到执行 PQfinish。
于是，我们可以通过下面的语句来进行连接状态的查询和处理，并通过PQerrorMessage()函数来返回最 近连接时出现的错误信息:
const char *conninfo;
PGconn *conn;
conninfo = "host=127.0.0.1 port=5433 dbname=postgres user=oushu";
conn = PQconnectdb(conninfo);
ConnStatusType PQstatus(const PGconn *conn);
if (PQstatus(conn) != CONNECTION_OK)
{
fprintf(stderr, "Connection to database failed: %s",
PQerrorMessage(conn));exit_nicely(conn);//关闭连接并执行清理操作
}
这里如果连接不成功的话会返回服务端返回的错误message，如果成功的话后面就可以通过conn操作数 据库了。