summaryrefslogtreecommitdiff
path: root/lib/sqlalchemy/ext/asyncio
diff options
context:
space:
mode:
authorMike Bayer <mike_mp@zzzcomputing.com>2023-04-17 09:18:23 -0400
committerMike Bayer <mike_mp@zzzcomputing.com>2023-04-17 09:18:23 -0400
commitacf7fbd60b9b1291dfc91438416867c88e94c5ba (patch)
tree33eadd775097d37c3a1f8212981d1e238c13c2b0 /lib/sqlalchemy/ext/asyncio
parentf7bfa04bcae1e9bafa19a5ee03aaa0beac532294 (diff)
downloadsqlalchemy-acf7fbd60b9b1291dfc91438416867c88e94c5ba.tar.gz
run docs sync
this is needed due to previous commit f7bfa04bcae1e9baf Change-Id: I7fa397707a018455a2c96b62704dfd506742b0cd
Diffstat (limited to 'lib/sqlalchemy/ext/asyncio')
-rw-r--r--lib/sqlalchemy/ext/asyncio/engine.py24
1 files changed, 11 insertions, 13 deletions
diff --git a/lib/sqlalchemy/ext/asyncio/engine.py b/lib/sqlalchemy/ext/asyncio/engine.py
index 240a5a005..6dfca463f 100644
--- a/lib/sqlalchemy/ext/asyncio/engine.py
+++ b/lib/sqlalchemy/ext/asyncio/engine.py
@@ -858,30 +858,28 @@ class AsyncConnection(
@property
def default_isolation_level(self) -> Any:
- r"""The default isolation level assigned to this
- :class:`_engine.Connection`.
+ r"""The initial-connection time isolation level associated with the
+ :class:`_engine.Dialect` in use.
.. container:: class_bases
Proxied for the :class:`_engine.Connection` class
on behalf of the :class:`_asyncio.AsyncConnection` class.
- This is the isolation level setting that the
- :class:`_engine.Connection`
- has when first procured via the :meth:`_engine.Engine.connect` method.
- This level stays in place until the
- :paramref:`.Connection.execution_options.isolation_level` is used
- to change the setting on a per-:class:`_engine.Connection` basis.
+ This value is independent of the
+ :paramref:`.Connection.execution_options.isolation_level` and
+ :paramref:`.Engine.execution_options.isolation_level` execution
+ options, and is determined by the :class:`_engine.Dialect` when the
+ first connection is created, by performing a SQL query against the
+ database for the current isolation level before any additional commands
+ have been emitted.
- Unlike :meth:`_engine.Connection.get_isolation_level`,
- this attribute is set
- ahead of time from the first connection procured by the dialect,
- so SQL query is not invoked when this accessor is called.
+ Calling this accessor does not invoke any new SQL queries.
.. seealso::
:meth:`_engine.Connection.get_isolation_level`
- - view current level
+ - view current actual isolation level
:paramref:`_sa.create_engine.isolation_level`
- set per :class:`_engine.Engine` isolation level