Hacker News 13小时前 · 2026-11-22 07:24:57 · 12 阅读
使用 Go 语言编写 PostgreSQL 扩展:gopgext 框架介绍
gopgext 基于 TinyGo,通过纯 Go 代码构建 PostgreSQL 扩展。在函数上方标注 //gopgext:function 注释,该函数即自动转换为 SQL 函数;gopgext 会负责生成 C 语言胶水代码、安装脚本及控制文件。
纯 Go 编写
项目由纯 Go 文件组成,可直接使用标准库:fmt、regexp、encoding/json、crypto/*、映射、泛型、迭代器以及 defer/recover。
类型映射至 SQL
字符串、数字、数组、NULL、集合、行、时间戳、UUID 和 JSON 可映射为相应的 SQL 类型。你还可以在 Go 中自定义数据类型和复合类型。
查询与错误处理
通过 SPI 执行 SQL,携带 SQLSTATE 代码返回错误,支持日志记录、读取配置项,并能响应查询取消请求。
超越函数
可编写触发器、聚合函数、GiST、GIN、SP-GiST 和 BRIN 操作符类、索引访问方法、外部数据包装器以及查询钩子。
通过 contrib 验证
PostgreSQL contrib 模块的移植版本(如 pgcrypto、hstore、pg_stat_statements、cube 等)均已通过上游回归测试。
安全共存
多个 Go 扩展可加载于同一后端进程中。PostgreSQL 错误不会穿透 Go 调用栈,且结果数据会复制至 PostgreSQL 内存中以确保安全。
Hello, world#
package main
import (
"strings"
"gopgext/pg"
)
// Hello returns a greeting for name.
//
//gopgext:function immutable parallel=safe
func Hello(name string) string {
return "Hello, " + name + "!"
}
// Shout upper-cases s. An empty string raises an error.
//
//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() {} // runs once per backend, when PostgreSQL loads the library
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 target 和运行时层,C 运行时由宿主机构建系统编译(这里用 PGXS,那边用 kbuild),再配合生成的胶水代码。
原始来源: Hacker News