.one() 和 .first() 有什么区别

Question

SQLAlchemy 中one 和first 方法有什么区别

Answer 1

Query.one() 要求结果集中只有一个个结果；如果数据库返回 0 个或 2 个或更多结果，则会引发异常。

Query.first() 返回可能更大的结果集中的第一个（将LIMIT 1 添加到查询中），如果没有结果，则返回None。不会引发异常。

来自Query.one() 的文档：

只返回一个结果或引发异常。

来自Query.first()：

如果结果不包含任何行，则返回此查询的第一个结果或无。

（强调我的）。

就 Python 列表而言，one() 将是：

def one(lst):
    if not lst:
        raise NoResultFound
    if len(lst) > 1:
        raise MultipleResultsFound
    return lst[0]

而first() 将是：

def first(lst):
    return lst[0] if lst else None

还有一个Query.one_or_none() 方法，仅当查询有多个结果时才会引发异常。否则它将返回单个结果，如果没有结果，则返回 None。

在列表中，这相当于：

def one_or_none(lst):
    if not lst:
        return None
    if len(lst) > 1:
        raise MultipleResultsFound
    return lst[0]