Skip to main content

​
Что такое управление схемой?

Управление схемой — это применение принципов контроля версий к схемам баз данных. Обычно оно включает такие действия, как отслеживание и автоматизация изменений таблиц, столбцов и связей между ними, чтобы обновления схемы были воспроизводимыми, поддавались аудиту и оставались согласованными во всех средах. Управление схемой необходимо, когда структуру данных в базе данных нужно изменить для нового сценария использования или оптимизации производительности.

​
Почему это важно?

Инструменты управления схемой позволяют автоматизировать изменения схемы вместе с развертыванием приложений. Нередко изменения схемы служат обязательным предварительным условием для развертывания новой версии приложения. Эти инструменты также называют инструментами «миграции схемы» или «миграции базы данных», поскольку они используются для перехода от одной версии базы данных к другой. Без инструментов управления схемой изменения в базе данных приходится вносить вручную, они подвержены ошибкам, и их сложно согласовывать между командами и средами. Хотя DDL всегда можно выполнять напрямую в базе данных, такие инструменты обеспечивают контроль версий, автоматизированные развертывания, поддержку rollback и ведение журнала аудита. Для ClickHouse это особенно важно, поскольку некоторые изменения DDL могут быть ресурсоемкими или необратимыми, поэтому наличие структурированного процесса миграции с этапами проверки здесь критически важно.

​
Подходы к управлению схемой

Инструменты управления схемой обычно делятся на две категории.

​
Императивный подход

Эти инструменты используют версионируемые SQL-файлы, которые описывают, как перейти из состояния A в состояние B. Вы записываете в файлы явные DDL-операторы, такие как CREATE TABLE, ALTER TABLE или DROP COLUMN. Затем инструмент выполняет эти файлы по порядку и отслеживает, какие из них уже были применены. В рамках этого подхода вы сами задаёте, какой именно SQL нужно выполнить. Примеры: Golang Migrate, Goose и Flyway.

​
Декларативный

В этих инструментах пользователь сначала определяет схему желаемого состояния. Инструмент выявляет различия между текущей базой данных и желаемым состоянием, а затем генерирует и применяет необходимую миграцию. Такой подход сокращает объем ручной работы по написанию миграций и уменьшает расхождение схем. В этой категории инструмент определяет точный SQL, который нужно выполнить. Примеры: Atlas и Liquibase. Существует и третья категория инструментов, которые меньше сосредоточены на изменениях схемы базы данных и больше — на преобразовании самих данных. Пример: dbt. Эта статья посвящена исключительно инструментам для изменений схемы базы данных. Выбирайте инструмент, который соответствует подходу вашей команды к работе. Императивные инструменты дают полную прозрачность того, какой именно DDL будет выполнен, но требуют постоянного внимания к выявлению расхождения схем и управлению им. Декларативные инструменты автоматизируют значительную часть сопровождения и помогают предотвращать расхождение схем, но перед применением в ClickHouse всегда следует проверять сгенерированный план. Убедитесь, что в автоматически сгенерированном плане не скрыты неожиданные мутации или дорогостоящие переписывания.

​
Что следует учитывать при выборе инструмента

​
Что ваша команда уже использует?

Скорее всего, вы будете склоняться к инструментам, знакомым по вашей экосистеме. Если ваша команда в основном работает с Go, естественным выбором могут стать Golang Migrate или Goose. Если вы работаете в экосистеме Java, у вас, возможно, уже используются Flyway или Liquibase. Если ваша инфраструктурная команда использует Terraform и подходы infrastructure-as-code, декларативная модель Atlas может оказаться удобным вариантом. Есть смысл выбрать то, что ваша команда уже знает: лучший инструмент — тот, который действительно внедряют и используют последовательно.

​
Какой процесс вам нужен?

Подумайте о том, как изменения схемы проходят через вашу организацию. Определите, что именно вам требуется:
  • Простой процесс по принципу «написали SQL, запустили в CI, готово», как в Goose или Golang Migrate.
  • Управляемые процессы согласования, журнал аудита и RBAC, как в Bytebase или Liquibase.
  • Декларативное описание схемы, при котором инструмент сам определяет различия, как в Atlas.
