ndb.put_multi 是原子的吗？

Question

例如，我有一个实体列表。其中之一无效。我叫ndb.put_multi(entities_to_put)。

它应该将其中一些放入列表中然后抛出错误，还是根本不放入其中任何一个？

Answer 1

put_multi 将对所有放置的实体成功或失败。 put_multi 的实现本质上只是一个实体循环，在每个实体上调用 put；没有异常处理来隔离个别故障。

此代码演示了行为：

class Foo(ndb.Model):

    bar = ndb.IntegerProperty()

    def _pre_put_hook(self):
        # Trigger an exception during save.
        if self.bar > 10:
            raise ValueError('%d is too big' % self.bar)

# Clear any existing foos
existing = Foo.query().fetch(keys_only=True)
ndb.delete_multi(existing)

# Instantiate new foos
vals = [0, 1, 20, 3, 4]
foos = [Foo(bar=val) for val in vals]

# Save new foos
try:
    ndb.put_multi(foos)
except ValueError as ex:
    print 'Exception raised during save: %s' % ex

saved_foos = Foo.query().fetch()
print 'Saved foos:', saved_foos

# Output
Exception raised during save: 20 is too big
Saved foos: []