diff options
| author | mike bayer <mike_mp@zzzcomputing.com> | 2021-07-20 19:19:26 +0000 |
|---|---|---|
| committer | Gerrit Code Review <gerrit@ci3.zzzcomputing.com> | 2021-07-20 19:19:26 +0000 |
| commit | e7119aea7870f0322e78d3a2cb28337b1640f0c2 (patch) | |
| tree | 021a176797ba2efbf27f1dc7e1ca3f3ba22dd179 /lib/sqlalchemy/engine | |
| parent | e72106d1499ec628487f7e428e7c49acdd4eb9c0 (diff) | |
| parent | 85fa3473be1332af34ce905e9ea0affdeefbb223 (diff) | |
| download | sqlalchemy-e7119aea7870f0322e78d3a2cb28337b1640f0c2.tar.gz | |
Merge "Documentation improvements"
Diffstat (limited to 'lib/sqlalchemy/engine')
| -rw-r--r-- | lib/sqlalchemy/engine/result.py | 9 |
1 files changed, 9 insertions, 0 deletions
diff --git a/lib/sqlalchemy/engine/result.py b/lib/sqlalchemy/engine/result.py index 119bf4a9e..60474c0ed 100644 --- a/lib/sqlalchemy/engine/result.py +++ b/lib/sqlalchemy/engine/result.py @@ -708,6 +708,15 @@ class Result(_WithKeys, ResultInternal): :class:`.ResultProxy` interface. When using the ORM, a higher level object called :class:`.ChunkedIteratorResult` is normally used. + .. note:: In SQLAlchemy 1.4 and above, this object is + used for ORM results returned by :meth:`_orm.Session.execute`, which can + yield instances of ORM mapped objects either individually or within + tuple-like rows. Note that the :class:`_result.Result` object does not + deduplicate instances or rows automatically as is the case with the + legacy :class:`_orm.Query` object. For in-Python de-duplication of + instances or rows, use the :meth:`_result.Result.unique` modifier + method. + .. seealso:: :ref:`tutorial_fetching_rows` - in the :doc:`/tutorial/index` |