SQLAlchemy ORM - 文本 SQL


前面已经从SQLAlchemy核心表达语言的角度解释了使用text()函数的文本SQL。现在我们将从ORM的角度来讨论它。

通过使用 text() 构造指定文字字符串的使用,可以将文字字符串灵活地与 Query 对象一起使用。大多数适用的方法都接受它。例如,filter() 和 order_by()。

在下面给出的示例中,filter() 方法将字符串“id<3”转换为 WHERE id<3

from sqlalchemy import text
for cust in session.query(Customers).filter(text("id<3")):
   print(cust.name)

生成的原始 SQL 表达式显示过滤器到 WHERE 子句的转换,代码如下:

SELECT customers.id 
AS customers_id, customers.name 
AS customers_name, customers.address 
AS customers_address, customers.email 
AS customers_email
FROM customers
WHERE id<3

从客户表中的示例数据中,将选择两行并打印名称列,如下所示 -

Ravi Kumar
Komal Pande

要使用基于字符串的 SQL 指定绑定参数,请使用冒号,并使用 params() 方法指定值。

cust = session.query(Customers).filter(text("id = :value")).params(value = 1).one()

Python 控制台上显示的有效 SQL 如下所示:

SELECT customers.id 
AS customers_id, customers.name 
AS customers_name, customers.address 
AS customers_address, customers.email 
AS customers_email
FROM customers
WHERE id = ?

要使用完全基于字符串的语句,可以将表示完整语句的 text() 构造传递给 from_statement()。

session.query(Customers).from_statement(text("SELECT * FROM customers")).all()

上述代码的结果将是一个基本的 SELECT 语句,如下所示 -

SELECT * FROM customers

显然,客户表中的所有记录都会被选择。

text() 构造允许我们将其文本 SQL 按位置链接到 Core 或 ORM 映射列表达式。我们可以通过将列表达式作为位置参数传递给 TextClause.columns() 方法来实现此目的。

stmt = text("SELECT name, id, name, address, email FROM customers")
stmt = stmt.columns(Customers.id, Customers.name)
session.query(Customers.id, Customers.name).from_statement(stmt).all()

即使 SQLite 引擎执行上述代码生成的以下表达式(显示 text() 方法中的所有列),也会选择所有行的 id 和 name 列 -

SELECT name, id, name, address, email FROM customers