From fcb5dbf39569bcacb70a3fed05f469d73b64f116 Mon Sep 17 00:00:00 2001 From: Mike Bayer Date: Fri, 8 Feb 2019 17:48:51 -0500 Subject: [PATCH] mention no_autoflush in the flush section of the docs also remove link to wiki which is obsolete Change-Id: I9ebd578923c3eba6e35f3b6203c01ba003dd4115 --- doc/build/orm/session_basics.rst | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/doc/build/orm/session_basics.rst b/doc/build/orm/session_basics.rst index 4547e12436..a4c82e6f1e 100644 --- a/doc/build/orm/session_basics.rst +++ b/doc/build/orm/session_basics.rst @@ -714,8 +714,11 @@ Additionally, autoflush can be temporarily disabled by setting the mysession = Session() mysession.autoflush = False -Some autoflush-disable recipes are available at `DisableAutoFlush -`_. +More conveniently, it can be turned off within a context managed block using :attr:`.Session.no_autoflush`:: + + with mysession.no_autoflush: + mysession.add(some_object) + mysession.flush() The flush process *always* occurs within a transaction, even if the :class:`~sqlalchemy.orm.session.Session` has been configured with -- 2.47.2