在 SQLAlchemy ORM 中，可通过 sqlalchemy.all_() 函数配合 like() 方法，安全、声明式地实现 PostgreSQL 的 LIKE ALL (array[...]) 语义，避免使用原生 SQL，同时确保所有通配符模式全部匹配。
在 sqlalchemy orm 中，可通过 `sqlalchemy.all_()` 函数配合 `like()` 方法，安全、声明式地实现 postgresql 的 `like all (array[...])` 语义，避免使用原生 sql，同时确保所有通配符模式全部匹配。
当需要查找同时满足多个模糊匹配条件的记录（例如：document_summary 必须同时包含 "par1"、"par2" 和 "par3" 的任意位置），PostgreSQL 原生支持 LIKE ALL (ARRAY['%par1%', '%par2%', '%par3%'])。但在 ORM 场景下，不能依赖 text() 或 select() 构造原始 SQL —— 此时应使用 SQLAlchemy 内置的 all_() 函数，它是专为 ALL 集合比较设计的 SQL 表达式构造器。
all_() 并非 Python 内置的 all()，而是 SQLAlchemy 提供的 SQL 编译级函数，位于 sqlalchemy 模块顶层。它会将 Python 列表（或元组）编译为数据库端的 ALL 子句，并与左侧操作符（如 like）正确结合。
✅ 正确用法示例：
from sqlalchemy import all_
# 构建 WHERE document_summary LIKE ALL (ARRAY['%par1%', '%par2%', '%par3%'])
stmt = select(OutBoxDocument).where(
OutBoxDocument.document_summary.like(all_(["%par1%", "%par2%", "%par3%"]))
)⚠️ 注意事项：
- all_() 仅适用于支持 ALL 语法的后端（如 PostgreSQL），SQLite、MySQL 等不支持该语法，直接使用将引发编译错误；
- 模式字符串必须自行添加 % 通配符（如 "%par1%"），all_() 不做自动补全；
- 不可与 or_() / and_() 混淆：all_() 是集合量词（quantifier），作用于右侧列表，语义是“左侧值对列表中每个元素均满足 LIKE”；
- 若需动态构建模式列表（如来自用户输入），务必进行 SQL 注入防护——由于 all_() 使用参数化绑定，只要传入的是普通字符串列表，即默认安全（无需手动转义）。
完整可运行示例（基于现代 SQLAlchemy 2.0+ 风格）：
from sqlalchemy import create_engine, select, all_
from sqlalchemy.orm import DeclarativeBase, Mapped, mapped_column, Session
engine = create_engine("postgresql+psycopg2://user:pass@localhost/db", echo=True)
class Base(DeclarativeBase): pass
class OutBoxDocument(Base):
__tablename__ = "outbox_document"
id: Mapped[int] = mapped_column(primary_key=True)
document_summary: Mapped[str]
# 初始化表（仅首次运行）
Base.metadata.create_all(engine)
# 插入测试数据
with Session(engine) as session:
session.add_all([
OutBoxDocument(document_summary="This contains par1 and par2"),
OutBoxDocument(document_summary="par1 par2 par3 is here"),
OutBoxDocument(document_summary="Only par1 and par3"),
OutBoxDocument(document_summary="No match at all"),
])
session.commit()
# 查询同时匹配全部关键词的文档
with Session(engine) as session:
patterns = ["%par1%", "%par2%", "%par3%"]
stmt = select(OutBoxDocument).where(
OutBoxDocument.document_summary.like(all_(patterns))
)
results = session.scalars(stmt).all()
print(f"Found {len(results)} documents matching all patterns.")? 扩展提示：若需兼容非 PostgreSQL 数据库，可退化为链式 and_() + 多个 like() 条件（语义等价但性能略低）：
from sqlalchemy import and_ patterns = ["%par1%", "%par2%", "%par3%"] condition = and_(*[OutBoxDocument.document_summary.like(p) for p in patterns]) stmt = select(OutBoxDocument).where(condition)
总之，sqlalchemy.all_() 是 ORM 层精准映射 LIKE ALL 的标准方案，兼顾表达力、安全性与可维护性，是处理多条件模糊匹配的理想选择。
