SQLAlchemy 1.1文档
SQL表达式¶
如何将SQL表达式呈现为字符串，可能内联了绑定参数？¶
在绝大多数情况下，SQLAlchemy语句或Query的“字符串化”非常简单：
print(str(statement))这适用于ORM Query以及任何select()或其他语句。此外，要将语句编译为特定的方言或引擎，如果语句本身尚未绑定到某个语句，您可以将它传递给ClauseElement.compile()：
print(statement.compile(someengine))或者没有Engine：
from sqlalchemy.dialects import postgresql
print(statement.compile(dialect=postgresql.dialect()))当给定ORM Query对象时，为了获得ClauseElement.compile()方法，我们只需要首先访问statement访问器：
statement = query.statement
print(statement.compile(someengine))上述表单将在传递给Python DBAPI时呈现SQL语句，其中包括绑定参数不以内联方式呈现。SQLAlchemy通常不绑定绑定参数，因为这是由Python DBAPI适当地处理的，更不用说绕过绑定参数可能是现代Web应用程序中使用最广泛的安全漏洞。SQLAlchemy在某些情况下（例如发出DDL）的能力有限。为了访问这个功能，可以使用传递给compile_kwargs的literal_binds标志：
from sqlalchemy.sql import table, column, select
t = table('t', column('x'))
s = select([t]).where(t.c.x == 5)
print(s.compile(compile_kwargs={"literal_binds": True}))上面的方法有一点要注意，它只支持基本类型，例如整数和字符串，而且如果直接使用没有预设值的bindparam()，它将不会能够将其串联起来。
要支持对不支持类型的内联文字渲染，请为包含TypeDecorator.process_literal_param()方法的目标类型实现一个TypeDecorator：
from sqlalchemy import TypeDecorator, Integer
class MyFancyType(TypeDecorator):
impl = Integer
def process_literal_param(self, value, dialect):
return "my_fancy_formatting(%s)" % value
from sqlalchemy import Table, Column, MetaData
tab = Table('mytable', MetaData(), Column('x', MyFancyType()))
print(
tab.select().where(tab.c.x > 5).compile(
compile_kwargs={"literal_binds": True})
)产出如下产出：
SELECT mytable.x
FROM mytable
WHERE mytable.x > my_fancy_formatting(5)为什么.col.in_([])产生col ！= col ？为什么不1=0？¶
关于这个问题的一点介绍。SQL中的IN运算符给出了要与列进行比较的元素列表，但通常不会接受空列表，即可以这样说：
column IN (1, 2, 3)这是无效的说：
column IN ()SQLAlchemy的Operators.in_()运算符在给出一个空列表时产生这个表达式：
column != column从版本0.6开始，它也会产生一个警告，指出将会呈现效率较低的比较操作。这个表达式是唯一一个既是数据库不可知的，又能产生正确结果的表达式。
例如，“通过比较1 = 0或1！= 1来评估为假”的幼稚方法不能正确处理空值。表达式如下：
NOT column != column当“列”为空时不会返回一行，但是不考虑列的表达式：
NOT 1=0将。
更接近该商标的是以下CASE表达式：
CASE WHEN column IS NOT NULL THEN 1=0 ELSE NULL END我们不使用这个表达式，因为它的冗长，而且在WHERE子句中它也不被Oracle接受 - 取决于你如何说出它，你会得到“ORA-00905：missing keyword”或者“ORA-00920 ：无效的关系运算符“。它的效率还不如完全没有子句的情况下渲染SQL（或者根本不发布SQL，如果语句只是简单的搜索）。
因此，最好的方法是在零长度的参数列表中避免使用IN。相反，如果不应返回行，请不要首先发出查询。警告最好使用Python警告过滤器提升为完全错误状态（请参阅http://docs.python.org/library/warnings.html）。