Знакомство с ORM и GORM: что это и зачем

Реляционная база живёт таблицами со строками и колонками, Go — структурами и срезами. Между этими двумя мирами всегда есть трение, его называют impedance mismatch: типы не совпадают, NULL некуда класть, связи надо собирать вручную из внешних ключей. ORM — это слой, который берёт трение на себя: знает, что структура User соответствует таблице users, что поле Email — это колонка email, и что при сохранении объекта нужно собрать INSERT, а при чтении — просканировать строки обратно в структуры.

Важно понимать, что GORM не отменяет SQL — он его генерирует. Каждая цепочка методов вроде Where(...).Order(...).Limit(...) превращается в конкретный запрос, который можно увидеть в логах и проверить глазами. Поэтому ORM — это не «программирование без SQL», а другой способ его писать: вместо текста запроса вы описываете намерение, а текст собирает библиотека. Если SQL вы знаете хорошо, GORM становится предсказуемым: вы всегда догадываетесь, какой запрос получится. Если не знаете — ORM превращается в генератор неэффективных запросов, и это главный скрытый риск всей категории инструментов.

GORM написал Jinzhu Zhang, первая версия появилась в 2013 году и распространялась как github.com/jinzhu/gorm. Библиотека быстро стала дефолтным ответом на вопрос «как с базой в Go» — не в последнюю очередь потому, что в стандартной библиотеке долгое время не было ничего, кроме низкоуровневого database/sql. В 2020 году автор выпустил полностью переписанную вторую версию: новый модуль gorm.io/gorm, собственный парсер схем, диалекты как подключаемые пакеты, цепочечный API с клонированием запросов. Весь этот курс — про вторую версию; если в старых статьях видите импорт jinzhu/gorm, перед вами первый GORM, и его синтаксис местами отличается.

Сегодня GORM — самая звёздная ORM в экосистеме Go (больше тридцати тысяч звёзд на GitHub на момент написания), с документацией на gorm.io и большим количеством готовых плагинов: драйверы для разных СУБД, пагинация, трассировка, шифрование. Обратная сторона популярности — почти на любой вопрос по GORM ответ уже лежит в Stack Overflow, а сообщение об ошибке легко гуглится.

Чтобы почувствовать библиотеку, посмотрим на минимальный рабочий фрагмент: структура, сохранение записи и чтение по первичному ключу. Пока не вникайте в gorm.Open и типы — им посвящён следующий урок; сейчас важно увидеть общий ритм работы.

GORM отлично закрывает CRUD, но есть класс задач, где я его сознательно не применяю: аналитические отчёты, оконные функции, сравнения периодов, агрегаты по десяткам тысяч строк. Запросы такого сорта пишутся на SQL быстро и понятно, а на цепочках методов — плохо: получается читаемый только автору конструктор, который ещё и генерирует неоптимальный план. Моё правило: если больше половины запросов модуля — агрегаты и отчёты, этот модуль лучше держать на сыром SQL (GORM умеет Raw/Exec, урок 10, либо sqlc рядом). Если же это типовой сервис с формами и списками — GORM окупается с первого дня.

Второй спорный пункт — теги вместо явной схемы. Схема данных живёт в комментариях к полям структуры, и «единственный источник правды» размазывается между кодом и базой. В команде с DBA это источник споров; в solo-проекте или стартапе — честная экономия времени. Выбирайте по составу команды, а не по хайпу.

Во втором уроке подключим базу данных: gorm.Open, DSN для PostgreSQL и SQLite, пул соединений. В третьем — модели и соглашения: как из структуры получается таблица, зачем нужен gorm.Model и что умеют теги. Дальше — миграции, CRUD, ассоциации, транзакции и итоговый проект: слой данных блога. Если захочется сверяться с официальной документацией, всё то же самое изложено на gorm.io — наш курс идёт параллельно ей, но по-русски и с разбором граблей.