diff options
| author | Mike Bayer <mike_mp@zzzcomputing.com> | 2019-02-08 17:48:51 -0500 |
|---|---|---|
| committer | Mike Bayer <mike_mp@zzzcomputing.com> | 2019-02-08 17:48:51 -0500 |
| commit | fcb5dbf39569bcacb70a3fed05f469d73b64f116 (patch) | |
| tree | b58fa31dc85b841c32edefaf4218deb850568498 | |
| parent | 6c177df67c9ea8d89ed26ac4996d24301be04583 (diff) | |
| download | sqlalchemy-fcb5dbf39569bcacb70a3fed05f469d73b64f116.tar.gz | |
mention no_autoflush in the flush section of the docs
also remove link to wiki which is obsolete
Change-Id: I9ebd578923c3eba6e35f3b6203c01ba003dd4115
| -rw-r--r-- | doc/build/orm/session_basics.rst | 7 |
1 files changed, 5 insertions, 2 deletions
diff --git a/doc/build/orm/session_basics.rst b/doc/build/orm/session_basics.rst index 4547e1243..a4c82e6f1 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 -<http://www.sqlalchemy.org/trac/wiki/UsageRecipes/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 |