SQLAlchemy Core - 使用文本 SQL

SQLAlchemy 允许您只使用字符串，适用于 SQL 已知且语句不需要支持动态功能的情况。 text() 构造用于编写传递给数据库的文本语句，该语句基本不变。

它构造一个新的 TextClause，直接表示文本 SQL 字符串，如以下代码所示 −

from sqlalchemy import text
t = text("SELECT * FROM students")
result = connection.execute(t)

与纯字符串相比，text() 提供的优势是 −

• 对绑定参数的后端中立支持
• 每个语句的执行选项
• 结果列类型行为

text() 函数需要命名冒号格式的绑定参数。无论数据库后端如何，它们都是一致的。要为参数发送值，我们将它们作为附加参数传递到 execute() 方法中。

以下示例在文本 SQL 中使用绑定参数 −

from sqlalchemy.sql import text
s = text("select students.name, students.lastname from students where students.name between :x and :y")
conn.execute(s, x = 'A', y = 'L').fetchall()

text() 函数构造 SQL 表达式如下 −

select students.name, students.lastname from students where students.name between ? and ?

x = 'A' 和 y = 'L' 的值作为参数传递。结果是名称介于"A"和"L"之间的行列表 −

[('Komal', 'Bhandari'), ('Abdul', 'Sattar')]

text() 构造支持使用 TextClause.bindparams() 方法预先设定的绑定值。参数也可以按如下方式明确输入 −

stmt = text("SELECT * FROM students WHERE students.name BETWEEN :x AND :y")

stmt = stmt.bindparams(
   bindparam("x", type_= String), 
   bindparam("y", type_= String)
)

result = conn.execute(stmt, {"x": "A", "y": "L"})

The text() function also be produces fragments of SQL within a select() object that 
accepts text() objects as an arguments. The “geometry” of the statement is provided by 
select() construct , and the textual content by text() construct. We can build a statement 
without the need to refer to any pre-established Table metadata. 

from sqlalchemy.sql import select
s = select([text("students.name, students.lastname from students")]).where(text("students.name between :x and :y"))
conn.execute(s, x = 'A', y = 'L').fetchall()

您还可以使用 and() 函数在借助 text() 函数创建的 WHERE 子句中组合多个条件。

from sqlalchemy import and_
from sqlalchemy.sql import select
s = select([text("* from students")]) \
.where(
   and_(
      text("students.name between :x and :y"),
      text("students.id>2")
   )
)
conn.execute(s, x = 'A', y = 'L').fetchall()

上述代码获取名称介于"A"和"L"之间且 id 大于 2 的行。代码的输出如下所示 −

[(3, 'Komal', 'Bhandari'), (4, 'Abdul', 'Sattar')]