From: Mike Bayer Date: Thu, 9 Aug 2007 04:06:51 +0000 (+0000) Subject: edits X-Git-Tag: rel_0_4beta1~29 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=45dd4437326f86b3b9106f4c5d0c5ce1511cbf90;p=thirdparty%2Fsqlalchemy%2Fsqlalchemy.git edits --- diff --git a/doc/build/content/session.txt b/doc/build/content/session.txt index a81b518abd..e68663dd77 100644 --- a/doc/build/content/session.txt +++ b/doc/build/content/session.txt @@ -298,6 +298,8 @@ A session can be configured to issue `flush()` calls before each query. This al # commit session, flushes whatever is remaining sess.commit() +Autoflush is particularly handy when using "dynamic" mapper relations, so that changes to the underlying collection are immediately available via its query interface. + ### Expunge / Clear Expunge removes an object from the Session, sending persistent instances to the detached state, and pending instances to the transient state: @@ -314,8 +316,6 @@ This `clear()` method is equivalent to `expunge()`-ing everything from the Sessi However note that the `clear()` method does not reset any transactional state or connection resources; therefore what you usually want to call instead of `clear()` is `close()`. -note that objects in collections can be re-saved again - ### Closing The `close()` method issues a `clear()`, and releases any transactional/connection resources. When connections are returned to the connection pool, whatever transactional state exists is rolled back. @@ -554,4 +554,4 @@ Vertical partitioning places different kinds of objects, or different tables, ac Horizontal partitioning partitions the rows of a single table (or a set of tables) across multiple databases. -See the "sharding" example in [attribute_shard.py](http://www.sqlalchemy.org/trac/browser/trunk/examples/sharding/attribute_shard.py) +See the "sharding" example in [attribute_shard.py](http://www.sqlalchemy.org/trac/browser/sqlalchemy/trunk/examples/sharding/attribute_shard.py)