2.4 KiB
2.4 KiB
Backward incompatible migrations
The linter analyses your migrations and checks the SQL for:
- Added
NOT NULLcolumns, which don't have a DEFAULT value - Dropping columns
- Dropping tables
- Renaming columns
- Renaming tables
- Altering columns (which can be backward compatible and potentially ignored)
- Adding a unique constraint
Those are the most important and frequent backward incompatible migrations. We are happy to add more if you can specify them to us.
Warnings
On data migrations, the linter will show a warning when:
- you are missing a reverse migration
- the RunPython arguments do not respect the naming convention
apps, schema_editor - the model variable name is different from the model class name in the
get_modelcall
Codes
You can ignore check through the --exclude-migration-tests option and specifying any of the codes:
| Code | Description |
|---|---|
NOT_NULL |
Not NULL constraint on columns |
DROP_COLUMN |
Dropping columns |
DROP_TABLE |
Dropping tables |
RENAME_COLUMN |
Renaming columns |
RENAME_TABLE |
Renaming tables |
ALTER_COLUMN |
Altering columns (could be backward compatible) |
ADD_UNIQUE |
Add unique constraints |
RUNPYTHON_REVERSIBLE |
RunPython data migration is not reversible (missing reverse code) |
RUNPYTHON_ARGS_NAMING_CONVENTION |
By convention, RunPython names two arguments: apps, schema_editor |
RUNPYTHON_MODEL_IMPORT |
Missing apps.get_model() calls for model |
RUNPYTHON_MODEL_VARIABLE_NAME |
The model variable name is different from the model class itself |
RUNSQL_REVERSIBLE |
RunSQL data migration is not reversible (missing reverse SQL) |
CREATE_INDEX |
(Postgresql specific) Creating an index without the concurrent keyword will lock the table and may generate downtime |
DROP_INDEX |
(Postgresql specific) Dropping an index without the concurrent keyword will lock the table and may generate downtime |
REINDEX |
(Postgresql specific) Reindexing will lock the table and may generate downtime |