使用libpq调用PostgreSQL的自定义函数

　　在我的项目中，连接oracle数据库并执行各种增删改查操作，主要是通过oracle的存储过程，这比直接执行SQL语句要简单并灵活多变。因为项目需要，要迁移到PostgreSQL下，因为考虑到各个平台的兼容性，采用libpq库来达到目的，在开发的过程中碰到了一些问题，在这里记录一下。

　　业务需求：pg中有个照片表，需要将照片信息及数据插入到该表中。并可能伴随增删改查动作。本节只处理插入操作。

　　照片表创建：

CREATE TABLE ist_image
(
  isc_imgid bigint NOT NULL,
  isc_imgname character varying(64),
  isc_updatetime timestamp without time zone,
  isc_id bigint, -- 插入顺序编号(由序列生成)
  isc_imgdata bytea,
  CONSTRAINT ist_image_pkey PRIMARY KEY (isc_imgid)
)

　　自定义函数创建：

create or replace function func_insertimage(in nImgID bigint, in szImgName varchar, in pImgData bytea) 
returns integer     --必须有返回值
as 
$$
begin
    insert into ist_image(isc_imgid, isc_imgname, isc_updatetime, isc_id, isc_imgdata) 
    values(nImgID, szImgName, now()::timestamp(0), nextval('iss_seq_isc_id'), pImgData);
    return 0;
end;
$$
language plpgsql;

　　照片数据结构：

class ImageInfo {
public:
    __int64        nImgNumber;
    char        szImgName[64];
    int            nImgDataLen;
    unsigned char*    pImgData;
}

　　插入函数：

//注意该函数是有BUG的
unsigned long long htonll(unsigned long long val) {  
    return (((unsigned long long )htonl((int)((val << 32) >> 32))) << 32) | (unsigned int)htonl((int)(val >> 32));   
}

int GP_TestInsert(deque<ImageInfo>& deqImages, char* szConnStr) {
    int nParamNum = 3;                    //参数个数
    int paramLens[3] = {0};                //参数长度
    int paramFormats[3] = {1, 1, 1};    //参数是二进制格式(1表示二进制格式 0表示文本格式)
    int nReturnForm = 0;                //返回值是文本格式
    unsigned long long ullHID = 0, ullNID = 0;

    //函数调用语句
    TCHAR szSQL[1024] = {0};
    _stprintf_s(szSQL, 1024, _T("select func_insertimage($1::bigint, $2::character varying, $3::bytea)"));
    
    //连接GP数据库
    PGConn* pConn = PQconnectdb(szConnStr);
    if (CONNECTION_OK != PQstatus(pConn)) {
        printf("GP_TestInsert Connect failed. ErrMsg: %s", PQerrorMessage(pConn));
        return -1;
    }

    //开始批量插入事务(显式BEGIN会开始一个事务)
    PGresult* pRes = PQexec(pConn, "BEGIN");
    if (PQresultStatus(pRes) != PGRES_COMMAND_OK) {
        printf("GP_TestInsert Exec BEGIN command failed. ErrMsg: %s", PQerrorMessage(pConn));
        PQclear(pRes);
        return -1;
    }
    PQclear(pRes);    //任何时候不再需要 PGresult 时，应该PQclear它来避免内存泄露

    //循环插入数据
    for (deque<ImageInfo>::iterator it = deqImages.begin(); it != deqImages.end(); ++it) 
    {
        ullHID = (unsigned long long)(it->nImgNumber);
        ullNID = htonll(ullHID);

        //value
        const char* const pszParamValue[3] = { (char*)&ullNID, 
                                                it->szImgName, 
                                                (char*)it->pImgData };

        //Length
        paramLens[0] = sizeof(__int64);
        paramLens[1] = (int)strlen(it->szImgName);    //字符串类型长度要注意
        paramLens[2] = it->nImgDataLen;

        //execse
        pRes = PQexecParams(pConn, szSQL, 3, NULL, (const char**)pszParamValue, paramLens, paramFormats, nReturnForm);
        ExecStatusType resState = PQresultStatus(pRes);
        if (PGRES_TUPLES_OK != resState || strcmp(PQgetvalue(pRes, 0, 0), "0") != 0) {
            printf("GP_TestInsert Exec function failed. ErrCode: %d ErrInfo: %s ErrDesc: %s"), 
                resState, PQresStatus(resState), PQresultErrorMessage(pRes));
            return -1;
        }

        PQclear(pRes);
    }

    //结束事务(做完此步才会进行commit)
    pRes = PQexec(pConn, "END");
    PQclear(pRes);

    return 0;
}

　　这里面有几个要注意的地方：

　　1.每次连接、执行SQL语句要注意检查状态，判断是否执行成功；

　　2.对于整形数据的插入，要进行字节序转换，并根据整形结构的长度区别使用不同的字节序转换函数；

　　3.PostgreSQL数据库好像是默认开启AutoCommit的，若不想其自动commit，可以采用以下两种办法：

　　　　1）关闭数据库的自动commit属性，不过这种方式会导致管理时，出现一些烦人的提示；

　　　　2）每次显式调用BEGIN命令，一个事务(很多次条语句执行过后)结束后，执行END命令来commit，这种方式更灵活，个人更喜欢这种方式；

　　4.任何时候不再需要PGresult时，应该调用PQclear来清理它，避免内存泄露，具体请参见libpq说明文档；

　　当然，使用insert方式插入数据，对于PostgreSQL来说，并不是高效的方式，这里只是用这个例子来简单说明使用libpq库调用自定义函数的方式，后续再补充使用更高效方式来插入数据的例子，对于PostgreSQL来说，我也仅仅是初学者，若文中有错误烦请指正。