☰
06.11.2025

pgschema - управление схемами PostgreSQL в декларативном стиле, как в Terraform

pgschema - это инструмент командной строки (CLI) для работы со схемами баз данных PostgreSQL в декларативном стиле, аналогичном подходу Terraform.
Он позволяет описывать желаемое состояние схемы базы данных в виде кода и автоматически применять изменения, чтобы привести существующую базу к этому состоянию.

Инструмент упрощает управление миграциями, устраняя необходимость вручную писать SQL-скрипты и отслеживать версии изменений.
pgschema самостоятельно анализирует разницу между текущей и целевой схемой, генерирует план изменений и применяет его в безопасной транзакции.

Для чего используется pgschema

pgschema помогает:

Запустите проект за минуты с VPS в России — предустановленное ПО, высокая производительность и надёжная инфраструктура Serverspace - Арендовать VPS

Установка

  1. Загрузите бинарный файл из официального репозитория GitHub.
  2. Распакуйте архив и добавьте бинарный файл в PATH.
  3. Проверьте установку командой:
    pgschema --version
Примечание: официально поддерживаются Linux и macOS.
На Windows инструмент можно запустить через WSL.

Основные команды

1. Снятие дампа схемы

PGPASSWORD=pass pgschema dump \
--host localhost \
--db mydb \
--user postgres \
--schema public > schema.sql

Команда сохраняет текущее состояние схемы в файл schema.sql.
Этот файл можно редактировать вручную — добавлять таблицы, поля, индексы и т.д.

2. Планирование изменений

PGPASSWORD=pass pgschema plan \
--host localhost \
--db mydb \
--user postgres \
--schema public \
--file schema.sql \
--output-human stdout \
--output-json plan.json

Инструмент сравнивает текущее состояние базы с файлом схемы и выводит план изменений:

Plan: 1 to modify.
Summary by type:
tables: 1 to modify
Tables:
~ users
+ age (column)

3. Применение изменений

PGPASSWORD=pass pgschema apply \
--host localhost \
--db mydb \
--user postgres \
--schema public \
--plan plan.json \
--auto-approve

pgschema применит план и выполнит все необходимые DDL-запросы (например, ALTER TABLE).

Преимущества

Недостатки

Вывод

pgschema - это современный инструмент, идеально подходящий для DevOps-инженеров и администраторов баз данных, которые внедряют подход Infrastructure as Code и стремятся автоматизировать управление схемами PostgreSQL.
Он помогает упростить процесс версионирования и обновления схем, обеспечивая прозрачность, воспроизводимость и контроль изменений на всех этапах CI/CD.

На практике стоит использовать pgschema для:

Для команд, работающих с PostgreSQL в облачных средах или контейнеризированных проектах, pgschema может стать надёжной альтернативой инструментам вроде Flyway и Liquibase, обеспечивая более простой и декларативный подход к управлению схемами.

FAQ