PostgreSQL ecpg
ecpg — 嵌入式 SQL C 预处理器
大纲
ecpg
[option
...] file
...
描述
ecpg
是用于 C 程序的嵌入式 SQL 预处理器。它通过将 SQL 调用替换为特殊函数调用把带有嵌入式 SQL 语句的 C 程序转换为普通 C 代码。输出文件可以被任何 C 编译器工具链处理。
ecpg
将把命令行中给出的每一个输入文件转换为相应的 C 输出文件。 如果输入文件名没有任何扩展名,则假定为.pgc
。文件扩展名将由 .c
替换以构造输出文件名。 但是输出文件名可以使用-o
选项覆盖。
如果输入文件名只是-
,ecpg
从标准输入 读取程序(并写入标准输出,除非用-o
重写)。
这个参考页没有描述嵌入式 SQL 语言。关于该主题请参考第 35 章。
选项
ecpg
接受下列命令行参数:
-c
-
自动从 SQL 代码生成确定的 C 代码。当前,这对
EXEC SQL TYPE
起效。 -C
mode
-
设置一个兼容性模式。
mode
可以是INFORMIX
,INFORMIX_SE
或ORACLE
。 -D
symbol
-
定义一个 C 预处理器符号。
-h
-
处理头文件。指定此选项后,输出文件扩展名变为
.h
而不是.c
,默认输入文件扩展名为.pgh
而不是.pgc
。此外,将强制启用-c
选项。 -i
-
分析系统也包括文件。
-I
directory
-
指定一个额外的包括路径,用来寻找通过
EXEC SQL INCLUDE
包括的文件。默认值是.
(当前目录)、/usr/local/include
、在编译时定义的PostgreSQL包括目录(默认:/usr/local/pgsql/include
)以及/usr/include
。 -o
filename
-
指定
ecpg
应该将它的所有输出写到给定的filename
。 写-o-
将所有输出发送到标准输出。 -r
option
-
选择运行时行为。
option
可以是下列之一:no_indicator
-
不使用指示器而使用特殊值来表示空值。历史上曾有数据库使用这种方法。
prepare
-
在使用所有语句之前准备它们。libecpg 将保持一个预备语句的缓冲并当语句再被执行时重用该语句。如果缓冲满了,libecpg 将释放最少使用的语句。
questionmarks
-
为兼容性原因允许使用问号作为占位符。在很久以前这被用作默认值。
-t
-
打开事务的自动提交。在这种模式下,每一个 SQL 命令会被自动提交,除非它位于一个显式事务块中。在默认模式中,命令只有当
EXEC SQL COMMIT
被发出时才被提交。 -v
-
打印额外信息,包括版本和“包括”路径。
--version
-
打印ecpg版本并退出。
-?
--help
-
显示关于ecpg命令行参数的帮助并退出。
注解
在编译预处理好的 C 代码文件时,编译器需要能够找到PostgreSQL包括目录中的ECPG头文件。因此,在调用编译器时,你可能必须使用-I
选项(例如,-I/usr/local/pgsql/include
)。
使用带有嵌入式 SQL 的 C 代码的程序必须被链接到libecpg
库,例如使用链接器选项-L/usr/local/pgsql/lib -lecpg
。
适合于安装的这些目录的值可以使用pg_config找到。
例子
如果你有一个名为prog1.pgc
的嵌入式 SQL C 源文件,你可以使用下列命令序列创建一个可执行程序:
ecpg prog1.pgc
cc -I/usr/local/pgsql/include -c prog1.c
cc -o prog1 prog1.o -L/usr/local/pgsql/lib -lecpg