为编译做预处理

嵌入式 SQL 源文件在编译之前必须先做预处理：

ecpg [ -d ] [ -o file ] file.pgc
    

其中可选的 -d 标志打开调试。.pgc 扩展名是表示 ecpg 源的一种随意约定。

你可能想把预处理器的输出重定向到一个日志文件。

编译和链接

假定 Postgres 的可执行文件位于 /usr/local/pgsql，你需要这样编译和链接预处理后的源文件：

gcc -g -I /usr/local/pgsql/include [ -o file ] file.c -L /usr/local/pgsql/lib -lecpg -lpq
    

库

预处理器会在源文件开头加上两条指令：

#include <ecpgtype.h>
#include <ecpglib.h>

变量声明

在 ecpg 源代码中声明的变量必须以以下内容开头：

EXEC SQL BEGIN DECLARE SECTION;

类似地，变量声明节必须以以下内容结束：

EXEC SQL END DECLARE SECTION;

char  foo(16), bar(16);
      

错误处理

SQL 通信区用以下方式定义：

EXEC SQL INCLUDE sqlca;

sqlprint 命令与 EXEC SQL WHENEVER 语句一起使用，在整个程序中打开错误处理：

EXEC SQL WHENEVER sqlerror sqlprint;

和

EXEC SQL WHENEVER not found sqlprint;

连接到数据库服务器

使用下面的语句连接数据库：

EXEC SQL CONNECT TO dbname;

其中数据库名不带引号。在 2.1.0 版之前，数据库名必须放在单引号中。

也可以在 connect 语句中指定服务器名和端口名。语法是：

dbname[@server][:port]
    

或者

<tcp|unix>:postgresql://server[:port][/dbname][?options]
    

查询

一般来说，其他应用（如 psql）可接受的 SQL 查询都可以嵌入到你的 C 代码中。下面是一些示例。

创建表：

EXEC SQL CREATE TABLE foo (number int4, ascii char(16));
EXEC SQL CREATE UNIQUE index num1 on foo(number);
EXEC SQL COMMIT;

插入：

EXEC SQL INSERT INTO foo (number, ascii) VALUES (9999, 'doodad');
EXEC SQL COMMIT;

删除：

EXEC SQL DELETE FROM foo WHERE number = 9999;
EXEC SQL COMMIT;

单行 SELECT：

EXEC SQL SELECT foo INTO :FooBar FROM table1 WHERE ascii = 'doodad';

使用游标的 SELECT：

EXEC SQL DECLARE foo_bar CURSOR FOR
    SELECT number, ascii FROM foo
    ORDER BY ascii;
EXEC SQL FETCH foo_bar INTO :FooBar, DooDad;
...
EXEC SQL CLOSE foo_bar;
EXEC SQL COMMIT;

更新：

EXEC SQL UPDATE foo
    SET ascii = 'foobar'
    WHERE number = 9999;
EXEC SQL COMMIT;