From 75a601e2fda7b849b858455eaa17d772bd2381e5 Mon Sep 17 00:00:00 2001 From: Mike Bayer Date: Mon, 21 Mar 2022 09:07:51 -0400 Subject: [PATCH] add note that schema translate not supported per object Fixes: #7832 Change-Id: I241e4cbd1b5d6df46e49e29e4ab1cac021f2895c --- doc/build/core/connections.rst | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/doc/build/core/connections.rst b/doc/build/core/connections.rst index 2e188e20e6..f749dbe4a3 100644 --- a/doc/build/core/connections.rst +++ b/doc/build/core/connections.rst @@ -757,6 +757,14 @@ as the schema name is passed to these methods explicitly. session = Session(schema_engine) + When using the ORM, the schema translate feature is only supported as + **a single schema translate map per Session**. It will **not work** if + different schema translate maps are given on a per-statement basis, as + the ORM :class:`_orm.Session` does not take current schema translate + values into account for individual objects. In other words, all + objects loaded in a particular :class:`_orm.Session` must be based on the + **same** ``schema_translate_map``. + ... -- 2.47.2