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:34 -0400 |
commit | eb286c15f096771dbb128acbe8fe03e94aa72f6a (patch) | |
tree | 30c937872a4e3c631bf8665b3a46f1a4cf04c9bf | |
parent | 11a1d5e70450300310ff7fafeeb03fe1baa9380e (diff) | |
download | sqlalchemy-eb286c15f096771dbb128acbe8fe03e94aa72f6a.tar.gz |
qualify session.execute() resulting in autoflush
maybe this was planned differently at some point but
session.execute() only autoflushes for ORM contexts.
Change-Id: Ia10af232248e321875f79d5bde71f64d3dc25177
References: #9776
-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 12413336a..33a58e87c 100644 --- a/doc/build/orm/session_basics.rst +++ b/doc/build/orm/session_basics.rst @@ -386,7 +386,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>` |