[笔记][Postgres]libpq C API学习笔记

1.libpq简述

   libpq是postgres提供的C接口函数库，允许客户端程序向postgres数据库服务器发送查询请求并返回查询结果。

2.libpq使用前准备

   使用libpq的程序必须包含“libpq-fe.h”头文件，并链接libpq.lib库文件。

3.libpq常用函数说明

   3.1 数据库连接函数

   3.1.1 PQconnectdb 与数据库服务器建立一个新的连接

            函数原型：PGconn* PQconnectdb(const char* conninfo);

    参数说明：conninfo是一个用于描述数据库连接参数的字符串（以空格为分隔符），例如：“hostaddr=192.168.1.2 port=5432 dbname=mydb user=postgres password=mypass”.其中常用关键字有host,hostaddr,port,dbname,user,password,sslmode等

            返回值：   PGconn是一个用于记录postgres连接状态的指针。函数成功执行时返回一个非空的指针，并可以使用PQstatus函数查询连接是否成功。

   3.1.2 PQfinish 关闭与数据库服务器的连接，并释放PGconn的内存

           函数原型： void PQfinish(PGconn* conn);

           说明：即使数据库连接失败，也要调用PQfinish函数以释放PGconn的内存；PQfinish调用之后不能再使用PGconn对象。         

  3.2 连接状态函数

  3.2.1 PQstatus 返回连接状态

          函数原型： ConnStatusType PQstatus(const PGconn* conn);

          返回值： ConnStatusType