Fixes: #5289

Clarify Foreign Key support on SQLite must be enabled before `MetaData.create_all`

Change-Id: Ic41b86f736be21dd6fc890a915a2ffd572df73a4

diff --git a/lib/sqlalchemy/dialects/sqlite/base.py b/lib/sqlalchemy/dialects/sqlite/base.py
index dc5ebc3f0ccc6b9a738b49612dae05415e8bd72a..08dfd56b1e31ae8a0f1c1271b6f1b2e7be543410 100644 (file)
--- a/lib/sqlalchemy/dialects/sqlite/base.py
+++ b/lib/sqlalchemy/dialects/sqlite/base.py
@@ -266,7 +266,8 @@ Constraint checking on SQLite has three prerequisites:
 * The SQLite library must be compiled *without* the SQLITE_OMIT_FOREIGN_KEY
   or SQLITE_OMIT_TRIGGER symbols enabled.
 * The ``PRAGMA foreign_keys = ON`` statement must be emitted on all
-  connections before use.
+  connections before use -- including the initial call to
+  :meth:`sqlalchemy.schema.MetaData.create_all`.
 
 SQLAlchemy allows for the ``PRAGMA`` statement to be emitted automatically for
 new connections through the usage of events::