↑↓ 选择↵ 打开⌫ 切换范围完整搜索

PG.CENTER 连接 PostgreSQL 文档、百科与生态知识。由 Pigsty 维护。

支持中的版本: 当前版本 (18) / 17 / 16 / 15 / 14
开发中的版本: 19 / 20devel
已结束支持的版本: 13 / 12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4 / 8.3 / 8.2 / 8.1 / 8.0 / 7.4 / 7.3
历史版本。 PostgreSQL 7.3 已结束支持。 请参阅 当前版本手册.

4.8. 处理嵌入式 SQL 程序 #

现在你已经知道如何编写嵌入式 SQL C 程序了,可能还想知道如何编译它们。编译之前,要先用嵌入式 SQL C 预处理器处理文件,它把你使用的 SQL 语句转换成特殊的函数调用。编译之后,必须与一个包含所需函数的特殊库链接。这些函数从参数中获取信息,用 libpq 接口执行 SQL 查询,并把结果放到指定用于输出的参数中。

预处理器程序名为 ecpg,它包含在正常的 PostgreSQL 安装中。嵌入式 SQL 程序通常使用扩展名 .pgc 命名。如果你有一个名为 prog1.pgc 的程序文件,只需调用

ecpg prog1.pgc

即可预处理它。这会创建一个名为 prog1.c 的文件。如果你的输入文件不遵循建议的命名模式,可以用 -o 选项显式指定输出文件。

预处理后的文件可以正常编译,例如

cc -c prog1.c

生成的 C 源文件包含来自 PostgreSQL 安装的码头文件,因此如果你把 PostgreSQL 安装在默认不搜索的位置,就必须在编译命令行中加上类似 -I/usr/local/pgsql/include 的选项。

要链接嵌入式 SQL 程序,需要链接libecpg库,例如:

cc -o myprog prog1.o prog2.o ... -lecpg

同样,可能需要在该命令行中添加类似-L/usr/local/pgsql/lib的选项。

如果你使用make来管理一个大工程的构建过程,把下面的隐式规则包括在你的 makefile 中将会很方便:

ECPG = ecpg

%.c: %.pgc
        $(ECPG) $<

ecpg 命令的完整语法详见 PostgreSQL 参考手册。

报告文档问题

阅读 上游文档. 反馈更正前请先核对 当前版本手册.