From: Mike Bayer <mike_mp@zzzcomputing.com>
Date: Fri, 5 May 2017 14:39:18 +0000 (-0400)
Subject: - add another note re: 339e2c13b0fc8e95a47d00c0f8fc5afc4b6dff9a
X-Git-Tag: rel_1_2_0b1~82
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=8f830d78ba1d68ea3e10006e10e65ddb571f45ee;p=thirdparty%2Fsqlalchemy%2Fsqlalchemy.git

- add another note re: 339e2c13b0fc8e95a47d00c0f8fc5afc4b6dff9a
which clarifies that ForeignKey circumvents this logic as a
"convenience".   issue #3978 is updated to address trying to make
this consistent.

Change-Id: I089acaa89f11b7a6310c2bf32916e26eb62ab9c0
---

diff --git a/lib/sqlalchemy/sql/schema.py b/lib/sqlalchemy/sql/schema.py
index 9a8f06c9e4..b7d6743be6 100644
--- a/lib/sqlalchemy/sql/schema.py
+++ b/lib/sqlalchemy/sql/schema.py
@@ -3523,6 +3523,18 @@ class MetaData(SchemaItem):
                 schema-qualified name, e.g.
                 ``my_metadata.tables["some_schema.my_table"]``.
 
+                The current behavior of the :class:`.ForeignKey` object is to
+                circumvent this restriction, where it can locate a table given
+                the table name alone, where the schema will be assumed to be
+                present from this value as specified on the owning
+                :class:`.MetaData` collection.  However, this implies  that a
+                table qualified with BLANK_SCHEMA cannot currently be referred
+                to by string name from :class:`.ForeignKey`.    Other parts of
+                SQLAlchemy such as Declarative may not have similar behaviors
+                built in, however may do so in a future release, along with a
+                consistent method of referring to a table in BLANK_SCHEMA.
+
+
            .. seealso::
 
                 :paramref:`.Table.schema`