MongoDB 与 MongoEngine

使用 MongoDB 等文档数据库是关系 SQL 数据库的常见替代方案。此模式展示了如何使用文档映射器库 MongoEngine 与 MongoDB 集成。

需要运行的 MongoDB 服务器和 Flask-MongoEngine

pip install flask-mongoengine

配置

可以在 app.config 上定义 MONGODB_SETTINGS 并创建一个 MongoEngine 实例,以完成基本设置。

from flask import Flask
from flask_mongoengine import MongoEngine

app = Flask(__name__)
app.config['MONGODB_SETTINGS'] = {
    "db": "myapp",
}
db = MongoEngine(app)

映射文档

要声明表示 Mongo 文档的模型,请创建一个继承自 Document 的类,并声明每个字段。

import mongoengine as me

class Movie(me.Document):
    title = me.StringField(required=True)
    year = me.IntField()
    rated = me.StringField()
    director = me.StringField()
    actors = me.ListField()

如果文档有嵌套字段,请使用 EmbeddedDocument 定义嵌套文档的字段,并使用 EmbeddedDocumentField 在父文档上声明它。

class Imdb(me.EmbeddedDocument):
    imdb_id = me.StringField()
    rating = me.DecimalField()
    votes = me.IntField()

class Movie(me.Document):
    ...
    imdb = me.EmbeddedDocumentField(Imdb)

创建数据

使用关键字参数为字段实例化文档类。你也可以在实例化后将值分配给字段属性。然后调用 doc.save()

bttf = Movie(title="Back To The Future", year=1985)
bttf.actors = [
    "Michael J. Fox",
    "Christopher Lloyd"
]
bttf.imdb = Imdb(imdb_id="tt0088763", rating=8.5)
bttf.save()

查询

使用类 objects 属性进行查询。关键字参数在字段上查找相等值。

bttf = Movies.objects(title="Back To The Future").get_or_404()

查询运算符可以通过使用双下划线将其与字段名称连接起来而使用。 objects 和通过调用它返回的查询是可迭代的。

some_theron_movie = Movie.objects(actors__in=["Charlize Theron"]).first()

for recents in Movie.objects(year__gte=2017):
    print(recents.title)

文档

还有更多方法可以使用 MongoEngine 定义和查询文档。有关更多信息,请查看 官方文档

Flask-MongoEngine 在 MongoEngine 之上添加了有用的实用程序。请查看它们的 文档