← 文章 / 数据与数据库
Hacker News 13小时前 · 2026-11-22 07:24:57 · 12 阅读

使用 Go 语言编写 PostgreSQL 扩展:gopgext 框架介绍

gopgext 基于 TinyGo,通过纯 Go 代码构建 PostgreSQL 扩展。在函数上方标注 //gopgext:function 注释,该函数即自动转换为 SQL 函数;gopgext 会负责生成 C 语言胶水代码、安装脚本及控制文件。

快速入门 文档 GitHub实验性特性 gopgext 仍处于实验阶段,请勿在生产环境中使用。生成代码或 Go 运行时中的 Bug 将在服务器内部执行,可能导致服务器崩溃或数据损坏;此外,API 和生成的 SQL 语句可能在不预先通知的情况下发生变更。

纯 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

评论 (0)