Files
archie/internal/infrastructure/postgres/postgres.go
T

97 lines
2.7 KiB
Go

// Package postgres opens archie's PostgreSQL database and applies its schema
// migrations.
package postgres
import (
"context"
"embed"
"errors"
"fmt"
"io/fs"
"github.com/jackc/pgx/v5/pgxpool"
"github.com/jackc/pgx/v5/stdlib"
"github.com/pressly/goose/v3"
"github.com/pressly/goose/v3/lock"
)
// minServerVersion is PostgreSQL 18 in server_version_num form.
const minServerVersion = 180000
//go:embed migrations/*.sql
var migrations embed.FS
// Migrations is the State Store schema, rooted at the migration files.
func Migrations() fs.FS {
sub, err := fs.Sub(migrations, "migrations")
if err != nil {
// Unreachable: the pattern above embeds the directory.
panic(err)
}
return sub
}
// ErrServerTooOld is returned for a server older than PostgreSQL 18.
var ErrServerTooOld = errors.New("postgres: server is older than PostgreSQL 18")
func checkServerVersion(num int) error {
if num < minServerVersion {
return fmt.Errorf("%w (server_version_num %d)", ErrServerTooOld, num)
}
return nil
}
// Open connects a pool to url and refuses a server older than PostgreSQL 18.
func Open(ctx context.Context, url string) (*pgxpool.Pool, error) {
pool, err := pgxpool.New(ctx, url)
if err != nil {
return nil, fmt.Errorf("postgres: open: %w", err)
}
var num int
if err := pool.QueryRow(ctx, "SELECT current_setting('server_version_num')::int").Scan(&num); err != nil {
pool.Close()
return nil, fmt.Errorf("postgres: read server version: %w", err)
}
if err := checkServerVersion(num); err != nil {
pool.Close()
return nil, err
}
return pool, nil
}
// OpenMigrated opens and migrates the pool a service owns its tables in.
// service names the owner in the error an empty database_url produces.
func OpenMigrated(ctx context.Context, url, service string) (*pgxpool.Pool, error) {
if url == "" {
return nil, fmt.Errorf("database_url is required: %s is Postgres-only", service)
}
pool, err := Open(ctx, url)
if err != nil {
return nil, err
}
if err := Migrate(ctx, pool, Migrations()); err != nil {
pool.Close()
return nil, err
}
return pool, nil
}
// Migrate applies the goose migrations in fsys. A session-level advisory lock
// makes processes that start together apply each migration once.
func Migrate(ctx context.Context, pool *pgxpool.Pool, fsys fs.FS) error {
locker, err := lock.NewPostgresSessionLocker()
if err != nil {
return fmt.Errorf("postgres: migration lock: %w", err)
}
db := stdlib.OpenDBFromPool(pool)
defer func() { _ = db.Close() }()
provider, err := goose.NewProvider(goose.DialectPostgres, db, fsys, goose.WithSessionLocker(locker))
if err != nil {
return fmt.Errorf("postgres: migrations: %w", err)
}
if _, err := provider.Up(ctx); err != nil {
return fmt.Errorf("postgres: migrate: %w", err)
}
return nil
}