Fixed #30491 -- Clarified when save() on object with pk executes INSERT.

This commit is contained in:
Brad Solomon 2019-05-27 08:47:15 -04:00 committed by Mariusz Felisiak
parent a3f91891d2
commit 67b6cb7723
1 changed files with 2 additions and 1 deletions

View File

@ -472,7 +472,8 @@ follows this algorithm:
``True`` (i.e., a value other than ``None`` or the empty string), Django
executes an ``UPDATE``.
* If the object's primary key attribute is *not* set or if the ``UPDATE``
didn't update anything, Django executes an ``INSERT``.
didn't update anything (e.g. if primary key is set to a value that doesn't
exist in the database), Django executes an ``INSERT``.
The one gotcha here is that you should be careful not to specify a primary-key
value explicitly when saving new objects, if you cannot guarantee the