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

Refs #30656 -- Reorganized bulk methods in the database optimization docs.

This commit is contained in:
daniel a rios 2019-07-26 15:11:48 +02:00 committed by Mariusz Felisiak
parent 3c6d32e0b2
commit fe33fdc049
1 changed files with 14 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

18
docs/topics/db/optimization.txt
View File

@ -341,8 +341,13 @@ it on a ``QuerySet`` by calling
Adding an index to your database may help to improve ordering performance. Adding an index to your database may help to improve ordering performance.
Insert in bulk Use bulk methods
============== ================
Use bulk methods to reduce the number of SQL statements.
Create in bulk
--------------
When creating objects, where possible, use the When creating objects, where possible, use the
:meth:`~django.db.models.query.QuerySet.bulk_create()` method to reduce the :meth:`~django.db.models.query.QuerySet.bulk_create()` method to reduce the
@ -362,8 +367,13 @@ Note that there are a number of :meth:`caveats to this method
<django.db.models.query.QuerySet.bulk_create>`, so make sure it's appropriate <django.db.models.query.QuerySet.bulk_create>`, so make sure it's appropriate
for your use case. for your use case.
This also applies to :class:`ManyToManyFields Insert in bulk
<django.db.models.ManyToManyField>`, so doing:: --------------
When inserting objects into :class:`ManyToManyFields
<django.db.models.ManyToManyField>`, use
:meth:`~django.db.models.fields.related.RelatedManager.add` with multiple
objects to reduce the number of SQL queries. For example::
my_band.members.add(me, my_friend) my_band.members.add(me, my_friend)