ecpg — 嵌入式 SQL C 预处理器
ecpg
[选项
...] 文件
...
ecpg
是 C 程序的嵌入式 SQL 预处理器。它通过用特殊函数调用替换 SQL 调用,将具有嵌入式 SQL 语句的 C 程序转换为常规 C 代码。然后可以使用任何 C 编译器工具链处理输出文件。
ecpg
将命令行上给定的每个输入文件转换为相应的 C 输出文件。如果输入文件名没有任何扩展名,则假定为 .pgc
。文件的扩展名将被 .c
替换以构造输出文件名。但是可以使用 -o
选项覆盖输出文件名。
如果输入文件名只是 -
,ecpg
将从标准输入读取程序(并写入标准输出,除非使用 -o
覆盖)。
此参考页不描述嵌入式 SQL 语言。有关该主题的更多信息,请参见 第 36 章。
ecpg
接受以下命令行参数
-c
从 SQL 代码自动生成某些 C 代码。目前,这适用于 EXEC SQL TYPE
。
-C 模式
设置兼容模式。 模式
可以是 INFORMIX
、INFORMIX_SE
或 ORACLE
。
-D 符号
定义 C 预处理器符号。
-h
处理头文件。指定此选项时,输出文件扩展名变为 .h
而不是 .c
,默认输入文件扩展名变为 .pgh
而不是 .pgc
。此外,-c
选项被强制使用。
-i
同时解析系统包含文件。
-I 目录
指定一个附加的包含路径,用于查找通过 EXEC SQL INCLUDE
包含的文件。默认值为 .
(当前目录)、/usr/local/include
、PostgreSQL 在编译时定义的包含目录(默认值:/usr/local/pgsql/include
)和 /usr/include
,按此顺序。
-o 文件名
指定 ecpg
应将其所有输出写入给定的 文件名
。写入 -o -
以将所有输出发送到标准输出。
-r 选项
选择运行时行为。选项
可以是以下选项之一
no_indicator
不使用指示符,而是使用特殊值来表示空值。历史上有一些数据库使用这种方法。
prepare
在使用所有语句之前准备所有语句。Libecpg 将保留已准备语句的缓存,并在再次执行语句时重复使用该语句。如果缓存已满,libepg 将释放使用最少的语句。
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