From eb286c15f096771dbb128acbe8fe03e94aa72f6a Mon Sep 17 00:00:00 2001 From: Mike Bayer Date: Fri, 12 May 2023 22:30:40 -0400 Subject: 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 --- doc/build/orm/session_basics.rst | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) 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 ` -- cgit v1.2.1