使用一个 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 添加了有用的工具,请参阅其 文档说明 。