在使用 SQLAlchemy 时，有时候我们想要查看生成的 SQL 语句以便于调试或理解程序的行为。SQLAlchemy 提供了几种方式来打印或记录生成的 SQL 语句。以下是一些常用的方法：
1. 使用 echo 参数
在创建 Engine 时，可以通过设置 echo=True 来让 SQLAlchemy 在控制台打印出所有的 SQL 语句。这是最简单直接的方法，适用于快速调试。
from sqlalchemy import create_engine# 替换为你的数据库连接字符串
engine = create_engine('sqlite:///yourdatabase.db', echo=True)
2. 使用 echo_pool 参数
如果你还想看到连接池相关的日志（如连接创建、释放等），可以设置 echo_pool=True。
engine = create_engine('sqlite:///yourdatabase.db', echo=True, echo_pool=True)
3. 使用日志记录（Logging）
对于更复杂的日志需求，你可以使用 Python 的标准日志记录系统来捕获 SQLAlchemy 的日志。这允许你更细粒度地控制日志的输出，比如将日志输出到文件而不是控制台。
首先，你需要配置 Python 的日志记录系统：
import logging
from sqlalchemy import create_engine# 配置日志
logging.basicConfig()
logging.getLogger('sqlalchemy.engine').setLevel(logging.INFO)# 创建 Engine
engine = create_engine('sqlite:///yourdatabase.db')
在这个例子中，我们设置了 SQLAlchemy 的 engine 日志记录器的级别为 INFO，这意味着它会记录所有 INFO 级别及以上的日志，包括 SQL 语句。
4. 使用 events 系统
SQLAlchemy 的 events 系统允许你监听和响应数据库引擎的各种事件，包括 SQL 语句的执行。你可以通过监听 before_execute 或 after_execute 事件来捕获 SQL 语句。
from sqlalchemy import create_engine, eventengine = create_engine('sqlite:///yourdatabase.db')@event.listens_for(engine, "before_execute")
def before_execute(conn, clauseelement, multiparams, params):print(str(clauseelement.compile(dialect=conn.dialect)))# 现在，每当执行 SQL 语句时，它都会被打印出来
注意，使用 events 系统可能会稍微复杂一些，但它提供了最大的灵活性，允许你在 SQL 语句执行前后执行自定义的代码。
结论
根据你的具体需求（如快速调试、日志记录到文件、或执行前后执行自定义代码），你可以选择最适合你的方法来打印或记录 SQLAlchemy 生成的 SQL 语句。