SQLAlchemy 的 session.merge() 可以使用数据库中的新数据更新其结果吗？

Question

SQLAlchemy 文档说“session.merge() 协调实例的当前状态及其关联子项与数据库中的现有数据”。

现有对象的状态是否会被数据库中的新数据更新？如何？什么时候？

Answer 1

SQLAlchemy 被设计为在会话中具有每个身份的单个对象。但有时您必须重新创建具有已知身份的对象，例如当您从网络获取它或当您实施离线锁定以避免长时间事务时。当您创建一个可能存在于数据库中的具有已知身份的对象时，会话有可能已经跟踪具有此身份的对象。这就是merge() 方法的用途：它返回一个附加到会话的对象，从而避免会话中具有相同标识的重复对象。下面是一个说明发生了什么的例子：

from sqlalchemy import *
from sqlalchemy.orm import *

metadata = MetaData()

t = Table(
    't', metadata,
    Column('id', Integer, primary_key=True),
    Column('state', String(10)),
)

class Model(object): pass

mapper(Model, t)

engine = create_engine('sqlite://')
metadata.create_all(engine)

session = sessionmaker(bind=engine)()

obj1 = Model()
obj1.state = 'value1'
session.add(obj1)
session.commit()
obj_id = obj1.id

obj2 = Model()
obj2.id = obj_id
obj2.state = 'value2'
obj3 = session.merge(obj2)
session.commit()
print obj3 is obj1, obj3 is obj2
print obj3.state

输出是：

True False
value2

于是session.merge(obj2)发现有一个相同身份的对象（上面创建的obj1），于是将obj2的状态合并到现有对象中并返回。

下面是另一个例子，说明从数据库加载状态：

# ...skipped...

t = Table(
    't', metadata,
    Column('id', Integer, primary_key=True),
    Column('state1', String(10)),
    Column('state2', String(10)),
)

# ...skipped...

obj1 = Model()
obj1.state1 = 'value1-1'
obj1.state2 = 'value2-1'
session.add(obj1)
session.commit()
obj_id = obj1.id
session.expunge_all()

obj2 = Model()
obj2.id = obj_id
obj2.state1 = 'value1-2'
obj3 = session.merge(obj2)
session.commit()
print obj3 is obj1, obj3 is obj2
print obj3.state1, obj3.state2

输出是：

False False
value1-2 value2-1

现在merge() 没有在会话中找到具有相同身份的对象，因为我们已将其删除。我还创建了部分分配状态的新对象，但其余部分是从数据库加载的。

Answer 2

我注意到关于合并的一件事是，即使访问未附加对象上的字段也会导致它在合并期间被修改。

例如，如果我有一个简单的类

class X(Base):
    __tablename__= 'x'

    id = Column(Integer, primary_key=True)
    name = Column(String)
    value = Column(String)

还有一行

(1, 'foo', 'bar')

然后以下似乎很好地合并：

x = X(id=1)
merged_x = session.merge(x)

print merged_x.name         # 'foo'
print merged_x.description  # 'bar'

但如果我阅读名称或描述，就会发生这种情况

x = X(id=1)
print x.name                # None

merged_x = session.merge(x)

print merged_x.name         # None
print merged_x.description  # 'bar'

这是违反直觉的，我认为是不正确的。有没有办法关闭这种行为？显然，仅仅存在 __dict__ 中的属性就会导致这种情况发生。此“功能”应在文档中注明。