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

显然，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 引擎执行上述代码生成的以下表达式，所有行的 id 和 name 列也将被选择，显示 text() 方法中的所有列 –

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