Alembic

Alembic є нова міграції бази даних, утиліта, написана автором SQLAlchemy і NBSP; інструмент міграції має наступні функціональні можливості .:
- Може випромінювати ALTER заяви в базу даних для того, щоб змінити структуру таблиць та інших конструкцій
- Забезпечує систему, при якій "Сценарії міграції" може бути побудована; Кожен сценарій вказує конкретний ряд кроків, які можуть "Upgrade" цільової бази даних до нової версії, і, можливо, ряд кроків, які можуть "Зниження" Таким же чином, одні і ті ж дії в зворотному порядку.
- Дозволяє скрипти для виконання в якійсь послідовним чином.
Мети Alembic є:
- Дуже відкритого складу і прозорим конфігурація і робота. Нове середовище Alembic генерується з набору шаблонів, які вибирають серед безлічі варіантів, коли програма установки спочатку відбувається. Шаблони потім внести ряд сценаріїв, які повністю визначають як з'єднання з базою даних встановлюється і як скрипти міграції викликаються; міграційні самі скрипти створюються на основі шаблону в цій серії сценаріїв. Сценарії можуть бути додатково налаштовані, щоб точно визначити, як бази даних будуть взаємодіяти з і те, що структура нових файлів міграції повинні прийняти.
- Повна підтримка транзакцій DDL. Скрипти за замовчуванням забезпечують всі міграції відбуваються в рамках транзакції - для тих баз даних, які підтримують цю (PostgreSQL, Microsoft SQL Server), міграція може бути перевірена без необхідності вручну скасувати зміни після збою.
- Мінімалістський будівництво скрипт. Основні операції, такі як перейменування таблиці / стовпці, додавання / видалення стовпців, зміни атрибутів стовпців може бути виконано через одну лінію команди, як alter_column (), rename_table (), add_constraint (). Там немає необхідності, щоб відтворити повний SQLAlchemy структури таблиць для простих операцій, таких як ці - функції самі генерувати мінімалістському структури схеми за лаштунками, щоб досягти дану DDL послідовності.
- "Автоматична генерація" міграцій. У той час як в реальному світі міграції є набагато складнішими, ніж те, що може бути визначено автоматично, Alembic ще може усунути первісну чорнову роботу в створенні нових директив міграції з зміненою схемою. --autogenerate Функція буде перевіряти поточний стан бази даних за допомогою можливостями контролю схеми SQLAlchemy в, порівняти його з поточним станом моделі бази даних, як зазначено в Python, і створити серію «Кандидат» міграцій, що робить їх у нову міграції Сценарій, як директиви Python. Потім розробник редагує новий файл, додавши додаткові директиви і міграції даних в міру необхідності, для отримання готового міграції. Таблиця і на рівні стовпців зміни можуть бути виявлені з обмеженнями та індекси стежити, як добре.
- Повна підтримка міграцій, що утворюються в сценарії SQL. Ті з нас, хто працює в корпоративному середовищі знаємо, що прямий доступ до DDL команди на робочої бази даних рідкісний привілей, і адміністратори баз даних хочете скрипти текстова SQL. Модель і команди використання перегінний куб в орієнтовані на можливість виконання ряду міграцій у вихідний файл текстового само легко, як він працює з ними безпосередньо в базу даних. Необхідно дотримуватися обережності в цьому режимі не посилатися на інші операції, які покладаються на в пам'яті SELECT, рядів - Alembic намагається забезпечити допоміжні конструкції, такі як bulk_insert (), щоб допомогти з операціями орієнтованих на дані, які сумісні з на основі сценаріїв DDL.
- Нелінійна версіями. Сценарії наведені UUID ідентифікатори подібно DVCS, і ув'язка одного сценарію в наступному досягається за допомогою маркерів всередині самих сценаріїв. Завдяки цьому відкритий механізм, філії, що містять інші сценарії міграції можуть бути об'єднані - взаємозв'язок може бути змінено вручну в файлах сценаріїв для створення нової послідовності.
- Забезпечити бібліотеку ALTER конструкцій, які можуть бути використані будь-яким додатком SQLAlchemy. Конструкції DDL спиратися на власній базі SQLAlchemy в DDLElement і може використовуватися автономно від будь-якої програми або сценарію.
- Не ламайте наші шиї над нездатністю SQLite для ALTER речі. SQLite має майже ніякої підтримки таблиці або стовпця зміни. Це зроблено по SQLite розробників, так Alembic відмовляється реалізації незручні і погано функціональні обхідні шляхи для цієї платформи. Якщо ви серйозно ставитеся до міграції схеми, використовувати базу даних, яка так само, як серйозно!
Документація та статус Alembic знаходиться в http://packages.python.org/alembic/.

Requirements:

• Python