Added a note about N+1 problem and form collections

javiereguiluz · javiereguiluz · commit 624085355bc2 · 2019-04-25T09:49:34.000+02:00
diff --git a/doctrine/associations.rst b/doctrine/associations.rst
@@ -355,6 +355,8 @@ to the given ``Category`` object via their ``category_id`` value.
     all at once (via a *join*), Doctrine will return the *true* ``Category``
     object, since nothing needs to be lazily loaded.
 
+.. _doctrine-associations-join-query:
+
 Joining Related Records
 -----------------------
 
diff --git a/reference/forms/types/entity.rst b/reference/forms/types/entity.rst
@@ -99,6 +99,13 @@ the `query_builder`_ option::
         'choice_label' => 'username',
     ]);
 
+.. note::
+
+    Using form collections may result in making too many database requests to
+    fetch related entities. This is known as the *"N + 1 query problem"* and it
+    can be solved by :ref:`joining related records <doctrine-associations-join-query>`
+    when querying for Doctrine associations.
+
 .. _reference-forms-entity-choices:
 
 Using Choices
