diff options
author | Mike Bayer <mike_mp@zzzcomputing.com> | 2013-10-13 17:17:26 -0400 |
---|---|---|
committer | Mike Bayer <mike_mp@zzzcomputing.com> | 2013-10-13 17:17:26 -0400 |
commit | b26679e06a5473355a68bfea2a574c1aa14407a6 (patch) | |
tree | f8d7cc5dc1717e6106236a18d8b12a257e5b4c2b | |
parent | 28a349135792a2f8e94fc0892cb612804d3b072c (diff) | |
download | sqlalchemy-b26679e06a5473355a68bfea2a574c1aa14407a6.tar.gz |
alphabetical ordering
-rw-r--r-- | lib/sqlalchemy/orm/__init__.py | 34 |
1 files changed, 17 insertions, 17 deletions
diff --git a/lib/sqlalchemy/orm/__init__.py b/lib/sqlalchemy/orm/__init__.py index 5183f4b7a..fb489866a 100644 --- a/lib/sqlalchemy/orm/__init__.py +++ b/lib/sqlalchemy/orm/__init__.py @@ -341,6 +341,23 @@ def relationship(argument, secondary=None, **kwargs): a class which extends :class:`.RelationshipProperty.Comparator` which provides custom SQL clause generation for comparison operations. + :param distinct_target_key=False: + Indicate if a "subquery" eager load should apply the DISTINCT + keyword to the innermost SELECT statement. When set to ``None``, + the DISTINCT keyword will be applied in those cases when the target + columns do not comprise the full primary key of the target table. + When set to ``True``, the DISTINCT keyword is applied to the innermost + SELECT unconditionally. + + This flag defaults as False in 0.8 but will default to None in 0.9. + It may be desirable to set this flag to False when the DISTINCT is + reducing performance of the innermost subquery beyond that of what + duplicate innermost rows may be causing. + + .. versionadded:: 0.8.3 - distinct_target_key allows the + subquery eager loader to apply a DISTINCT modifier to the + innermost SELECT. + :param doc: docstring which will be applied to the resulting descriptor. @@ -431,23 +448,6 @@ def relationship(argument, secondary=None, **kwargs): or when the reference is one-to-one or a collection that is guaranteed to have one or at least one entry. - :param distinct_target_key=False: - Indicate if a "subquery" eager load should apply the DISTINCT - keyword to the innermost SELECT statement. When set to ``None``, - the DISTINCT keyword will be applied in those cases when the target - columns do not comprise the full primary key of the target table. - When set to ``True``, the DISTINCT keyword is applied to the innermost - SELECT unconditionally. - - This flag defaults as False in 0.8 but will default to None in 0.9. - It may be desirable to set this flag to False when the DISTINCT is - reducing performance of the innermost subquery beyond that of what - duplicate innermost rows may be causing. - - .. versionadded:: 0.8.3 - distinct_target_key allows the - subquery eager loader to apply a DISTINCT modifier to the - innermost SELECT. - :param join_depth: when non-``None``, an integer value indicating how many levels deep "eager" loaders should join on a self-referring or cyclical |