Principe de fonctionnement

gopgext compile du code Go standard en extensions PostgreSQL grâce à TinyGo. L’annotation //gopgext:function indique au générateur de créer le glue C nécessaire, le script d’installation et le fichier de contrôle. Le processus gopgext init crée la structure go.mod et le fichier main.go, puis gopgext install produit le fichier partagé .so, le contrôle .control et le script SQL de création.

Mappage des types et API SQL

Le runtime expose les types Go natifs aux types SQL : chaînes, nombres, tableaux, NULL, ensembles, lignes, timestamps, UUID et JSON sont convertis automatiquement. Les développeurs peuvent également déclarer des types composites ou personnalisés en Go, qui seront traduits en types PostgreSQL. L’accès à l’interface serveur se fait via SPI, permettant d’exécuter des requêtes, de récupérer les paramètres de configuration et de renvoyer des erreurs avec des codes SQLSTATE précis. La gestion du contexte de requête assure la réactivité aux annulations de requêtes.

//gopgext:function immutable parallel=safe
func Hello(name string) string {
    return "Hello, " + name + "!"
}

func Shout(s string) (string, error) {
    if s == "" {
        return "", pg.Errorf(pg.CodeInvalidParameterValue, "nothing to shout")
    }
    return strings.ToUpper(s) + "!", nil
}

Extensions avancées et validation

Au‑delà des fonctions simples, gopgext supporte la création de déclencheurs, d’agrégats, de classes d’opérateurs GiST, GIN, SP‑GiST et BRIN, ainsi que d’accès aux méthodes d’index et de wrappers de données étrangères. La robustesse du projet est démontrée par le port de modules contrib PostgreSQL tels que pgcrypto, hstore, pg_stat_statements ou cube, qui réussissent les tests de régression upstream. Plusieurs extensions Go peuvent être chargées simultanément dans un même backend sans interférence : les erreurs PostgreSQL ne traversent jamais les cadres d’appels Go et les résultats sont copiés dans la mémoire gérée par PostgreSQL.

Contraintes et perspectives

L’ensemble repose sur TinyGo, ce qui limite la compatibilité aux fonctionnalités supportées par ce compilateur (par exemple, certaines parties du runtime Go complet sont absentes). La génération de glue C implique une dépendance au système de construction PGXS, ce qui peut compliquer le déploiement sur des environnements non standard ou des versions PostgreSQL très anciennes. Enfin, le modèle de parallélisme indiqué par parallel=safe repose sur la garantie que le code Go ne partage pas d’état mutable non protégé, faute de quoi des corruptions de mémoire PostgreSQL pourraient survenir. Malgré ces restrictions, gopgext ouvre une voie directe pour exploiter l’écosystème Go dans le contexte PostgreSQL, réduisant le besoin d’écrire du C manuel tout en conservant la performance native attendue des extensions serveur.