Linux下PostgresQL数据库C语言接口：libpq （一）数据库连接

转载请注明本文出处：leonidasFlames的blog,链接为：Linux下PostgresQL数据库C语言接口：libpq （一）
 
 
libpq 是 PostgreSQL的C语言应用程序的接口。libpq 是一套允许客户程序向PostgreSQL 后端服务进程发送查询 并且获得查询返回的库．libpq 同时也是其他几个 PostgreSQL 应用接口下面的引擎， 包括libpq++ （C++），libpgtcl（Tcl），Perl，和ecpg。
注意事项：
1. 在C语言程序中，需要包含<libpq-fe.h>头文件，并必须在编译时添加相应链接标记：-lpq。
2. 在C++语言程序中，有两套头文件及其库函数，分别是早期的<libpq++.h>和<pqxx/pqxx>，两者库函数完全不同。其中<libpq++.h>为更早期的，网上示例较多。
 
一、libpq库下C语言程序对PostgreSQL数据的访问连接
 
1.首先看一个简单示例：

#include <iostream>

#include<postgresql/libpq-fe.h>

using namespace std;

/******************************************************************************/

int main(int argc, char** argv) {

const char*conninfo="hostaddr=127.0.0.1 user=Meme dbname=MyDatabasepassword=123";

PGconn* conn=PQconnectdb(conninfo);

if(PQstatus(conn)==CONNECTION_OK)

{

cout<<"连接PostgreSQL数据库 成功！"<<endl;

PQfinish(conn);

cout<<"与PostgreSQL数据库连接 关闭！"<<endl;

}

else

{

cout<<"连接失败！"<<endl;

}

return 0;

}

/******************************************************************************/

2. 与后端数据库服务器建立一个新的连接
PGconn　*PQconnectdb(const char *conninfo) ;
从字符串conninfo传参以建立与Database的连接。字符串中可以包含如下信息
host 主机 hostaddr 主机IP地址 port 端口或套接字扩展文件名 dbname 数据库名 user 用户名 password 用户密码 option 调试选项
及connect_timeout，tty，sslmode，requiressl等其他不常用信息。
一般使用的是：
    const char* conninfo="hostaddr=127.0.0.1user=Meme dbname=MyDatabase password=123";

以上这几种必要信息。字符串写法大致为”关键字=数值 “形式，参照该示例即可。

3. PGconn *PQsetdbLogin(const char* pghost,const char* pgport,const char*pgoption,const char* pgtty,const char* dbname,const char* login,const char* pwd);
该函数是PGconnectdb()前身，功能上一致，区别在于固定个数的参数，具体可参照官方文档。由于PGconnectdb()在使用上更为灵活，首推使用PGconnectdb()。
 
4. 关闭连接
void PQfinish(PGconn* conn);
释放被PGconn对象使用的存储器，PGconn指针不可再使用
 
5. 返回连接状态。
ConnStatusType PQstatus(const PGconn* conn);
返回状态，最常用的是这两个：
CONNECTION_OK 与DB成功连接 CONNECTION_BAD与DB连接失败
通常，一个OK状态将保持到PQfinish()，但一个通讯失败可能导致状态过早地变为BAD。这时，程序可试用PQreset()恢复。
 
6. 重新连接 void PQreset(PGconn* conn);
 
7. 与数据库服务器建立一个非阻塞连接
PGconn* PQconnectStart(const char* conninfo);
PosgresPollingStatusType *PQconnectPoll(PGconn *conn);
你的应用执行线程在运行时不会阻塞远端I/O。你必须在调用PQconnectPoll()之前确保socket处于正确的状态。这两个函数都不会阻塞线程。
PostgreSQL libpq的数据库连接方面简单使用就是这些，参照上文示例，我们已经可以让C语言程序成功连接PostgreSQL数据库了，以后的文章将接着介绍libpq的其他函数，诸如数据库查询函数等等。