pgsql.cc 提供对 postgresql.org 官网内容的中文翻译，由 Pigsty 团队维护。
ecpg — embedded SQL C preprocessor
ecpg [option...] file...
ecpg是供 C 程序使用的嵌入式 SQL 预处理器。它会把嵌入了 SQL 语句的 C 程序转换成普通 C 代码，方法是将 SQL 调用替换为特殊的函数调用。生成的输出文件随后可以由任何 C 编译器工具链处理。
ecpg 会把命令行上给出的每个输入文件转换为对应的 C 输出文件。输入文件最好带有扩展名 .pgc，这种情况下会用 .c 替换该扩展名来确定输出文件名。如果输入文件的扩展名不是 .pgc，则通过在整个文件名后追加 .c 来计算输出文件名。也可以使用 -o 选项覆盖输出文件名。
本参考页不描述嵌入式 SQL 语言。有关该主题的更多信息，见第 33 章。
ecpg 接受以下命令行参数：
-c自动从 SQL 代码生成某些 C 代码。目前，这适用于EXEC SQL TYPE。
-C mode设置兼容模式。mode可以是INFORMIX或INFORMIX_SE。
-D symbol定义一个 C 预处理器符号。
-i也解析系统 include 文件。
-I directory指定一个附加的 include 路径，用于查找通过EXEC SQL INCLUDE包含的文件。默认路径依次为 .（当前目录）、 /usr/local/include、 在编译时定义的PostgreSQL include 目录（默认： /usr/local/pgsql/include），以及 /usr/include。
-o filename指定ecpg应将全部输出写入给定的filename。
-r option选择运行时行为。option 可以是以下值之一：
no_indicator不使用指示器，而改用特殊值表示空值。历史上曾有数据库采用这种方式。
prepare在使用前预备所有语句。libecpg会维护一个已预备语句的缓存；如果某条语句再次执行，就会复用它。若缓存已满，libecpg会释放使用次数最少的语句。
questionmarks出于兼容性原因，允许使用问号作为占位符。这在很久以前曾是默认行为。
-t打开事务自动提交。在此模式下，除非 SQL 命令位于显式事务块中，否则每条 SQL 命令都会自动提交。在默认模式下，只有发出EXEC SQL COMMIT时才会提交命令。
-v打印附加信息，包括版本和 include 路径。
--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
译文有误、术语不当或页面显示问题，请到译文仓库 pgsty/pgdoc 报告译文问题。 英文原文本身的问题，请在当前版本的对应页面向上游反馈；上游不再修订已结束维护的版本。