diff options
| author | Mike Bayer <mike_mp@zzzcomputing.com> | 2015-04-30 17:51:14 -0400 |
|---|---|---|
| committer | Mike Bayer <mike_mp@zzzcomputing.com> | 2015-04-30 17:51:14 -0400 |
| commit | 0e98795ff2c7a164b4da164d7b26af3faabf84d1 (patch) | |
| tree | 7448ed6552fb73068a105d4e6a1a2d485e24051d /doc | |
| parent | 20e3df602846bb1d8940b5138f21ef203c99bade (diff) | |
| download | sqlalchemy-0e98795ff2c7a164b4da164d7b26af3faabf84d1.tar.gz | |
- New features added to support engine/pool plugins with advanced
functionality. Added a new "soft invalidate" feature to the
connection pool at the level of the checked out connection wrapper
as well as the :class:`._ConnectionRecord`. This works similarly
to a modern pool invalidation in that connections aren't actively
closed, but are recycled only on next checkout; this is essentially
a per-connection version of that feature. A new event
:class:`.PoolEvents.soft_invalidate` is added to complement it.
fixes #3379
- Added new flag
:attr:`.ExceptionContext.invalidate_pool_on_disconnect`.
Allows an error handler within :meth:`.ConnectionEvents.handle_error`
to maintain a "disconnect" condition, but to handle calling invalidate
on individual connections in a specific manner within the event.
- Added new event :class:`.DialectEvents.do_connect`, which allows
interception / replacement of when the :meth:`.Dialect.connect`
hook is called to create a DBAPI connection. Also added
dialect plugin hooks :meth:`.Dialect.get_dialect_cls` and
:meth:`.Dialect.engine_created` which allow external plugins to
add events to existing dialects using entry points.
fixes #3355
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/build/changelog/changelog_10.rst | 30 |
1 files changed, 30 insertions, 0 deletions
diff --git a/doc/build/changelog/changelog_10.rst b/doc/build/changelog/changelog_10.rst index 436891601..fe5c7a744 100644 --- a/doc/build/changelog/changelog_10.rst +++ b/doc/build/changelog/changelog_10.rst @@ -19,6 +19,36 @@ :version: 1.0.3 .. change:: + :tags: feature, engine + :tickets: 3379 + + New features added to support engine/pool plugins with advanced + functionality. Added a new "soft invalidate" feature to the + connection pool at the level of the checked out connection wrapper + as well as the :class:`._ConnectionRecord`. This works similarly + to a modern pool invalidation in that connections aren't actively + closed, but are recycled only on next checkout; this is essentially + a per-connection version of that feature. A new event + :class:`.PoolEvents.soft_invalidate` is added to complement it. + + Also added new flag + :attr:`.ExceptionContext.invalidate_pool_on_disconnect`. + Allows an error handler within :meth:`.ConnectionEvents.handle_error` + to maintain a "disconnect" condition, but to handle calling invalidate + on individual connections in a specific manner within the event. + + .. change:: + :tags: feature, engine + :tickets: 3355 + + Added new event :class:`.DialectEvents.do_connect`, which allows + interception / replacement of when the :meth:`.Dialect.connect` + hook is called to create a DBAPI connection. Also added + dialect plugin hooks :meth:`.Dialect.get_dialect_cls` and + :meth:`.Dialect.engine_created` which allow external plugins to + add events to existing dialects using entry points. + + .. change:: :tags: bug, orm :tickets: 3403, 3320 |