Esaminare e modificare gli script generati

La generazione automatica è un’ottima prima bozza, non una risposta definitiva. Review dello script sempre prima di applicarlo in qualsiasi ambiente. 🔍

Ogni script si trova nella cartella versions. Aprirlo e leggere le funzioni upgrade e downgrade come qualsiasi altro codice.

All’interno delle funzioni si trovano chiamate sull’oggetto op, come op.create_table e op.add_column, ognuna delle quali descrive una modifica dello schema.

La generazione automatica spesso non rileva i renames, interpretandoli come un’eliminazione seguita da un’aggiunta. Questo eliminerebbe silenziosamente i dati della colonna.

Quando una colonna viene davvero rinominata, sostituire l’eliminazione e l’aggiunta con un singolo alter_column che conservi i dati.

Verificare che downgrade annulli davvero upgrade. Un downgrade non funzionante lascia bloccati se in futuro fosse necessario eseguire il rollback.

L’aggiunta di una colonna non nullable a una tabella che contiene righe fallirà. Aggiungerla prima come nullable, compilare i valori e poi renderla required.

È necessario riempire dei valori esistenti? Aggiungere una chiamata op.execute con SQL grezzo tra i passaggi dello schema per migrare i dati esistenti in sicurezza.

Prima di intervenire sulla produzione, eseguire la migrazione su una copy dei dati reali. In questo modo gli errori emergono quando è ancora facile correggerli.

Mantenere ogni migrazione focused su una singola modifica logica. Gli script piccoli sono molto più semplici da esaminare, testare e annullare correttamente.

Una volta modificato e testato, eseguire il commit dello script. Non modificare mai una migrazione già distribuita nella cronologia di produzione.

Si è imparato a esaminare gli script generati, correggere i rename con alter_column, gestire le colonne non nullable e testare prima del rilascio. 🎉