在 Django 中使用 MongoDB

MongoEngine由Python语言写成，提供一个很类似Django ORM的API，本文介绍mongoengine的基本使用，主要是数据结构的定义和内联表单的使用。

Install & Begin

需要安装两个模块，pymongo和mongoengine

pip install -U mongoengine
pip install pymongo

现在我们以最快的方式利用Django对MongoDB进行操作，请在电脑旁放置一个秒表，理论上完成这些操作的时间不会超过3分钟：

新建一个应用，其中新建一个docs.py文件，代码如下：

from mongoengine import *
connect('test')

class User(Document):
    username = StringField(required=True)
    website = URLField()
    tags = ListField(StringField(max_length=16))

然后编辑views.py文件：

from django.http import HttpResponse
from . import docs

def index(request):
    user1 = docs.User(
        username='Perchouli',
        website='http://dmyz.org',
        tags = ['Web','Django','JS']
    )
    user1.save()
    Oid = user1.id
    return HttpResponse(Oid)

最后，把视图加到URL中，访问这个视图可以看到返回的ObjectID，我们已经实现了对NOSQL数据库的写入和查找了。是不是和Django ORM几乎一样呢？

Philosophy

回头说说代码。docs.py中的语法很类似models.py，但两者的用途完全不同。mongoengine是定义一个scheme，这些定义不会写入到数据库中。

在User中使用了三种Field，MongoDB是使用JSON格式存储数据，所以写入的值也可以是对象/数组/字典，mongoengine会自动将Python数据格式转换成JS数据格式，但必须按照之前的定义的Field类型来传值。比如上例中的tags被定义为数组(ListField)，数组中的每个元素是字符(StringField)，mongoengine只接受同样类型的数据格式。

EmbeddedField

RDB对数据的组织是建立在“关系”之上的，比如我们要存储某个用户的Profile，它与用户ID是多对一的关系，在RDB中，通常要新建一张名为Profile的表，其中包含UserID和Profile，每一条数据对应一个Profile的记录，这种方式多少显得有些笨拙。NOSQL的出现解决了这类问题，在NOSQL数据库中使用内联的方式，直接把Profile存在User下，调用User时就可以获得Profile的数据了。

修改上例中的docs.py，增加Profile：

from mongoengine import *
connect('test')
#先定义名为Profile的EmbeddedDocument
class Profile(EmbeddedDocument):
    gender = StringField()
    location = StringField()

class User(Document):
    username = StringField(required=True)
    website = URLField()
    tags = ListField(StringField(max_length=16))
    #添加到User
    profile = EmbeddedDocumentField(Profile)

再修改views.py，为了显示区别这里输出一个JSON格式的字符串：

from django.http import HttpResponse
from . import docs

def index(request):
    profile1 = docs.Profile(gender='male', location='Beijing')
    user1 = docs.User(
        username='Perchouli',
        website='http://dmyz.org',
        tags = ['Web','Django','JS'],
        profile = profile1
    )
    user1.save()
    user1_json = str(user1.to_mongo())
    return HttpResponse(user1_json)

怎么读取profile中的gender和location？我不说你可能也想到了： user1.profile.gender。其他的操作也一样，都是用for来遍历数据，查找、删除也是类似的语法。

Afterword

mongoengine这种类似ORM的写法提供了一个很好的过渡方式，但NOSQL数据库毕竟不是构建于”关系”之上的，很多ORM的经验并不适用。其实操作NOSQL数据库，对它进行增删改查并不复杂，真正头疼的是数据的建模，具体的业务逻辑，怎样设计才能最大限度的发挥NOSQL数据库的用途等等一些列问题。mongoengine降低了Django工程师使用NOSQL数据库的门槛，相信只要有更多的人参与其中，这类经验会逐步丰富和完善的。