From: Diana Clarke Date: Thu, 22 Nov 2012 00:23:01 +0000 (-0500) Subject: I think this is a bit clearer: "within the same query", makes it sound like one SQL... X-Git-Tag: rel_0_8_0b2~32 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=e2436c2fbdb0a51524ed4cc872a87135d4b87266;p=thirdparty%2Fsqlalchemy%2Fsqlalchemy.git 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. --- 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