p15693087
/
django
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

[3.0.x] Fixed #28273 -- Doc'd fast nullable column creation with defaults. 

Backport of 06909fe084 from master
This commit is contained in:
Caio Ariede 2019-10-04 10:55:41 -03:00 committed by Mariusz Felisiak
parent 3ea957b543
commit 282138a7bb
1 changed files with 15 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

15
docs/ref/migration-operations.txt
View File

@ -150,6 +150,21 @@ a default value to put into existing rows. It does not affect the behavior
of setting defaults in the database directly - Django never sets database
defaults and always applies them in the Django ORM code.
.. warning::
On older databases, adding a field with a default value may cause a full
rewrite of the table. This happens even for nullable fields and may have a
negative performance impact. To avoid that, the following steps should be
taken.
* Add the nullable field without the default value and run the
:djadmin:`makemigrations` command. This should generate a migration with
an ``AddField`` operation.
* Add the default value to your field and run the :djadmin:`makemigrations`
command. This should generate a migration with an ``AlterField``
operation.
``RemoveField``
---------------