summaryrefslogtreecommitdiff
path: root/lib/sqlalchemy/engine
diff options
context:
space:
mode:
authormike bayer <mike_mp@zzzcomputing.com>2021-11-18 16:11:35 +0000
committerGerrit Code Review <gerrit@ci3.zzzcomputing.com>2021-11-18 16:11:35 +0000
commitc0b0bf8ab81ac966a8c5a428a45cddbafaaf6e18 (patch)
tree2b1e7c95d8c2f77cf7b387b95c32c3755ce3f680 /lib/sqlalchemy/engine
parent958f902b1fc528fed0be550bc573545de47ed854 (diff)
parentb2df5be7ee8b5ee7ae67323b5018ca37bbf0ce2a (diff)
downloadsqlalchemy-c0b0bf8ab81ac966a8c5a428a45cddbafaaf6e18.tar.gz
Merge "Deprecate create_engine.implicit_returning" into main
Diffstat (limited to 'lib/sqlalchemy/engine')
-rw-r--r--lib/sqlalchemy/engine/create.py9
-rw-r--r--lib/sqlalchemy/engine/interfaces.py8
2 files changed, 5 insertions, 12 deletions
diff --git a/lib/sqlalchemy/engine/create.py b/lib/sqlalchemy/engine/create.py
index e6da1d8e6..efcd2b530 100644
--- a/lib/sqlalchemy/engine/create.py
+++ b/lib/sqlalchemy/engine/create.py
@@ -34,6 +34,11 @@ from ..sql import compiler
'expressions, or an "empty set" SELECT, at statement execution'
"time.",
),
+ implicit_returning=(
+ "2.0",
+ "The :paramref:`_sa.create_engine.implicit_returning` parameter "
+ "is deprecated and will be removed in a future release. ",
+ ),
)
def create_engine(url, **kwargs):
"""Create a new :class:`_engine.Engine` instance.
@@ -278,8 +283,6 @@ def create_engine(url, **kwargs):
:paramref:`_engine.Connection.execution_options.logging_token`
-
-
:param max_identifier_length: integer; override the max_identifier_length
determined by the dialect. if ``None`` or zero, has no effect. This
is the database's configured maximum number of characters that may be
@@ -339,13 +342,11 @@ def create_engine(url, **kwargs):
"sqlalchemy.pool" logger. Defaults to a hexstring of the object's
id.
-
.. seealso::
:ref:`dbengine_logging` - further detail on how to configure
logging.
-
:param pool_pre_ping: boolean, if True will enable the connection pool
"pre-ping" feature that tests connections for liveness upon
each checkout.
diff --git a/lib/sqlalchemy/engine/interfaces.py b/lib/sqlalchemy/engine/interfaces.py
index 38d2c7a57..48b7e35a0 100644
--- a/lib/sqlalchemy/engine/interfaces.py
+++ b/lib/sqlalchemy/engine/interfaces.py
@@ -94,14 +94,6 @@ class Dialect(object):
in order to get their value. This is currently oriented towards
PostgreSQL.
- ``implicit_returning``
- use RETURNING or equivalent during INSERT execution in order to load
- newly generated primary keys and other column defaults in one execution,
- which are then available via inserted_primary_key.
- If an insert statement has returning() specified explicitly,
- the "implicit" functionality is not used and inserted_primary_key
- will not be available.
-
``colspecs``
A dictionary of TypeEngine classes from sqlalchemy.types mapped
to subclasses that are specific to the dialect class. This