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-річним стажем гарантують стабільну роботу вашого додатку.