Подберите инструмент под свои требования и процессы. Ниже перечислены инструменты, которые мы обычно рекомендуем пользователям ClickHouse, исходя из их зрелости, совместимости с ClickHouse, распространённости в сообществе и удобства в эксплуатации.

​
Atlas

Atlas — это инструмент для управления схемой как кодом, использующий декларативный подход. Вы задаёте желаемое состояние схемы в HCL или SQL, а Atlas анализирует текущую базу данных, вычисляет разницу, формирует план миграции и применяет его — при необходимости после вашей проверки. Почему это хорошо работает с ClickHouse: Atlas предоставляет полноценную поддержку ClickHouse, включая таблицы, представления, materialized views, проекции, партиции и пользовательские функции (UDF). Поддержка кластеров появилась в Atlas v0.37 в сентябре 2025 года. Поддерживаются как HCL, так и обычные SQL-определения схемы. На что обратить внимание: Драйвер ClickHouse для Atlas доступен только в тарифе Pro или в рамках пробного периода. Atlas формирует планы миграции, но не оценивает стоимость их выполнения. Разница может казаться простой, например изменение типа столбца, но при этом запустить дорогостоящую мутацию для таблицы объёмом в несколько терабайт. Всегда проверяйте сгенерированные планы перед их применением. Лучше всего подходит для: Команд, которым нужны workflow в стиле infrastructure-as-code и автоматическое выявление дрейфа.
  • Тип: Декларативный
  • Язык: Go, поставляется как единый бинарный файл
  • Лицензия и доступность: Open Core; Atlas CLI имеет community edition по лицензии Apache 2.0, но поддержка ClickHouse требует тариф Pro или пробный период
  • Поддержка кластеров: Да

​
Golang Migrate

Golang Migrate — простой и широко используемый инструмент для запуска миграций. Вы создаёте версионированные SQL-файлы с шагами up и down, а инструмент применяет их по порядку, отслеживая состояние в таблице schema_migrations в вашей базе данных ClickHouse. Почему это хорошо работает с ClickHouse: Это простой и гибкий инструмент. Вы пишете именно тот DDL ClickHouse, который хотите выполнить. Это один бинарный файл Go без зависимостей времени выполнения, поэтому его легко встроить в конвейер CI/CD или в Docker-контейнер. На что обратить внимание: Если файл миграции содержит несколько операторов и один из них завершается ошибкой в середине выполнения, база данных может остаться в частично применённом состоянии, и тогда потребуется ручное вмешательство. С этим можно справиться, если придерживаться правила: один оператор на файл. Лучше всего подходит для: Команд, которым нужны простота и полный контроль над тем, какой именно SQL выполняется на их экземпляре ClickHouse.
  • Тип: Императивный
  • Язык: Go
  • Лицензия: С открытым исходным кодом, MIT
  • Поддержка кластеров: Да

​
Goose

Goose — ещё один инструмент для запуска миграций на Go со схожей философией с Golang Migrate. Вы создаёте версионированные SQL-файлы или Go-функции для сложной логики, а Goose применяет их последовательно, отслеживая состояние в таблице версий в ClickHouse. Почему это хорошо работает с ClickHouse: Goose придерживается подхода SQL-first, требует минимальной конфигурации, имеет простой CLI и легко интегрируется в CI/CD. Goose также поддерживает написание миграций в виде Go-функций, что даёт больше гибкости для сложной логики, которую нельзя выразить только средствами SQL. На что стоит обратить внимание: Goose не предоставляет сравнение схем и автоматическую генерацию миграций. Лучше всего подходит для: команд, которые уже используют Goose, или тех, кто предпочитает его соглашения для файлов миграций соглашениям Golang Migrate.
  • Тип: Императивный
  • Язык: Go, распространяется как единый бинарный файл
  • Лицензия: С открытым исходным кодом, MIT
  • Поддержка кластеров: No

​
Другие инструменты в экосистеме

Следующие инструменты также работают с ClickHouse. В зависимости от вашего стека и рабочих процессов они могут подойти лучше. Однако в целом мы рекомендуем инструменты, перечисленные выше.
Последнее изменение 14 августа 2026 г.