PostgreSQL 7.2 Documentation＞ ecpg -- 追寻梦想＞编程乐园＞数据库

Synopsis

ecpg [-v] [-t] [-I include-path ] [-o outfile ] file ...

输入

ecpg 接受下面命令行参数：

-v: 打印版本信息．
-t: 关闭自动提交模式．在这种模式象，每个查询都自动提交，除非它是包围在一个明确的事务块中．在缺省模式下，查询只是在发出 exec sql commit 的时候提交．
-I include-path: 声明一个附加的包含路径．缺省是 . (当前目录)， /usr/local/include ， PostgreSQL 包含路径是在编译时定义的（缺省： /usr/local/pgsql/include ）和 /usr/include ．
-o outfile: 声明 ecpg 应该把它的所有输出写到outfile 里．如果没有给出这个选项，则写到 name .c ，假设输入文件是 name .pgc ．如果输入文件有预期的 .pgc 后缀，那么输出文件将在输入文件后附加 .pgc ．
file: 要处理的文件．

输出

ecpg 将创建一个文件或者写到 标准输出（stdout） ．

返回值: 成功完成后， ecpg 给 shell 返回一个 0，如果出错返回非零．

语法

库

预处理器将包含两个目录到源文件里：

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

变量声明

在 ecpg 源程序里的变量声明必须前导：

EXEC SQL BEGIN DECLARE SECTION;

类似的，变量声明段必须以下面语句结束：

EXEC SQL END DECLARE SECTION;

注意: 在 2.1.0 以前，每个变量都必须在一个独立的行里．到了 2.1.0，可以在一行里定义多个变量：
char  foo(16), bar(16);

错误控制

SQL 通讯区定义如下：

EXEC SQL INCLUDE sqlca;

注意: sqlca 是小写．尽管可以使用 SQL 传统，也就是说，利用大写字符来区分嵌入的 SQL 和 C 语句，而sqlca （它包含 sqlca.h 头文件）必须小写．这是因为 EXEC SQL 前缀表明这个头文件将被 ecpg 分析． ecpg 区分大小写地检查头文件（SQLCA.h 将不会被找到．）考虑大小写后， EXEC SQL INCLUDE 还可以包含其他头文件．

sqlprint 命令和EXEC SQL WHENEVER 语句一起使用可以打开整个程序的错误控制：

EXEC SQL WHENEVER sqlerror sqlprint;

和

EXEC SQL WHENEVER not found sqlprint;

注意: 些 并不是 EXEC SQL WHENEVER 语句全部用法的例子．其用法的更多的例子可以在 SQL 手册里找到（例如, Groff 和 Weinberg 的 The LAN TIMES Guide to SQL ）．

与数据库服务器联接

一种联接使用下面语句：

EXEC SQL CONNECT TO 

dbname

;

这里数据库名称没有用引号引起．在 2.1.0 以前，数据库的名称要求被单引号引起．

在联接语句里声明服务器名和端口名也同样可以．语法是：



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;

单字段选择：

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

使用游标选择：

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;

ecpg

Name

Synopsis

输入

输出

描述

用法

为编译过程预编译

编译和链接

语法

库

变量声明

错误控制

与数据库服务器联接

查询

注意