Notre avis

Gère les modifications de schéma de base de données et les migrations de données de manière sécurisée et réversible.

Points forts

Migration toujours réversible avec des instructions 'up' et 'down'
Une seule modification par migration pour éviter les conflits
Processus de test et sauvegarde avant production
Checklist pour les opérations dangereuses (renommage, suppression de colonnes)

Limites

Spécifique à Drizzle ORM (non compatible avec d'autres ORM directement)
Nécessite une bonne compréhension des schémas de base de données
Peut être lourd pour des migrations très simples

Quand l'utiliser

Lorsque vous devez ajouter, modifier ou supprimer des tables ou colonnes en toute sécurité, avec possibilité de rollback.

Quand l'éviter

Pour des changements de données ponctuels non réversibles ou des opérations de base de données qui ne nécessitent pas de migration structurée.

Exemples

Add user roles table

Generate a database migration to create a 'roles' table with columns id, name, and description. Follow the reversible migration pattern with up and down scripts.

Rename column safely

Create a migration to rename 'email' column to 'user_email' in the users table using the three-step approach: add new column, copy data, drop old column.

Skill: Database Migration

Description

Handles safe database schema changes and data migrations.

When to Use

Adding/modifying database tables or columns
Changing relationships between entities
Data transformations

Instructions

Migration Rules

Always reversible — every migration needs an up and down
One change per migration — don't bundle unrelated schema changes
Test on dev first — never run untested migrations in production
Backup before production — always have a rollback plan
No data loss — add columns as nullable first, then backfill

Drizzle Workflow

# Generate migration from schema changes
npx drizzle-kit generate

# Review generated SQL in drizzle/ folder
# Apply migration
npx drizzle-kit push

# Or use migrate for production
npx drizzle-kit migrate

Naming Convention

YYYYMMDD_HHMMSS_description.sql Example: 20260212_143000_add_user_roles.sql

Dangerous Operations Checklist

[ ] Column rename → Create new, copy data, drop old (3-step)
[ ] Column type change → Verify data compatibility first
[ ] Drop table → Confirm no foreign key references
[ ] Add NOT NULL → Set default or backfill first

Migration de Base de Données

Recommandé pour