ecpg
描述 ecpg 是供 C 程序使用的嵌入式 SQL 预处理器。它会把嵌入了 SQL 语句的 C 程序转换成普通 C 代码，方法是将 SQL 调用替换为特殊的函数调用。生成的输出文件随后可以由任何 C 编译器工具链处理。 ecpg 会将命令行中给出的每个输入文件转换成对应的 C 输出文件。若输入文件名没有任何扩展名，则假定其扩展名为 .pgc 。随后会把该文件的扩展名替换为 .c ，以构造输出文件名。不过，也可以用 -o 选项覆盖输出文件名。 如果输入文件名只是 - ， ecpg 就会从标准输入…
当前查看 PostgreSQL 18。
中文定义与说明
命令行工具 ecpg [ option ...] file ...。
同版本中文手册节选
描述
ecpg 是供 C 程序使用的嵌入式 SQL 预处理器。它会把嵌入了 SQL 语句的 C 程序转换成普通 C 代码，方法是将 SQL 调用替换为特殊的函数调用。生成的输出文件随后可以由任何 C 编译器工具链处理。
ecpg 会将命令行中给出的每个输入文件转换成对应的 C 输出文件。若输入文件名没有任何扩展名，则假定其扩展名为.pgc。随后会把该文件的扩展名替换为
.c，以构造输出文件名。不过，也可以用 -o 选项覆盖输出文件名。
如果输入文件名只是-，ecpg 就会从标准输入读取程序（并写到标准输出，除非使用 -o 覆盖该行为）。
本参考页不描述嵌入式 SQL 语言。有关该主题的更多信息，见第 34 章。
选项
ecpg 接受以下命令行参数：
-c自动从 SQL 代码生成某些 C 代码。目前，这适用于
EXEC SQL TYPE。-Cmode设置兼容模式。
mode可以是INFORMIX、INFORMIX_SE，或ORACLE。-Dsymbol[=value]定义一个预处理器符号，等效于
EXEC SQL DEFINE指令。如果未指定value，则该符号会被定义为值1。-h处理头文件。指定该选项时，输出文件扩展名变为
.h而不是.c，默认输入文件扩展名也变为.pgh而不是.pgc。此外，还会强制启用-c选项。-i也解析系统包含文件。
-Idirectory指定一个附加的包含文件搜索路径，用于查找通过
EXEC SQL INCLUDE包含的文件。默认路径依次为.（当前目录）、/usr/local/include、编译时定义的 PostgreSQL 包含文件目录（默认：/usr/local/pgsql/include），以及/usr/include。-ofilename指定
ecpg应将全部输出写入给定的filename。写成-o -可将全部输出发送到标准输出。-roption选择运行时行为。
option可以是下列之一：no_indicator不使用指示符，而改用特殊值表示空值。历史上曾有数据库采用这种方式。
prepare在使用前预备所有语句。libecpg 会维护一个已预备语句的缓存；如果某条语句再次执行，就会复用它。若缓存已满，libecpg 会释放使用次数最少的语句。
questionmarks出于兼容性原因，允许使用问号作为占位符。这在很久以前曾是默认行为。
-t打开事务自动提交。在此模式下，除非 SQL 命令位于显式事务块中，否则每条 SQL 命令都会自动提交。在默认模式下，只有发出
EXEC SQL COMMIT时才会提交命令。-v打印附加信息，包括版本和包含文件搜索路径。
--version打印 ecpg 版本并退出。
-?--help显示关于 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_ind
- 手册中的可执行程序
- ecpg
- 程序版本
- 18.6
- 参考清单
- 客户端程序
- 选项定义组
- 12
用法
ecpg [ option ...] file ...手册中的选项
| 选项与参数 | 说明 |
|---|---|
| -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 | 选择运行时行为。选项可以是下列值之一： |
| -t | 打开事务自动提交。在此模式下，除非 SQL 命令位于显式事务块中，否则每条 SQL 命令都会自动提交。在默认模式下，只有发出 EXEC SQL COMMIT 时才会提交命令。 |
| -v | 打印附加信息，包括版本和包含文件搜索路径。 |
| --version | 打印 ecpg 版本并退出。 |
| -? --help | 显示关于 ecpg 命令行参数的帮助信息，并退出。 |
文档与源码
来源构建
- 版本
- 18.6
- 构建
- https://ftp.postgresql.org/pub/source/v18.6/postgresql-18.6.tar.bz2
- 来源指纹
ee8d1a3612338fd9adf250730cb640fcc5233b5491337cc00a316a44e3a0b9f8
版本比较
PostgreSQL 17 → 18: 无变化。
比较已记录的接口与属性，排除来源指纹和构建元数据。某个样本中没有记录，不能据此判断实际引入或移除的版本。
相关条目
导出 JSON · 返回命令行工具 · 收录范围为 PostgreSQL 10 至 20；最早采样版本不一定是实际引入版本。