
gopgext 用 Go 语言和 TinyGo 构建 PostgreSQL 扩展
来源标题:PostgreSQL Extensions in Go
gopgext 让开发者用纯 Go 代码配合 TinyGo 编写 PostgreSQL 扩展,给函数加上 //gopgext:function 标记即可变成 SQL 函数,C 胶水代码、安装脚本和控制文件都由工具自动生成。项目支持标准库、自定义数据类型、SPI 执行 SQL、触发器、聚合及多种索引操作类,pgcrypto、hstore 等 contrib 模块的 Go 移植版已通过上游回归测试。多个 Go 扩展可加载进同一后端,PostgreSQL 错误不会穿过 Go 栈帧。
以下正文由 AI 翻译自 Hacker News(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。
gopgext 使用 TinyGo 从纯 Go 代码构建 PostgreSQL 扩展。给函数标上 //gopgext:function,它就会变成 SQL 函数:gopgext 会生成 C 胶水代码、安装脚本和控制文件。 一个项目就是普通的 Go 文件。标准库可用:fmt、regexp、encoding/json、crypto/*、maps、泛型、迭代器、defer/recover。 字符串、数字、数组、NULL、集合、行、时间戳、UUID 和 JSON 都会映射到 SQL 类型。你可以在 Go 中定义自己的数据类型和复合类型。 通过 SPI 执行 SQL,用 SQLSTATE 代码返回错误,记录日志,读取设置,并对查询取消保持响应。 编写触发器、聚合、GiST、GIN、SP-GiST 和 BRIN 操作符类、索引访问方法、外部数据包装器和查询钩子。 PostgreSQL contrib 模块(pgcrypto、hstore、pg_stat_statements、cube、…)的移植版通过了上游的回归测试。 多个 Go 扩展可以加载到同一个后端中。PostgreSQL 错误永远不会穿过 Go 栈帧展开,结果会被复制到 PostgreSQL 内存中。 package main import ( "strings" "gopgext/pg" ) // Hello 返回对 name 的问候。 // //gopgext:function immutable parallel=safe func Hello(name string) string { return "Hello, " + name + "!" // Shout 将 s 转为大写。空字符串会引发错误。 // //gopgext:function immutable parallel=safe func Shout(s string) (string, error) { if s == "" { return "", pg.Errorf(pg.CodeInvalidParameterValue, "nothing to shout") return strings.ToUpper(s) + "!", nil func main() {} // 每个后端运行一次,在 PostgreSQL 加载库时执行 gopgext init hello # 创建 hello/go.mod 和 hello/main.go gopgext install hello # 构建 hello.so、hello.control、hello--1.0.sql 并安装它们 psql -c 'CREATE EXTENSION hello' -c "SELECT hello('world')"
hello
---------------
Hello, world!
教程会一步步带你完成整个过程。 gopgext 采用与 gokm 相同的方法,后者从 Go 构建 Linux 内核模块:一个自定义的 TinyGo 目标与宿主机运行时层、一个由宿主机自身构建系统编译的 C 运行时(此处是 PGXS,那里是 kbuild),以及生成的胶水代码。
正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。