Python利用MongoEngine操作MongoDB数据库完整指南

码头散步
码头散步
发布时间:2026-10-13| 7人浏览过
原创

本文详解Python中如何使用MongoEngine对MongoDB进行ORM操作。内容涵盖安装配置、Model类定义、字段属性设置,以及保存、查询(含Q对象复杂查询)、修改等核心操作。通过对比PyMongo,说明MongoEngine在解耦代码、提升可维护性方面的优势,适合需要结构化操作文档数据库的开发者参考。

简介:

MongoEngine 是一个文档对象映射器(Document-Object Mapper,简称DOM,类似关系型数据库中的ORM,但专为文档型数据库设计)。通过它,Python程序可以与MongoDB进行交互。有人可能会问,PyMongo不也是ORM吗?在Python中万物皆对象,但这里提到的ORM中的“Object”特指开发者自定义的类,而非Python内置类型。MongoEngine和MongoKit都能将MongoDB中的数据映射为自定义类的实例,且它们都基于PyMongo构建。我们可以将关系型数据库的Python客户端MySQLdb与ORM框架SQLAlchemy或Django ORM进行类比:PyMongo类似于MySQLdb,而MongoEngine则类似于SQLAlchemy,即MongoEngine是在PyMongo之上封装的ORM层。

虽然可以直接使用pymongo操作MongoDB数据库,但如果将数据库操作代码直接写在脚本中,会导致应用代码耦合度过高,且不利于代码的优化与管理。

现代应用通常采用MVC(模型-视图-控制器)架构设计。为了保持MVC结构的清晰,需要将数据库操作部分作为Model层抽离出来,此时MongoEngine便派上了用场。MongoEngine提供的抽象基于类,所有创建的模型均为类。正如前文所述,我们可以将关系型数据库的Python客户端MySQLdb与ORM框架SQLAlchemy或Django ORM进行类比:PyMongo类似于MySQLdb,而MongoEngine则类似于SQLAlchemy,即MongoEngine是在PyMongo之上封装的ORM层。

安装

pip install mongoengine

使用

1.使用时先声明一个继承自MongoEngine.Document的类

在类中声明一些属性,相当于创建一个用来保存数据的数据结构,即数据已类似数据结构的形式存入数据库中,通常把这样的一些类都存放在一个脚本中,作为应用的Model模块

from mongoengine import *
connect('mydb', host='localhost', port=27017)
import datetime
class Users(Document):
 name = StringField(required=True, max_length=200)
 age = IntField(required=True)

users = Users.objects.all() #返回所有的文档对象列表
for u in users:
 print("name:",u.name,",age:",u.age)

2.保存文档

required:设置必须;

default:如果没有其他值给出使用指定的默认值

unique:确保集合中没有其他document有此字段的值相同

choices:确保该字段的值等于数组中的给定值之一

from mongoengine import *
connect('mydb', host='localhost', port=27017)
import datetime
class Users(Document):
 name = StringField(required=True, max_length=200)
 age = IntField(required=True)
user1 = Users(
 name='jack',
 age= 21
)
user1.save() 
print(user1.name)
user1.name = 'jack2'
user1.save()  
print(user1.name)

3.查询10=<年龄<30的,按姓名排列

from mongoengine import *
connect('mydb', host='localhost', port=27017)
import datetime
class Users(Document):
 name = StringField(required=True, max_length=200)
 age = IntField(required=True)
user_search = Users.objects(age__gte=10, age__lt=33).order_by('name')
for u in user_search:
 print("name:",u.name,",age:",u.age)

查询10=<年龄<30的,按姓名倒序

from mongoengine import *
connect('mydb', host='localhost', port=27017)
import datetime
class Users(Document):
 name = StringField(required=True, max_length=200)
 age = IntField(required=True)
user_search = Users.objects(age__gte=10, age__lt=33).order_by('-name')
for u in user_search:
 print("name:",u.name,",age:",u.age)

查询name=jack2

from mongoengine import *
connect('mydb', host='localhost', port=27017)
import datetime
class Users(Document):
 name = StringField(required=True, max_length=200)
 age = IntField(required=True)

tmp = Users.objects(name="jack2")
for u in tmp:
 print("name:",u.name,",age:",u.age)

4.修改name=jack2 的age加1

from mongoengine import *
connect('mydb', host='localhost', port=27017)
import datetime
class Users(Document):
 name = StringField(required=True, max_length=200)
 age = IntField(required=True)
tmp = Users.objects(name="jack3").update(inc__age=1)
tmp = Users.objects(name="jack3")
for u in tmp:
 print("name:",u.name,",age:",u.age)

修改name=jack的age设为66

from mongoengine import *
connect('mydb', host='localhost', port=27017)
import datetime
class Users(Document):
 name = StringField(required=True, max_length=200)
 age = IntField(required=True)

tmp = Users.objects(name="jack").update(set__age=66)
tmp = Users.objects(name="jack")
for u in tmp:
 print("name:",u.name,",age:",u.age)

高级查询

例如有时候你需要将约束条件进行与,或的操作。你可以使用mongoengine提供的 Q 类来实现,一个 Q 类代表了一个查询的一部分,里面的参数设置与你查询document的时候相同。建立一个复杂查询的时候,你需要用 & 或 | 操作符将 Q 对象连结起来,例子如下:

Post.objects(Q(name="jack") | Q(age=66))

查询相关操作符

ne – 不等于 lt – 小于 lte – 小于等于 gt – 大于 gte – 大于等于 not – 使其检查的反面,需要使用在其他操作符之前(e.g. Q(age__not__mod=5)) in – 值在list里面 nin – 值不在list里面 mod – value % x == y all – list里面所有的值 size – 这个array的大小 exists – 存在这个值 #一下操作符在需要进行正则检查的时候是比较快捷的方法: exact – 字符串型字段完全匹配这个值 iexact – 字符串型字段完全匹配这个值(大小写敏感) contains – 字符串字段包含这个值 icontains –字符串字段包含这个值(大小写敏感) startswith – 字符串字段由这个值开头 istartswith –字符串字段由这个值开头(大小写敏感) endswith – 字符串字段由这个值结尾 iendswith –字符串字段由这个值结尾(大小写敏感) match – 使你可以使用一整个document与数组进行匹配查询list

总结

以上就是这篇文章的全部内容了,希望本文的内容对大家的学习或者工作具有一定的参考学习价值,如果有疑问大家可以留言交流,谢谢大家对本站的支持。

免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。

Python 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。