summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMike Bayer <mike_mp@zzzcomputing.com>2022-04-15 11:11:42 -0400
committerMike Bayer <mike_mp@zzzcomputing.com>2022-04-15 11:15:07 -0400
commit262c5a6fe10b57cba763857803699eb24fc5d20c (patch)
tree51812a247066660cd40b69c211091a76471edce2
parent07b9788690e45ea3a25cece6220cd255a16cadaf (diff)
downloadsqlalchemy-262c5a6fe10b57cba763857803699eb24fc5d20c.tar.gz
update bake_queries documentation
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)
-rw-r--r--lib/sqlalchemy/orm/_orm_constructors.py17
1 files changed, 4 insertions, 13 deletions
diff --git a/lib/sqlalchemy/orm/_orm_constructors.py b/lib/sqlalchemy/orm/_orm_constructors.py
index 6e8a0e771..ee6d56145 100644
--- a/lib/sqlalchemy/orm/_orm_constructors.py
+++ b/lib/sqlalchemy/orm/_orm_constructors.py
@@ -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