From: Mike Bayer <mike_mp@zzzcomputing.com>
Date: Wed, 20 Jan 2016 17:10:40 +0000 (-0500)
Subject: - add a note that the literal_binds flag should be used
X-Git-Tag: rel_1_1_0b1~84^2~29
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=165fa15b0f9dbca50539aa7da377c5da5ac0fc79;p=thirdparty%2Fsqlalchemy%2Fsqlalchemy.git

- add a note that the literal_binds flag should be used
when cross-compiling from DDL to SQL, fixes #3615
---

diff --git a/lib/sqlalchemy/ext/compiler.py b/lib/sqlalchemy/ext/compiler.py
index 9717e41c01..d4d2ed2efa 100644
--- a/lib/sqlalchemy/ext/compiler.py
+++ b/lib/sqlalchemy/ext/compiler.py
@@ -121,9 +121,19 @@ below where we generate a CHECK constraint that embeds a SQL expression::
     def compile_my_constraint(constraint, ddlcompiler, **kw):
         return "CONSTRAINT %s CHECK (%s)" % (
             constraint.name,
-            ddlcompiler.sql_compiler.process(constraint.expression)
+            ddlcompiler.sql_compiler.process(
+                constraint.expression, literal_binds=True)
         )
 
+Above, we add an additional flag to the process step as called by
+:meth:`.SQLCompiler.process`, which is the ``literal_binds`` flag.  This
+indicates that any SQL expression which refers to a :class:`.BindParameter`
+object or other "literal" object such as those which refer to strings or
+integers should be rendered **in-place**, rather than being referred to as
+a bound parameter;  when emitting DDL, bound parameters are typically not
+supported.
+
+
 .. _enabling_compiled_autocommit:
 
 Enabling Autocommit on a Construct