sqlalchemy/alembic
Alembic
Alembic ist ein Datenbankschema-Versionierungssystem und Migrationstool für SQLAlchemy. Es verwaltet inkrementelle Updates von Datenbankstrukturen mithilfe versionierter Skripte, die sowohl Upgrades als auch Downgrades unterstützen, um Datenbank und Code synchron zu halten.
Das System nutzt einen gerichteten azyklischen Graphen für das Migrationsmanagement, was nicht-lineare Versionierung ermöglicht, einschließlich Branching und Merging über mehrere Root-Versionen hinweg. Es enthält ein automatisiertes Schema-Diffing-Tool, das Live-Datenbankschemata mit Metadatenobjekten vergleicht, um programmatisch Migrationsanweisungen zu generieren.
Das Tool bietet Funktionen für transaktionale Schema-Evolution, um atomare Updates sicherzustellen und partielle Datenbankkorruption zu verhindern. Zusätzliche Funktionalität umfasst die Übersetzung von Migrationsdirektiven in rohe SQL-Strings für Audits und die Aufrechterhaltung einer skriptbasierten Versionsverfolgung über eine dedizierte Datenbanktabelle.
Features
- Database Schema Migrations - Provides a comprehensive system for the automated versioning and updating of database structures to maintain consistency across environments.
- Database Schema Version Control - Provides a complete system for tracking and managing incremental updates to database schemas.
- Transactional DDL Execution - Wraps schema changes in database transactions to ensure atomic updates and prevent partial corruption.
- Schema State Diffing - Provides algorithmic calculation of changes needed to transform a live database schema to match a model definition.
- Schema Version Tracking - Maintains a dedicated database table to record the current version ID and track applied migrations.
- Migration Script Generators - Automatically produces candidate migration directives by comparing data models to live database states.
- SQLAlchemy Schema Migrations - Specifically designed to handle schema migrations for databases defined by SQLAlchemy ORM models.
- Database Schema Diffing Tools - Includes a utility to identify discrepancies between a live database schema and model metadata.
- Migration State Tracking - Uses a dedicated database table to track which schema versions have been applied.
- Non-Linear Migration Versioning - Implements a graph-based version tracking system that supports branching and merging of database schema updates.
- Transactional Migration Managers - Executes schema migrations within atomic transactions to maintain data integrity during updates.
- Database Transactions - Ensures database consistency by executing schema updates within atomic transactions.
- SQL String Compilations - Translates high-level Python migration directives into raw SQL strings for auditing and manual execution.
- Migration Directive Rendering - Converts high-level Python migration directives into raw SQL strings for auditing.
- Migration Script Templates - Generates Python scripts from templates to define explicit database upgrade and downgrade paths.
- Directed Acyclic Graph Models - Implements migration tracking as a graph to support complex branching and merging of schema versions.
- Database Clients - Database migration tool for SQLAlchemy.
