简介
与同样是连接MongoDB数据库的pymongo相比,我认为mongoengine更合适
连接数据库
MongoEngine 提供 connect() 函数来连接到正在运行的 mongodb 服务器实例。
from mongoengine import connect
connect(‘mydata.db’) # mydata.db为数据库名称
默认情况下,MongoDB 服务器在本地主机和端口 27017 上运行。如果要自定义,应该向 connect() 提供主机和端口参数 −
connect('mydata.db', host='192.168.1.1', port=12345)
如果数据库需要身份验证,则应提供凭据,例如用户名、密码和 authentication_source 参数。
connect('mydata.db', username='user1', password='***', authentication_source='admin')
MongoEngine 还支持 URI 样式连接而不是 IP 地址。
connect('mydata.db', host='mongodb://localhost/database_name')
MongoEngine 还允许连接多个数据库。 您需要为每个数据库提供唯一的别名。 例如,以下代码将 Python 脚本连接到两个 MongoDB 数据库。
connect(alias='db1', db='db1.db')
connect(alias='db2', db='db2.db')
Document 文档类
MongoEngine 被称为 ODM(对象文档映射器)。 MongoEngine 定义了一个文档类。 这是一个基类,其继承类用于定义存储在 MongoDB 数据库中的文档集合的结构和属性。 该子类的每个对象在数据库中形成 Collection 中的 Document。
此 Document 子类中的属性是各种 Field 类的对象。 以下是典型文档类的示例 −
from mongoengine import *
class Student(Document):
studentid = StringField(required=True)
name = StringField(max_length=50)
age = IntField()
def _init__(self, id, name, age):
self.studentid=id,
self.name=name
self.age=age
这看起来类似于 SQLAlchemy ORM 中的模型类。 默认情况下,数据库中 Collection 的名称是 Python 类名称转换为小写后的名称。 但是,可以在 Document 类的元属性中指定不同的集合名称。
meta={collection': 'student_collection'}
现在声明此类的对象并调用 save() 方法将文档存储在数据库中。
s1=Student('A001', 'Tara', 20)
s1.save()
动态模式
MongoDB 数据库的优点之一是它支持动态模式。 要创建支持动态模式的类,请从 DynamicDocument 基类继承它。 以下是具有动态模式的学生类 −
class student(DynamicDocument):
name=StringField()
第一步是像以前一样添加第一个 Document。
s1=student()
s1.name="Tara"
connect('mydb')
s1.save()
现在向第二个文档添加另一个属性并保存。
s2=student()
setattr(s2,'age',20)
s2.name='Lara'
s2.save()
Document类的其他参数如下表 −
objects | 在访问时延迟创建的 QuerySet 对象。 |
cascade_save() | 递归保存文档中的所有引用和通用引用。 |
clean() | 用于在运行验证之前进行文档级数据清理的挂钩。 |
create_index() | 如果需要,创建给定的索引。 |
drop_collection() | 从数据库中删除与此文档类型关联的整个集合。 |
from_json() | 将 json 数据转换为 Document 实例。 |
modify() | 对数据库中的文档执行原子更新,并使用更新后的版本重新加载文档对象。 |
pk | 获取主键 |
save() | 将文档保存到数据库。 如果文档已经存在,它将被更新,否则将被创建。 返回保存的对象实例。 |
delete() | 从数据库中删除当前文档。 |
insert() | 执行批量插入操作。 |