6.3. 如何使用 ecpg

6.3.1. 预编译器

预编译器叫 ecpg ．在安装过后它存放在 PostgreSQL bin/ 目录下面．

6.3.2. 库

ecpg 库叫做 libecpg.a 或 libecpg.so ．另外，该库用了 libpq 库与 PostgreSQL 服务器通讯． 你必须用 -lecpg -lpq 链接你的程序．

库里面有一些方法是"隐藏"的，但是有时候这些方法可能非常有用．

• ECPGdebug(int on , FILE * stream ) 如果第一个参数不为零则打开调试信息． 调试信息记录在 stream ． 大多数 SQL 语句把它的参数和结果记录日志．

  最重要的一个函数， ECPGdo ， 用全部展开的字符串记录所有 SQL 语句的日志， 也就是说，那些带有已插入所有变量的字符串和从 PostgreSQL 服务器来的结果． 这个特性对搜索你的 SQL 语句的错误是非常有用的．

• ECPGstatus() 这个方法/函数在我们与一个数据库联接后返回 TRUE 并且如果没有联接返回 FALSE ．

6.3.3. 错误处理

要检测来自 PostgreSQL 服务器的错误，包含如下一行

exec sql include sqlca;

到你的文件的包含段里．这样做将会定义一个结构和一个象下面一样名为 sqlca 的变量：

struct sqlca
{
 char sqlcaid[8];
 long sqlabc;
 long sqlcode;
 struct
 {
  int sqlerrml;
  char sqlerrmc[70];
 } sqlerrm;
 char sqlerrp[8];
 long sqlerrd[6];
 /* 0: empty                                         */
 /* 1: OID of processed tuple if applicable          */
 /* 2: number of rows processed in an INSERT, UPDATE */
 /*    or DELETE statement                           */
 /* 3: empty                                         */
 /* 4: empty                                         */
 /* 5: empty                                         */
 char sqlwarn[8];
 /* 0: set to 'W' if at least one other is 'W'       */
 /* 1: if 'W' at least one character string         */
 /*    value was truncated when it was               */
 /*    stored into a host variable.                  */
 /* 2: empty                                         */
 /* 3: empty                                         */
 /* 4: empty                                         */
 /* 5: empty                                         */
 /* 6: empty                                         */
 /* 7: empty                                         */
 char sqlext[8];
} sqlca;

如果最后一个 SQL 语句没有发生错误， 那么 sqlca.sqlcode 将是 0 (ECPG_NO_ERROR)．如果 sqlca.sqlcode 小于 0 那么就是发生了某种严重的错误， 象数据库定义与查询定义不一致等．如果大于零则是通常的错误， 比如表不包括所要求的行等．

sqlca.sqlerrm.sqlerrmc 将包含一个字符串描述该错误． 该字符串以源文件的行号结尾。

下面是可能发生的错误：