MongoEngine 添加/删除文档


我们已经使用 Document 类的 save() 方法在集合中添加了一个文档。可以借助以下参数进一步自定义 save() 方法:

force_insert 默认为 False,如果设置为 True,则不允许更新现有文档。
validate 验证文件;设置为 False 跳过。
clean 调用文档清理方法,验证参数应为 True。
write_concern 将用作生成的 getLastError 命令的选项。例如, save(..., write_concern={w: 2, fsync: True}, ...) 将等到至少有两台服务器记录了写入,并在主服务器上强制执行 fsync。
cascade 设置级联保存的标志。你可以通过在文档 __meta__ 中设置“级联”来设置默认值。
cascade_kwargs 要传递的可选关键字参数 throw 到级联保存。相当于级联=真。
_refs 级联保存中使用的已处理引用列表
保存条件 仅当 db 中的匹配记录满足条件时才执行保存。如果条件不满足,则引发 OperationError
signal_kwargs 要传递给信号调用的 kwargs 字典。

你可以在调用 save() 之前设置文档验证的清理规则。通过提供自定义 clean() 方法,你可以进行任何预验证/数据清理。

class MyDocument(Document):
    ...
    ...
   
    def clean(self):
        if <condition>==True:
            msg = 'error message.'
            raise ValidationError(msg)

请注意,仅在打开验证并调用 save() 时才调用 Clean。

文档类也有 insert() 方法来执行批量插入。它有以下参数:

doc_or_docs 要插入的文档或文档列表
load_bulk 如果为 True,则返回文档实例列表
write_concern 额外的关键字参数被传递给 insert() ,它将用作生成的 getLastError 命令的选项。
signal_kwargs (可选)要传递给信号调用的 kwargs 字典

如果 document 包含任何 ReferenceField 对象,则默认情况下 save() 方法不会保存对这些对象的任何更改。如果你还希望保存所有引用,请注意每个保存都是一个单独的查询,然后将级联作为 True 传递给 save 方法将级联任何保存。

通过调用 delete() 方法,从集合中删除文档非常简单。请记住,它只有在文档之前已保存时才会生效。 delete() 方法有以下参数:

signal_kwargs (可选)要传递给信号调用的 kwargs 字典。
write_concern 额外的关键字参数被传递下来,它们将用作生成的 getLastError 命令的选项。

要从数据库中删除整个集合,请使用 drop_collection() 方法。它从数据库中删除与此 Document 类型关联的整个集合。如果文档没有集合集(例如,如果它是抽象的),则该方法引发 OperationError。

The modify() 文档类中的方法执行数据库中文档的原子更新并重新加载其更新版本。如果文档已更新,则返回 True,如果数据库中的文档与查询不匹配,则返回 False。请注意,如果该方法返回 True,则对文档所做的所有未保存的更改都将被拒绝。

参数


query 仅当数据库中的文档与查询匹配时才会执行更新
update Django 风格的更新关键字参数