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