diff options
author | Mike Bayer <mike_mp@zzzcomputing.com> | 2023-05-12 22:30:40 -0400 |
---|---|---|
committer | Mike Bayer <mike_mp@zzzcomputing.com> | 2023-05-12 22:31:44 -0400 |
commit | 04380021c8e52787dd327129f3c66e11f737904d (patch) | |
tree | de4cca50480d8dac28266206c169b0b7b5cdeb2a | |
parent | 6f723defa45effb9767d2eae80893502baf76194 (diff) | |
download | sqlalchemy-rel_1_4.tar.gz |
qualify session.execute() resulting in autoflushrel_1_4
maybe this was planned differently at some point but
session.execute() only autoflushes for ORM contexts.
Change-Id: Ia10af232248e321875f79d5bde71f64d3dc25177
References: #9776
(cherry picked from commit eb286c15f096771dbb128acbe8fe03e94aa72f6a)
-rw-r--r-- | doc/build/orm/session_basics.rst | 4 |
1 files changed, 3 insertions, 1 deletions
diff --git a/doc/build/orm/session_basics.rst b/doc/build/orm/session_basics.rst index fcf384d4a..41390ff0b 100644 --- a/doc/build/orm/session_basics.rst +++ b/doc/build/orm/session_basics.rst @@ -447,7 +447,9 @@ The flush which occurs automatically within the scope of certain methods is known as **autoflush**. Autoflush is defined as a configurable, automatic flush call which occurs at the beginning of methods including: -* :meth:`_orm.Session.execute` and other SQL-executing methods +* :meth:`_orm.Session.execute` and other SQL-executing methods, when used + against ORM-enabled SQL constructs, such as :func:`_sql.select` objects + that refer to ORM entities and/or ORM-mapped attributes * When a :class:`_query.Query` is invoked to send SQL to the database * Within the :meth:`.Session.merge` method before querying the database * When objects are :ref:`refreshed <session_expiring>` |