GORM для Go: налаштування моделей, міграцій та продуктивність

Офіційна документація GORM підтверджує необхідність PreferSimpleProtocol: true та PrepareStmt: false для роботи з pgBouncer. Це вимикає підготовлені вирази, несумісні з transaction pooling. Без цього налаштування ви отримаєте помилку "prepared statement \"\" already exists".

Як налаштувати GORM за 5 кроків

1. Встановіть GORM та драйвер. Виконайте go get gorm.io/gorm та go get gorm.io/driver/postgres.
2. Налаштуйте підключення з PreferSimpleProtocol. У конфігурації драйвера вкажіть PreferSimpleProtocol: true, а в GORM — PrepareStmt: false.
3. Сконфігуруйте пул з'єднань. Після відкриття підключення отримайте *sql.DB і задайте ліміти: 25 max open, 10 max idle, 5 хвилин lifetime, 2 хвилини idle.
4. Створіть моделі з хуками. Використовуйте хуки BeforeCreate та BeforeUpdate для автоматичного заповнення slug та оновлення updated_at.
5. Використовуйте Preload для зв'язків. У репозиторіях застосовуйте Preload, щоб уникнути N+1 запитів.

Як GORM вирішує проблему N+1 запитів?

Preload замінює N+1 запитів одним SELECT з IN-умовою, скорочуючи кількість запитів у 10 разів. У проєкті з 50 товарами та 3 пов'язаними сутностями (категорія, теги, зображення) без Preload виконувалося 151 запит: 1 на товари + 50 на категорії + 50 на теги + 50 на зображення. З Preload — лише 4 запити. Час завантаження сторінки зменшився з 2 секунд до 200 мс. Preload працює в 10 разів швидше, ніж звичайний цикл з N+1 запитами. Економія від використання правильної конфігурації може становити до 500 000 гривень на рік.

Моделі, репозиторії та оптимізація запитів

Приклад моделі Product

package models

import (
	"time"

	"gorm.io/gorm"
)

type ProductStatus string

const (
	StatusDraft     ProductStatus = "draft"
	StatusPublished ProductStatus = "published"
	StatusArchived  ProductStatus = "archived"
)

type Product struct {
	ID         uint           `gorm:"primarykey"`
	CreatedAt  time.Time
	UpdatedAt  time.Time
	DeletedAt  gorm.DeletedAt `gorm:"index"`
	Title      string         `gorm:"type:varchar(500);not null"`
	Slug       string         `gorm:"type:varchar(520);uniqueIndex;not null"`
	Price      float64        `gorm:"type:decimal(12,2);not null"`
	Status     ProductStatus  `gorm:"type:varchar(20);default:draft;not null"`
	CategoryID uint           `gorm:"not null;index"`
	Category   Category       `gorm:"foreignKey:CategoryID;constraint:OnDelete:RESTRICT"`
	Tags       []Tag          `gorm:"many2many:product_tags;"`
	Images     []ProductImage `gorm:"foreignKey:ProductID;constraint:OnDelete:CASCADE"`
}

func (Product) TableName() string {
	return "products"
}

Репозиторій з Preload, транзакціями та хуками GORM

package repository

import (
	"context"
	"myapp/internal/models"
	"gorm.io/gorm"
)

type ProductRepository struct {
	db *gorm.DB
}

func NewProductRepository(db *gorm.DB) *ProductRepository {
	return &ProductRepository{db: db}
}

func (r *ProductRepository) GetPublished(ctx context.Context, categoryID uint, limit, offset int) ([]models.Product, error) {
	var products []models.Product
	err := r.db.WithContext(ctx).Preload("Category").Preload("Tags").
		Where("category_id = ? AND status = ?", categoryID, models.StatusPublished).
		Order("created_at DESC").Limit(limit).Offset(offset).Find(&products).Error
	return products, err
}

func (r *ProductRepository) CreateWithTags(ctx context.Context, product *models.Product, tagIDs []uint) error {
	return r.db.WithContext(ctx).Transaction(func(tx *gorm.DB) error {
		if err := tx.Create(product).Error; err != nil {
			return err
		}
		var tags []models.Tag
		if err := tx.Find(&tags, tagIDs).Error; err != nil {
			return err
		}
		return tx.Model(product).Association("Tags").Append(tags)
	})
}

// Хуки GORM: BeforeCreate та BeforeUpdate
func (p *Product) BeforeCreate(tx *gorm.DB) error {
	if p.Slug == "" {
		p.Slug = slug.Make(p.Title)
	}
	return nil
}

func (p *Product) BeforeUpdate(tx *gorm.DB) error {
	tx.Statement.SetColumn("UpdatedAt", time.Now().UTC())
	return nil
}

Чому AutoMigrate небезпечний у production?

AutoMigrate не вміє накопичувати зміни без ризику втрати даних — він може видалити стовпці або таблиці. На одному проєкті ми втратили кілька стовпців через ненавмисний виклик AutoMigrate після зміни моделі. Версіоновані міграції дають повний контроль і можливість відкату. Для production використовуємо golang-migrate з SQL-міграціями.

Приклад SQL-міграції

-- migrations/000002_create_products.up.sql
CREATE TABLE products (
    id BIGSERIAL PRIMARY KEY,
    title VARCHAR(500) NOT NULL,
    slug VARCHAR(520) NOT NULL UNIQUE,
    price DECIMAL(12, 2) NOT NULL,
    status VARCHAR(20) NOT NULL DEFAULT 'draft',
    category_id BIGINT NOT NULL REFERENCES categories(id) ON DELETE RESTRICT,
    created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
    updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
    deleted_at TIMESTAMPTZ
);
CREATE INDEX idx_products_status_created ON products (status, created_at DESC);
CREATE INDEX idx_products_category ON products (category_id, status);
CREATE INDEX idx_products_deleted_at ON products (deleted_at);

Порівняння AutoMigrate та версіонованих міграцій

Що входить у налаштування GORM

Ми надаємо:

• Налаштоване підключення до БД з пулом з'єднань (25 open, 10 idle, 5 хв lifetime)
• Репозиторії з Preload та транзакціями
• Версіоновані SQL-міграції з можливістю відкату
• Тести з testcontainers-go
• Документацію по стеку та конфігурації
• Підтримку протягом 2 тижнів після здачі

Терміни

Початкове налаштування GORM з міграціями для нового Go-проєкту займає від 1 дня до тижня залежно від кількості моделей та складності бізнес-логіки. Вартість розраховується індивідуально. Економія від оптимізації може становити до 500 000 гривень на рік.

Зв'яжіться з нами, щоб дізнатися точну вартість та терміни. Досвідчені інженери з 5-річним стажем гарантують стабільну роботу вашого додатку.