开发者生态
morning
Go 中的 PostgreSQL 扩展
摘要
PostgreSQL extensions in Go gopgext builds PostgreSQL extensions from plain Go code, using TinyGo. Mark a function with //gopgext:function and it becomes a SQL function: gopgext writes the C glue, the...
and
gopgext
the
PostgreSQL
function
SQL
string
return
Hello
extensions
2026-11-22
1 阅读
约5分钟阅读
valyala
字号:
Go 中的 PostgreSQL 扩展 gopgext 使用 TinyGo 从纯 Go 代码构建 PostgreSQL 扩展。用 //gopgext:function 标记一个函数,它就变成一个 SQL 函数:gopgext 编写 C 胶水、安装脚本和控制文件。开始使用 文档 GitHub 实验性 gopgext 是实验性的。不要在生产中使用它:生成的代码中的错误或 Go 运行时在服务器内部运行,可能会导致服务器崩溃或损坏数据,并且 API 和生成的 SQL 可能会更改,恕不另行通知。 Just Go 项目是普通的 Go 文件。标准库的工作原理: fmt 、 regexp 、coding/json 、 crypto/* 、maps、generics、iterators、 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 返回名字的问候语。 // //gopgext:function immutable parallel=safe func Hello ( name string ) string { return "Hello, " + name + "!" } // 喊大写 s.空字符串会引发错误。 // //gopgext:函数不可变并行=安全 func Shout ( s string ) ( string , error ) { if s == "" { return "" , pg . Errorf(pg.CodeInvalidParameterValue,“没什么可喊的”)}返回字符串。 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 # --------------- #你好,世界!本教程将逐步介绍它。兄弟项目 # gopgext 使用与 gokm 相同的方法,它从 Go 构建 Linux 内核模块:主机的自定义 TinyGo 目标和运行时层,由主机自己的构建系统(这里是 PGXS,那里是 kbuild)编译的 C 运行时,并生成胶水。
这篇文章对您有帮助吗?
订阅66必读
每日精选科技资讯,直达你的邮箱