c - 什么是链接 Postgres 服务器端 C 函数的适当库

Question

我正在尝试在 Ubuntu 14.04 平台上为 Postgres 9.5 编译一些 C 扩展。

在我的例子中，我想编写我的 C 代码并首先将其编译为一个独立的可执行文件(正如您从下面的 Makefile 中看到的那样)。这是因为我也在使用 NumPy API 并编写将 Postgres ArrayType 数组转换为 NumPy PyArray 对象的函数，然后使用一些 NumPy 数组函数。要获得正确的细节、正确地释放 NpyIter 对象等非常棘手，所以我肯定需要编译、运行、观察错误并测试所有 before 最终确定细节关于库是如何为最后一部分构建的，我在 Postgres 中说 CREATE EXTENSION。

编译时，我得到几个 undefined reference问题，例如:

tmp.c:(.text+0x2d6): undefined reference to `get_typlenbyvalalign'
tmp.c:(.text+0x346): undefined reference to `deconstruct_array'
tmp.c:(.text+0x41f): undefined reference to `DatumGetFloat8'
tmp.c:(.text+0x4ae): undefined reference to `pfree'
tmp.c:(.text+0x4ba): undefined reference to `pfree'

这些是来自 Postgres C API 的服务器端函数，但是有大量的谷歌搜索和大量的 pgxs 我不知道如何获取后端 Postgres 库的名称或路径我无法链接。

几乎所有的搜索都提到了 libpq，但是这些函数没有在那个客户端 API 库中定义，所以我正在寻找其他东西。

作为引用，这是我当前使用的 Makefile。包含 pg_config --libdir 中的库目录也一定是不正确的，因为它不会导致 undefined reference 错误发生任何变化。

INCLUDEDIRS := -I.
INCLUDEDIRS += -I/usr/include/python2.7
INCLUDEDIRS += -I/home/username/anaconda/lib/python2.7/site-packages/numpy/core/include
INCLUDEDIRS += -I$(shell pg_config --includedir-server)
INCLUDEDIRS += -I$(shell pg_config --includedir)

LIBS := -L$(shell pg_config --libdir)
LIBS += -lpython2.7

tmp: tmp.c Makefile
    gcc tmp.c -o tmp $(INCLUDEDIRS) $(LIBS)

pg_config --libdir 的输出是:

user@computer:~/programming$ pg_config --libdir
/usr/lib/x86_64-linux-gnu

在该库目录中，我还找到了 libpgcommon，当我将它添加到 Makefile 时，一些 undefined reference 消失了，但不是全部。这些仍然存在:

tmp.c:(.text+0x2d6): undefined reference to `get_typlenbyvalalign'
tmp.c:(.text+0x346): undefined reference to `deconstruct_array'
tmp.c:(.text+0x41f): undefined reference to `DatumGetFloat8'

因此 pfree 是通过与 libpgcommon 链接找到的，但没有别的。

进一步挖掘，在 postgres.h 内部，我可以看到 DatumGetFloat8 宏的定义位置(第 662 行):

#ifdef USE_FLOAT8_BYVAL
extern float8 DatumGetFloat8(Datum X);
#else
#define DatumGetFloat8(X) (* ((float8 *) DatumGetPointer(X)))
#endif

因此，一定是 Postgres 的安装方式使用了 USE_FLOAT8_BYVAL 标志。那是标准吗？您是否希望从一个普通的 Postgres 安装中使用 package repos 为流行的操作系统(如 Ubuntu)安装？

鉴于此，DatumGetFloat8 是 extern 的其他源代码或库是什么？例如，在 Google 上搜索“postgres DatumGetFloat8”几乎看不到任何信息。我能找到的最好的是 message thread from 2011陈述(不确定是否正确):

A missing reference to DatumGetFloat8 implies that the server was built
with float8 pass by value and pljava was built with float8 pass by
reference.

(pljava 位与我无关)。

Answer 1

PostgreSQL 扩展是一个共享库而不是一个独立的可执行文件，所以你必须使用 -shared -fpic -o tmp.so在你的生成文件中。不要链接 -lpq或 -lpgcommon .

然后gcc不会提示 undefined reference ——这些将通过可执行文件 postgres 解决当共享库加载到 PostgreSQL 时，使用 SQL 命令 LOAD或者调用使用该库定义的 PostgreSQL C 函数时。

当然你必须使用相同的-D在构建时定义为 PostgreSQL 服务器，例如 USE_FLOAT8_BYVAL在两者中都设置或取消设置。否则，您的扩展程序可能无法加载或以有趣的方式崩溃。
(既然你在问:按值传递 float8 并没有什么不好；如果你的体系结构支持它，它实际上更有效。如果定义了 DatumGetFloat8，则 postgres 在 USE_FLOAT8_BYVAL 中定义和导出。)

为了让这一切变得简单，最好使用 PostgreSQL 扩展构建基础设施 PGXS .这将为您解决所有这些问题。

您所要做的就是创建一个合适的 Makefile ，在你的情况下它可能很简单

MODULES = tmp

PG_CONFIG = pg_config
PGXS := $(shell $(PG_CONFIG) --pgxs)
include $(PGXS)

然后运行make和 make install ，您就可以开始了!

由于您的问题是测试和调试使用 NumPy API 的代码，因此您应该模块化您的 PostgreSQL 扩展，这样您就可以更轻松地做到这一点。例如，您可以写 numpy.c其中包含访问该 API 和 pgxs.c 的所有代码其中包含 PostgreSQL 扩展代码并调用 numpy.c 中的函数.
然后就可以写专门的测试代码，链接numpy.o测试您的 NumPy 函数。