ecpg

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