gopgext позволяет писать расширения PostgreSQL на обычном Go через TinyGo

gopgext позволяет писать расширения PostgreSQL на обычном Go через TinyGo

gopgext, инструмент, который собирает расширения PostgreSQL из обычного кода на Go, используя компилятор TinyGo. Достаточно пометить функцию комментарием //gopgext:function, и она становится SQL-функцией. Всё остальное инструмент делает сам: пишет C-обвязку (glue), установочный скрипт и control-файл расширения.

Проект состоит из обычных файлов на Go. По описанию на странице, работает стандартная библиотека: fmt, regexp, encoding/json, crypto/*, maps, а также дженерики, итераторы и defer/recover. Строки, числа, массивы, NULL, наборы строк, строки таблиц, временные метки, UUID и JSON отображаются в типы SQL; собственные типы данных и составные типы можно описывать прямо в Go. Через SPI можно выполнять SQL-запросы, возвращать ошибки с кодами SQLSTATE, писать в журнал, читать настройки и реагировать на отмену запроса.

Возможности не ограничены функциями: можно писать триггеры, агрегаты, классы операторов GiST, GIN, SP-GiST и BRIN, методы доступа к индексам, обёртки сторонних данных (foreign data wrappers) и хуки запросов. В качестве доказательства зрелости страница заявляет, что порты модулей contrib из состава PostgreSQL (pgcrypto, hstore, pg_stat_statements, cube и другие) проходят регрессионные тесты оригинала.

О безопасном сосуществовании: несколько расширений на Go могут загружаться в одном серверном процессе (backend), ошибки PostgreSQL никогда не «раскручивают» стек через кадры Go, а результаты копируются в память PostgreSQL.

В примере «Hello, world» две функции: Hello возвращает приветствие, Shout переводит строку в верхний регистр и возвращает ошибку pg.Errorf с кодом CodeInvalidParameterValue для пустой строки. Метка immutable parallel=safe задаёт свойства SQL-функции. Порядок работы: gopgext init hello создаёт go.mod и main.go; gopgext install hello собирает и устанавливает файлы hello.so, hello.control и hello--1.0.sql; затем в psql выполняется CREATE EXTENSION hello, и запрос SELECT hello('world') возвращает «Hello, world!». Пошаговый разбор вынесен в отдельный туториал.

На странице также упомянут родственный проект gokm, который собирает модули ядра Linux из Go. Подход тот же: собственная цель (target) и слой рантайма TinyGo для хоста, C-рантайм, который собирается штатной системой сборки хоста (PGXS для PostgreSQL, kbuild для ядра), и генерируемая обвязка.

Ключевые факты

  • gopgext собирает расширения PostgreSQL из обычного Go через TinyGo: функция с пометкой //gopgext:function становится SQL-функцией.
  • Инструмент генерирует C-обвязку, установочный скрипт и control-файл; команды gopgext init и gopgext install, затем CREATE EXTENSION в psql.
  • Помимо функций заявлены триггеры, агрегаты, классы операторов GiST/GIN/SP-GiST/BRIN, методы доступа к индексам, обёртки сторонних данных и хуки запросов.
  • Страница проекта утверждает, что порты модулей contrib (pgcrypto, hstore, pg_stat_statements, cube и др.) проходят регрессионные тесты PostgreSQL.
  • Подход общий с проектом gokm, который собирает модули ядра Linux из Go: свой target для TinyGo, C-рантайм через PGXS и генерируемая обвязка.

Почему это важно

Расширения PostgreSQL обычно пишут на C, а это высокий порог входа и риск ошибок с памятью внутри серверного процесса. gopgext предлагает путь для тех, кто работает на Go: писать функции, триггеры и даже методы доступа к индексам на знакомом языке, а рутину сборки отдать генератору. Отдельно заявлено, что ошибки PostgreSQL не проходят через кадры Go, а результаты копируются в память PostgreSQL, это ответ на главный вопрос о безопасности такого сочетания. Всё это пока описание с самой страницы проекта.

Кому это важно

Разработчикам на Go, которым нужны собственные функции, типы или индексы внутри PostgreSQL. Командам, которые хотят писать расширения без погружения в C-API. Тем, кто следит за экспериментами с TinyGo в нестандартных средах: рядом упомянут родственный проект gokm для ядра Linux.

Как это применить

По описанию на странице: gopgext init hello создаёт каталог с go.mod и main.go; в коде функции помечаются комментарием //gopgext:function (можно задать свойства вроде immutable и parallel=safe); gopgext install hello собирает и устанавливает hello.so, hello.control и hello--1.0.sql; после этого в psql выполняется CREATE EXTENSION hello. Страница отсылает к пошаговому туториалу. Лицензия, поддерживаемые версии PostgreSQL и цены на странице не указаны.

Можно ли доверять

Источник, страница самого проекта, поэтому все утверждения о совместимости и прохождении регрессионных тестов, самоописание, независимых подтверждений в материале нет. Страница не называет автора, организацию, версию или дату выпуска, не приводит замеров производительности или размера бинарных файлов. Список портированных модулей contrib заканчивается многоточием, поэтому неясно, сколько их и проходят ли тесты все.

Риски и подводные камни

Страница не говорит о зрелости для промышленной эксплуатации, об ограничениях TinyGo и о том, какие версии PostgreSQL поддерживаются. Не указана лицензия. Заявленный список работающих пакетов стандартной библиотеки конкретный, но не исчерпывающий для всей библиотеки Go, поэтому код, зависящий от других пакетов, стоит проверять отдельно. Перед использованием в рабочей базе расширения нужно тестировать самостоятельно.