如何正确使用SQLAlchemy的hybrid_method与hybrid_property？

核心差异 #

• hybrid_property：类属性形式，仅接收self参数，将属性或无参数计算逻辑包装为类属性，同时支持Python实例访问与SQL查询转换。
• hybrid_method：类方法形式，需接收self之外的额外参数，用于需要动态参数的计算逻辑，同样支持实例调用与SQL表达式转换。

正确用法示例 #

1. hybrid_property：无参数属性/计算 #

适用于不需要外部参数的属性组合或计算，比如拼接用户姓名：

from sqlalchemy.ext.hybrid import hybrid_property
from sqlalchemy import Column, String, Integer
from sqlalchemy.ext.declarative import declarative_base

Base = declarative_base()

class User(Base):
    __tablename__ = 'users'
    id = Column(Integer, primary_key=True)
    first_name = Column(String(50))
    last_name = Column(String(50))

    @hybrid_property
    def full_name(self):
        # Python实例层面的计算逻辑（适配Python2.7）
        return "%s %s" % (self.first_name, self.last_name)

    @full_name.expression
    def full_name(cls):
        # 转换为SQL层面的表达式
        return cls.first_name + ' ' + cls.last_name

使用场景：

• 实例访问：user = User(first_name="John", last_name="Doe")，直接通过user.full_name获取拼接后的姓名。
• SQL查询：session.query(User).filter(User.full_name == "John Doe").all()，会自动转换为SQL字符串拼接条件。

2. hybrid_method：带参数的动态计算 #

适用于需要外部参数的计算逻辑，比如根据折扣率计算商品折后价：

from sqlalchemy.ext.hybrid import hybrid_method
from sqlalchemy import Column, Numeric, Integer
from sqlalchemy.ext.declarative import declarative_base

Base = declarative_base()

class Product(Base):
    __tablename__ = 'products'
    id = Column(Integer, primary_key=True)
    price = Column(Numeric(10, 2))

    @hybrid_method
    def discounted_price(self, discount_rate):
        # Python实例层面的计算，接收外部参数discount_rate
        return self.price * (1 - discount_rate)

    @discounted_price.expression
    def discounted_price(cls, discount_rate):
        # 转换为SQL层面的表达式，参数会传入SQL计算
        return cls.price * (1 - discount_rate)

使用场景：

• 实例调用：product = Product(price=100.0)，通过product.discounted_price(0.2)计算80.0的折后价。
• SQL查询：session.query(Product).filter(Product.discounted_price(0.2) < 90).all()，自动转换为SQL中的数值计算条件。

关键注意事项（适配1.0.9版本） #

• 必须同时实现@hybrid_property/@hybrid_method和对应的@xxx.expression装饰器，才能确保Python实例逻辑与SQL查询逻辑一致。
• Python2.7中字符串格式化需使用%而非f-string，避免语法错误。
• SQL表达式需适配目标数据库语法（比如MySQL字符串拼接需用concat函数，示例中+适用于SQLite/PostgreSQL）。

内容的提问来源于stack exchange，提问作者Klutch27