2024年C C++最新PostgreSQL【应用 02】扩展SQL之C语言函数（编写、编译、载入(1)，2024年最新建议细读

网上学习资料一大堆，但如果学到的知识不成体系，遇到问题时只是浅尝辄止，不再深入研究，那么很难做到真正的技术提升。

需要这份系统化的资料的朋友，可以添加戳这里获取

一个人可以走的很快，但一群人才能走的更远！不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人，都欢迎加入我们的的圈子（技术交流、学习资源、职场吐槽、大厂内推、面试辅导），让我们一起学习成长！

• • 1.准备
    • • 1.1 开发文档
        • 1.2 工具安装
    • 2.开始
    • • 2.1 编写C语言函数
        • 2.2 编译和链接动态载入的函数

通过使用 PostgreSQL 的 C 函数接口，我们可以编写用 C 语言实现的函数，并将其集成到数据库中。这些函数可以在 SQL 查询中像其他内置函数一样被调用，从而扩展 PostgreSQL 的功能。

C 函数在某些情况下可以提供比 SQL 函数更高的执行效率，因为它们可以直接访问底层系统资源并进行更高级的优化。通过使用 C 函数，我们可以在函数内部实现复杂的算法和逻辑，利用 C 语言的功能和库来提高执行效率。

1.准备

1.1 开发文档

-- 查询数据库版本
SELECT "version"()
-- PostgreSQL 12.12 (Debian 12.12-1.pgdg110+1) on x86\_64-pc-linux-gnu, compiled by gcc (Debian 10.2.1-6) 10.2.1 20210110, 64-bit

根据数据库的版本查看文档：

英文：PostgreSQL: Documentation: 12: 37.10. C-Language Functions

中文：37.10. C 语言函数 (postgres.cn)

1.2 工具安装

# 避免报错1
functionNameFile.c:1:10: fatal error: postgres.h: No such file or directory
    1 | #include "postgres.h"
      |          ^~~~~~~~~~~~
compilation terminated.

# 根据版本进行安装【必备】安装的 postgresql12-devel.x86\_64 的版本要跟数据库保持一致
yum install postgresql12-devel.x86_64
# 问题
Error: Package: postgresql12-devel-12.15-1PGDG.rhel7.x86_64 (pgdg12)
           Requires: llvm-toolset-7-clang >= 4.0.1
# 解决
yum install centos-release-scl-rh
# 再次进行安装

2.开始

2.1 编写C语言函数

要严格按照文档的说明进行编写，创建一个新的文件，例如 func.c，并添加以下内容：

#include "postgres.h"
#include "fmgr.h"

PG_MODULE_MAGIC;

PG\_FUNCTION\_INFO\_V1(add_one);

Datum
add\_one(PG_FUNCTION_ARGS)
{
    int32 arg = PG\_GETARG\_INT32(0);
    PG\_RETURN\_INT32(arg + 1);
}

1. #include "postgres.h"：这是一个预处理指令，用于包含 PostgreSQL 的核心头文件，以便在代码中使用 PostgreSQL 的数据类型、宏和函数。
2. #include "fmgr.h"：这是一个预处理指令，用于包含 PostgreSQL 函数管理器的头文件，提供了函数定义和声明所需的宏。
3. PG_MODULE_MAGIC：这是一个宏，它用于标识模块的版本和兼容性信息。
4. PG_FUNCTION_INFO_V1(add_one)：这是一个宏，用于声明函数的元数据。在这里，它将函数名 add_one 与函数版本号 V1 关联起来。这样 PostgreSQL 就能够正确地识别和处理这个函数。
5. Datum add_one(PG_FUNCTION_ARGS)：这是函数的定义，使用 Datum 作为返回值类型。PG_FUNCTION_ARGS 是一个宏，它展开为一个结构体，包含了函数的参数和返回值信息。
6. int32 arg = PG_GETARG_INT32(0)：这是获取函数参数的值。PG_GETARG_INT32(0) 宏用于从参数列表中获取第一个参数，并将其转换为 int32 类型。这里将获取到的参数值存储在 int32 类型的变量 arg 中。
7. PG_RETURN_INT32(arg + 1)：这是函数的返回语句。它使用 PG_RETURN_INT32 宏将 arg + 1 的结果作为函数的返回值。在这里，函数将输入的整数参数加一后返回。

这段代码的功能很简单：将输入的整数参数加一并作为函数的返回值。

2.2 编译和链接动态载入的函数

Linux环境，其他环境小伙伴儿们自行查看啊：

![img](https://img-blog.csdnimg.cn/img_convert/bee7d639f1ad45b86b6f7a8617c82bf0.png)
![img](https://img-blog.csdnimg.cn/img_convert/093ddc4b47b419e20d9842b895b6bd38.png)

**既有适合小白学习的零基础资料，也有适合3年以上经验的小伙伴深入学习提升的进阶课程，涵盖了95%以上C C++开发知识点，真正体系化！**

**由于文件比较多，这里只是将部分目录截图出来，全套包含大厂面经、学习笔记、源码讲义、实战项目、大纲路线、讲解视频，并且后续会持续更新**

**[如果你需要这些资料，可以戳这里获取](https://bbs.csdn.net/topics/618668825)**

较多，这里只是将部分目录截图出来，全套包含大厂面经、学习笔记、源码讲义、实战项目、大纲路线、讲解视频，并且后续会持续更新**

**[如果你需要这些资料，可以戳这里获取](https://bbs.csdn.net/topics/618668825)**