Compétences py-alembic-patterns
🗄️

py-alembic-patterns

Sûr 🌐 Accès réseau⚙️ Commandes externes

Написание безопасных миграций Alembic для PostgreSQL

Миграции баз данных могут привести к потере данных или простою при неправильном выполнении. Этот навык предоставляет проверенные шаблоны для создания, проверки и безопасного применения миграций Alembic.

Prend en charge: Claude Codex Code(CC)
📊 70 Adéquat
1

Télécharger le ZIP du skill

2

Importer dans Claude

Allez dans Paramètres → Capacités → Skills → Importer un skill

3

Activez et commencez à utiliser

Tester

Utilisation de "py-alembic-patterns". Create a migration to rename the name column to full_name in the users table

Résultat attendu:

  • ВНИМАНИЕ: Автогенерация создаст drop+add, что приведет к потере данных
  • ПРАВИЛЬНЫЙ подход: Использовать op.alter_column с параметром new_column_name
  • Пример: op.alter_column('users', 'name', new_column_name='full_name')
  • Всегда реализуйте соответствующий downgrade для отмены переименования

Utilisation de "py-alembic-patterns". Add a required role column to the users table that already has data

Résultat attendu:

  • Трехэтапный процесс для ненулевых столбцов на существующих таблицах:
  • Шаг 1: Добавить столбец как nullable
  • Шаг 2: Заполнить существующие строки значением по умолчанию
  • Шаг 3: Изменить столбец, добавив ограничение NOT NULL
  • Это предотвращает ошибки на таблицах с существующими данными

Audit de sécurité

Sûr
v4 • 1/16/2026

This is a pure documentation skill containing only markdown content with educational code examples. All 39 static findings are false positives caused by pattern matching on example code in markdown blocks and metadata fields. No executable code, scripts, network operations, or file system access exists in this skill.

2
Fichiers analysés
548
Lignes analysées
2
résultats
4
Total des audits

Score de qualité

38
Architecture
100
Maintenabilité
87
Contenu
21
Communauté
100
Sécurité
91
Conformité aux spécifications

Ce que vous pouvez construire

Написание безопасных миграций для продакшена

Создание миграций с правильными путями отката, которые корректно обрабатывают данные и избегают блокировок таблиц в производственных средах.

Проверка миграций перед развертыванием

Проверка соответствия миграций шаблонам безопасности и отсутствия риска простоя или потери данных во время производственных развертываний.

Аудит практик миграций команды

Обеспечение соблюдения командами разработки лучших практик PostgreSQL для именования, создания индексов и управления ограничениями.

Essayez ces prompts

Создание новой миграции
Help me create an Alembic migration to add a user_preferences table with id, user_id, and theme columns. Include proper upgrade and downgrade functions.
Проверка автогенерированного кода
Review this autogenerated Alembic migration for dangerous patterns. Check for data loss risks and missing downgrade logic: [paste migration]
Обработка изменений больших таблиц
I need to add an index on the events table which has 50 million rows. Show me how to do this without locking the table in production.
Миграция данных с заполнением
I am adding a status column that must be backfilled based on other columns. Show me how to implement this as a data migration with batch processing.

Bonnes pratiques

  • Всегда реализуйте функции downgrade, которые полностью отменяют операцию upgrade
  • Проверяйте каждую автогенерированную миграцию на шаблоны drop+add, которые вызывают потерю данных
  • Используйте CONCURRENTLY для создания индексов на больших таблицах, чтобы предотвратить блокировки в продакшене

Éviter

  • Полагаться на автогенерированные миграции без ручной проверки при переименовании столбцов
  • Добавлять столбцы NOT NULL без предварительного заполнения существующих строк
  • Оставлять функции downgrade пустыми с просто pass, делая откат невозможным

Foire aux questions

Выполняет ли этот навык миграции к моей базе данных?
Нет. Этот навык предоставляет шаблоны и примеры. Вы запускаете миграции самостоятельно с помощью команд Alembic в вашем проекте.
Какие изменения автогенерация Alembic обрабатывает корректно?
Создание таблиц, добавление и удаление столбцов, изменение типов и внешние ключи работают надежно. Всегда проверяйте сгенерированный вывод.
Как безопасно мигрировать таблицы с миллионами строк?
Используйте CONCURRENTLY для индексов, обновляйте данные партиями порциями и добавляйте nullable столбцы перед ограничениями.
Предотвратят ли эти шаблоны всю потерю данных?
Они устраняют распространенные ошибки, но всегда делайте резервные копии производственных баз данных перед миграциями и тестируйте пути отката.
Могу ли я использовать эти шаблоны с MySQL или другими базами данных?
Некоторые шаблоны, такие как CONCURRENTLY, специфичны для PostgreSQL. Общая структура и практики проверки применимы широко.
Зачем мне реализовывать функции downgrade, которые я могу никогда не использовать?
Откаты необходимы для отката при обнаружении проблем после развертывания. Один раз, когда это понадобится, оправдывает усилия.

Détails du développeur

Structure de fichiers

📄 SKILL.md