From: Mike Bayer <mike_mp@zzzcomputing.com>
Date: Wed, 22 Sep 2021 01:12:15 +0000 (-0400)
Subject: add note to "quote" regarding case insensitive table reflection
X-Git-Tag: rel_1_4_24~5
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=d09065d43d9914a1db45b89bd845072d7970155f;p=thirdparty%2Fsqlalchemy%2Fsqlalchemy.git

add note to "quote" regarding case insensitive table reflection

this note basically states that the use case requested in
issue #7026 is not supported.  I'm not sure the note is
going to otherwise make sense to  anyone.

Fixes: #7026
Change-Id: Ib7782afc9bc5dc0c43cfab9b1f969a55c43209fe
---

diff --git a/lib/sqlalchemy/sql/schema.py b/lib/sqlalchemy/sql/schema.py
index d9c7eb8b9f..02c1b9cedb 100644
--- a/lib/sqlalchemy/sql/schema.py
+++ b/lib/sqlalchemy/sql/schema.py
@@ -440,6 +440,12 @@ class Table(DialectKWArgs, SchemaItem, TableClause):
         is only needed to force quoting of a reserved word which is not known
         by the SQLAlchemy dialect.
 
+        .. note:: setting this flag to ``False`` will not provide
+           case-insensitive behavior for table reflection; table reflection
+           will always search for a mixed-case name in a case sensitive
+           fashion.  Case insensitive names are specified in SQLAlchemy only
+           by stating the name with all lower case characters.
+
     :param quote_schema: same as 'quote' but applies to the schema identifier.
 
     :param schema: The schema name for this table, which is required if