ecpg — 嵌入式 SQL C 预处理器
ecpg [选项...] 文件...
ecpg 是 C 程序的嵌入式 SQL 预处理器。它将包含嵌入式 SQL 语句的 C 程序转换为正常 C 代码，方法是将 SQL 调用替换为特殊的函数调用。然后，可以用任何 C 编译器工具链处理输出文件。
ecpg 将使用命令行中给定的每个输入文件转换为对应的 C 输出文件。如果输入文件名没有任何扩展名，则假设为 .pgc。文件的扩展名将被 .c 替换，以构造输出文件名。但可以使用 -o 选项覆盖输出文件名。
如果输入文件名只是 -，则 ecpg 从标准输入读取程序（并写入标准输出，除非使用 -o 覆盖）。
此参考页面不描述嵌入式 SQL 语言。有关该主题的更多信息，请参见 第 34 章。
ecpg 接受以下命令行参数
-c从 SQL 代码自动生成某些 C 代码。当前，这适用于 EXEC SQL TYPE。
-C mode设置兼容模式。 mode 可以是 INFORMIX、INFORMIX_SE 或 ORACLE。
-D symbol[=value]定义一个预处理器符号，等效于 EXEC SQL DEFINE 指令。如果未指定 value，则符号被定义为值 1。
-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不使用指示器，而是使用特殊值来表示 null 值。从历史上看，有些数据库使用这种方法。
prepare在使用所有语句之前准备它们。Libecpg 将保留已准备语句的缓存，并在再次执行语句时重复使用语句。如果缓存已满，liecpg 将释放最少使用的语句。
questionmarks出于兼容性原因，允许问号作为占位符。这曾经是 давным давно 的默认选项。
-t启用事务的自动提交。在此模式下，除非在显式事务块中，否则会自动提交每个 SQL 命令。在默认模式下，仅当发出了 EXEC SQL COMMIT 时才会提交命令。
-v打印附加信息，包括版本和“包含”路径。
--version打印 ecpg 版本并退出。
-?--help显示有关 ecpg 命令行参数的帮助，然后退出。
在编译预处理的 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