ecpg
ecpg — 嵌入式 SQL C 预处理器
大纲
ecpg [option...] file...
描述
ecpg是供 C 程序使用的嵌入式 SQL 预处理器。它会把嵌入了 SQL 语句的 C 程序转换成普通 C 代码，方法是将 SQL 调用替换为特殊的函数调用。生成的输出文件随后可以由任何 C 编译器工具链处理。
ecpg 会把命令行上给出的每个输入文件转换为对应的 C 输出文件。输入文件最好带有扩展名 .pgc，这种情况下会用 .c 替换该扩展名来确定输出文件名。如果输入文件的扩展名不是 .pgc，则通过在整个文件名后追加 .c 来计算输出文件名。也可以使用 -o 选项覆盖输出文件名。
本参考页不描述嵌入式 SQL 语言。有关该主题的更多信息，见第 29 章。
选项
ecpg接受以下命令行参数：
-c自动从 SQL 代码生成某些 C 代码。目前，这适用于
EXEC SQL TYPE。-Cmode设置兼容模式。
mode可以是INFORMIX或INFORMIX_SE。-Dsymbol定义一个 C 预处理器符号。
-i也解析系统 include 文件。
-Idirectory指定一个附加的 include 路径，用于查找通过
EXEC SQL INCLUDE包含的文件。默认路径依次为.（当前目录）、/usr/local/include、在编译时定义的PostgreSQL include 目录（默认：/usr/local/pgsql/include），以及/usr/include。-ofilename指定
ecpg应将全部输出写入给定的filename。-roption选择一种运行时行为。当前，
option只能是no_indicator。-t打开事务自动提交。在此模式下，除非 SQL 命令位于显式事务块中，否则每条 SQL 命令都会自动提交。在默认模式下，只有发出
EXEC SQL COMMIT时才会提交命令。-v打印附加信息，包括版本和 include 路径。
--help显示命令用法的简要摘要，然后退出。
--version输出版本信息，然后退出。
注解
在编译预处理后的 C 代码文件时，编译器必须能够在PostgreSQL的 include 目录中找到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