]> git.ipfire.org Git - thirdparty/sqlalchemy/sqlalchemy.git/commitdiff
run docs sync
authorMike Bayer <mike_mp@zzzcomputing.com>
Mon, 17 Apr 2023 13:18:23 +0000 (09:18 -0400)
committerMike Bayer <mike_mp@zzzcomputing.com>
Mon, 17 Apr 2023 13:18:23 +0000 (09:18 -0400)
this is needed due to previous commit f7bfa04bcae1e9baf

Change-Id: I7fa397707a018455a2c96b62704dfd506742b0cd

lib/sqlalchemy/ext/asyncio/engine.py

index 240a5a005644425f107f6d233cb0a4ee3aabfdf4..6dfca463fb79beced000afe276a2665c6e0c7e3d 100644 (file)
@@ -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