From e2436c2fbdb0a51524ed4cc872a87135d4b87266 Mon Sep 17 00:00:00 2001 From: Diana Clarke Date: Wed, 21 Nov 2012 19:23:01 -0500 Subject: [PATCH] I think this is a bit clearer: "within the same query", makes it sound like one SQL statement will be issued rather than two (or more) SQL statements. --- lib/sqlalchemy/orm/__init__.py | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) diff --git a/lib/sqlalchemy/orm/__init__.py b/lib/sqlalchemy/orm/__init__.py index c69fabf14c..d616a07653 100644 --- a/lib/sqlalchemy/orm/__init__.py +++ b/lib/sqlalchemy/orm/__init__.py @@ -425,10 +425,9 @@ def relationship(argument, secondary=None, **kwargs): the join is "outer" or not is determined by the ``innerjoin`` parameter. - * ``subquery`` - items should be loaded "eagerly" within the same - query as that of the parent, using a second SQL statement - which issues a JOIN to a subquery of the original - statement. + * ``subquery`` - items should be loaded "eagerly" as the parents are + loaded, using one additional SQL statement, which issues a JOIN to a + subquery of the original statement, for each collection requested. * ``noload`` - no loading should occur at any time. This is to support "write-only" attributes, or attributes which are -- 2.47.3