安装MongoEngine
为了使用MongoEngine,我们首先需要先下载一个MongoDB并且确保它能正常运行,你还需要安装pymongo。
可以用pip安装MongoEngine:
$ pip install mongoengine
但是如果你没有安装setuptool,那么下载一个 MongoEngine ,然后手动安装
$ python setup.py install
如果你想用最新得MongoEngine,可以从GitHub上下载源码,然后按如下安装:
$ git clone git://github.com/hmarr/mongoengine
$ cd mongoengine
$ python setup.py install
ps:由于mongoengine底层使用的是pymongo库,所以安装mongoengine的时候一定要安装与其版本配套的pymongo版本,否 则在使用的时候或出现调用pymongo上的错误。(一般建议安装最新版的pymongo,否则要上网查下版本匹配)。
连接MongoDB
连接一个运行的MongoDB实例,可以使用connect( ) 函数。第一个参数是需要连接的数据库名称,如果该数据库不存在,那么就会新建一个相应的数据库。如果该数据库需要验证登录,那么用户名和密码这些参数也需要提供。
[python]
from mongoengine import connect
connect('project1', username='webapp', password='pwd123')
在默认情况下,MongoDB的实例是运行在localhost的27017端口上,如果MongoDB是运行于别的地方,那么就需要提供host和port参数:
[python]
connect('project1', host='192.168.1.35', port=12345)
Uri方式的连接也是支持的
[python]
connect('project1', host='mongodb://localhost/database_name')
在MongoEngine 0.6中添加了对多数据库的支持。使用多数据库的时候使用 connect( ),并且提供一个连接的别名,如果没有提供别名就使用default。
在后台里面会使用 register_connection( )来存储那些前端需要的所有别名数据。
单个的文档也能通过在它们的元数据中提供一个db_alias来实现对多数据库的支持。下面这个例子就使用了3个不同数据库来存储数据。
[python]
class User(Document):
name = StringField()
meta = {"db_alias": "user-db"}
class Book(Document):
name = StringField()
meta = {"db_alias": "book-db"}
class AuthorBooks(Document):
author = ReferenceField(User)
book = ReferenceField(Book)
meta = {"db_alias": "users-books-db"}