Миграции баз данных в C++: лучшие библиотеки и инструменты…

Миграции баз данных в C++: управление схемой и версионирование

В современных C++ проектах, работающих с реляционными базами данных (PostgreSQL, MySQL, SQLite), поддержка эволюции схемы — обязательная практика. Миграции позволяют автоматически применять изменения структуры таблиц, индексов и ограничений, сохраняя целостность данных между версиями приложения. В отличие от динамических языков, C++ не имеет встроенного инструмента для миграций, но существует несколько зрелых библиотек, решающих эту задачу.

Основные требования к библиотеке миграций для C++

Версионирование: каждая миграция должна иметь уникальный идентификатор (числовой или временной меткой).
Поддержка отката: возможность применить "up" (создание/изменение) и "down" (удаление/откат) операции.
Интеграция с СУБД: работа через стандартные драйверы (libpq, sqlite3, MySQL Connector).
Транзакционность: каждая миграция выполняется в отдельной транзакции для атомарности.
Автоматическое применение: утилита командной строки или API для запуска при старте приложения.

Популярные инструменты для миграций на C++

1. cpp-migrations (рекомендуемый)

Легковесная библиотека с открытым исходным кодом, поддерживающая PostgreSQL, MySQL, SQLite. Миграции описываются в виде C++ классов с методами up() и down(). Версия фиксируется в файле migrations.json.

// Пример миграции для cpp-migrations
#include <migration.hpp>

class CreateUsersTable : public Migration {
public:
    void up() override {
        execute("CREATE TABLE users ("
                "id SERIAL PRIMARY KEY,"
                "name VARCHAR(100) NOT NULL,"
                "email VARCHAR(255) UNIQUE,"
                "created_at TIMESTAMP DEFAULT NOW()"
                ")");
    }

    void down() override {
        execute("DROP TABLE IF EXISTS users");
    }
};

REGISTER_MIGRATION(CreateUsersTable, "001_create_users");

Запуск миграций через API:

#include <migration_runner.hpp>

int main() {
    MigrationRunner runner("postgresql://user:pass@localhost/db");
    runner.applyPending();  // применяет все неприменённые миграции
    return 0;
}

2. libpq-based миграции (самописный подход)

Если проект уже использует libpq (родной клиент PostgreSQL), можно реализовать простой менеджер миграций на основе SQL-файлов. Пример структуры:

migrations/
├── 001_create_users.sql
├── 001_create_users.down.sql
├── 002_add_role_column.sql
└── 002_add_role_column.down.sql

Код загрузчика на C++:

#include <pqxx/pqxx>
#include <filesystem>
#include <fstream>

void applyMigrations(pqxx::connection &conn) {
    pqxx::work txn(conn);
    // Создаём таблицу для отслеживания применённых миграций
    txn.exec("CREATE TABLE IF NOT EXISTS _migrations ("
             "id SERIAL PRIMARY KEY,"
             "name TEXT UNIQUE,"
             "applied_at TIMESTAMP DEFAULT NOW())");
    
    for (const auto &entry : std::filesystem::directory_iterator("migrations")) {
        std::string filename = entry.path().filename().string();
        if (filename.find(".down.") != std::string::npos) continue;
        if (filename.find(".sql") == std::string::npos) continue;
        
        // Проверяем, применена ли миграция
        auto check = txn.exec_params("SELECT 1 FROM _migrations WHERE name = $1", filename);
        if (check.empty()) {
            std::ifstream file(entry.path());
            std::string sql((std::istreambuf_iterator<char>(file)),
                            std::istreambuf_iterator<char>());
            txn.exec(sql);
            txn.exec_params("INSERT INTO _migrations (name) VALUES ($1)", filename);
        }
    }
    txn.commit();
}

3. Использование CMake для автоматизации

Можно встроить запуск миграций в процесс сборки через add_custom_target:

add_custom_target(run_migrations
    COMMAND ${CMAKE_SOURCE_DIR}/tools/migrate --apply
    COMMENT "Applying database migrations..."
    WORKING_DIRECTORY ${CMAKE_SOURCE_DIR}/migrations
)