summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMike Bayer <mike_mp@zzzcomputing.com>2007-08-09 04:06:51 +0000
committerMike Bayer <mike_mp@zzzcomputing.com>2007-08-09 04:06:51 +0000
commit45dd4437326f86b3b9106f4c5d0c5ce1511cbf90 (patch)
tree9a37cf5a7981f9d5cb0df8b13f725048f5f46a72
parent095ddfe8e9bcb879ce92542f1481531d9d09837c (diff)
downloadsqlalchemy-45dd4437326f86b3b9106f4c5d0c5ce1511cbf90.tar.gz
edits
-rw-r--r--doc/build/content/session.txt6
1 files changed, 3 insertions, 3 deletions
diff --git a/doc/build/content/session.txt b/doc/build/content/session.txt
index a81b518ab..e68663dd7 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)