{"categories":[{"label":"Database","url":"https://skillfed.io/packages/category/database/5"}],"enrichment":{"capability":"Applies versioned SQL migrations to ClickHouse databases from the CLI, Python code, or CI/CD pipelines, with support for multi-statement files and cluster-aware state tracking.","skillfed_tags":["schema-migration","clickhouse","devops"],"use_cases":["Manage schema changes in production ClickHouse clusters without manual coordination across nodes.","Automate database initialization and schema updates in Docker or Kubernetes deployments via CLI.","Track and inspect pending vs. applied migrations before running them in CI/CD pipelines.","Roll back individual migrations using explicit hand-written down files when needed.","Apply complex multi-statement migrations (e.g., table creation plus column additions) atomically."],"what_it_does":"clickhouse-migrations is a file-based schema migration tool for ClickHouse that reads versioned SQL files from a directory and applies them in order, tracking which migrations have been run. It supports both the native clickhouse-driver (TCP) and the official clickhouse-connect (HTTP) driver, and is aware of ClickHouse cluster deployments, keeping migration state consistent across all nodes.\n\nYou write plain `.sql` files named like `001_init.sql`, `002_add_column.sql`, etc., each containing one or more SQL statements. The tool applies them via CLI commands, a Python API, or CI/CD integration. It can show migration status without applying anything, supports dry-run inspection, and offers optional rollback via paired `.down.sql` files. Multi-statement files and cluster-aware execution distinguish it from simpler alternatives.","worth_installing":"Yes. The package is actively maintained, has low install friction, carries no known vulnerabilities, and solves a real problem for ClickHouse users. It is the most actively maintained migration tool for ClickHouse in Python and supports features (multi-statement files, cluster awareness) that alternatives lack. MIT licensing adds no restrictions."},"id":"clickhouse-migrations","links":{"html":"https://skillfed.io/packages/clickhouse-migrations","md":"https://skillfed.io/packages/clickhouse-migrations.md","pypi":"https://pypi.org/project/clickhouse-migrations/"},"maintenance":{"status":"active"},"meta":{"latest_release":"2026-07-08","license_spdx":null,"license_treatment":"permissive","name":"clickhouse-migrations","python_support":"supports_current","summary":"Simple file-based migrations for clickhouse"},"popularity":{"monthly_downloads":74838,"position":14784,"tier":"top_15000"},"security":{"n_vulnerabilities":0},"version":"0.13.0"}