]> git.ipfire.org Git - thirdparty/sqlalchemy/sqlalchemy.git/commitdiff
update bake_queries documentation
authorMike Bayer <mike_mp@zzzcomputing.com>
Fri, 15 Apr 2022 15:11:42 +0000 (11:11 -0400)
committerMike Bayer <mike_mp@zzzcomputing.com>
Fri, 15 Apr 2022 15:15:07 +0000 (11:15 -0400)
this parameter has had no effect since 1.4.23 in #6889,
but the documentation was not updated.

Change-Id: I36f4ea6144b9fd09243f96698e7a03cd217da1e7
(cherry picked from commit 2ea124b61f0ef98d398c43299509224e9a9d77f6)

lib/sqlalchemy/orm/_orm_constructors.py

index 6e8a0e77133de5fcd1c9c5e0e0f8f4b3ffba36c0..ee6d5614522bbb67a5bf88b3eaf5fcd25bea131a 100644 (file)
@@ -1099,20 +1099,11 @@ def relationship(
             :ref:`error_qzyx` - usage example
 
     :param bake_queries=True:
-      Enable :ref:`lambda caching <engine_lambda_caching>` for loader
-      strategies, if applicable, which adds a performance gain to the
-      construction of SQL constructs used by loader strategies, in addition
-      to the usual SQL statement caching used throughout SQLAlchemy. This
-      parameter currently applies only to the "lazy" and "selectin" loader
-      strategies. There is generally no reason to set this parameter to
-      False.
+        Legacy parameter, not used.
 
-      .. versionchanged:: 1.4  Relationship loaders no longer use the
-         previous "baked query" system of query caching.   The "lazy"
-         and "selectin" loaders make use of the "lambda cache" system
-         for the construction of SQL constructs,
-         as well as the usual SQL caching system that is throughout
-         SQLAlchemy as of the 1.4 series.
+          .. versionchanged:: 1.4.23 the "lambda caching" system is no longer
+             used by loader strategies and the ``bake_queries`` parameter
+             has no effect.
 
     :param cascade:
       A comma-separated list of cascade rules which determines how