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

Fixed #17435 - Clarified that QuerySet.update returns the number of rows matched

This commit is contained in:
Tim Graham 2012-10-06 07:02:11 -04:00
parent cc337a74f1
commit 6d46c740d8
2 changed files with 4 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

3
docs/ref/models/querysets.txt
View File

@ -1564,7 +1564,8 @@ update
.. method:: update(**kwargs) .. method:: update(**kwargs)
Performs an SQL update query for the specified fields, and returns Performs an SQL update query for the specified fields, and returns
the number of rows affected. the number of rows matched (which may not be equal to the number of rows
updated if some rows already have the new value).
For example, to turn comments off for all blog entries published in 2010, For example, to turn comments off for all blog entries published in 2010,
you could do this:: you could do this::

3
docs/topics/db/queries.txt
View File

@ -959,7 +959,8 @@ new value to be the new model instance you want to point to. For example::
>>> Entry.objects.all().update(blog=b) >>> Entry.objects.all().update(blog=b)
The ``update()`` method is applied instantly and returns the number of rows The ``update()`` method is applied instantly and returns the number of rows
affected by the query. The only restriction on the matched by the query (which may not be equal to the number of rows updated if
some rows already have the new value). The only restriction on the
:class:`~django.db.models.query.QuerySet` that is updated is that it can only :class:`~django.db.models.query.QuerySet` that is updated is that it can only
access one database table, the model's main table. You can filter based on access one database table, the model's main table. You can filter based on
related fields, but you can only update columns in the model's main related fields, but you can only update columns in the model's main