MongoEngine连接MongoDB完全指南

毛彤影

于 2025-06-09 09:21:20 发布

阅读量369

点赞数 5

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_00094/article/details/148527192

MongoEngine连接MongoDB完全指南

mongoengine A Python Object-Document-Mapper for working with MongoDB 项目地址: https://gitcode.com/gh_mirrors/mo/mongoengine

连接基础概念

MongoEngine作为Python中优秀的MongoDB对象文档映射(ODM)工具，其连接管理机制是开发者需要掌握的核心内容。与传统的数据库连接不同，MongoEngine采用全局注册的连接管理方式，每个连接通过别名(alias)进行标识。当不指定别名时，系统默认使用"default"作为连接别名。

基础连接方式

最基本的连接方式只需要指定数据库名称：

from mongoengine import connect
connect('project1')

这种简写形式默认连接本地MongoDB实例(localhost:27017)。在实际生产环境中，我们通常需要更详细的连接配置。

推荐连接方式：URI字符串

MongoDB官方推荐使用URI格式的连接字符串，这种方式简洁且功能全面：

connect(host="mongodb://127.0.0.1:27017/my_db")

认证连接示例

当数据库需要认证时，URI中可以包含用户名、密码和认证源：

# 使用admin数据库进行认证
connect(host="mongodb://my_user:my_password@127.0.0.1:27017/my_db?authSource=admin")

# 使用目标数据库自身进行认证
connect(host="mongodb://my_user:my_password@127.0.0.1:27017/my_db?authSource=my_db")

高级配置

URI字符串支持多种高级配置参数：

# 启用SSL并使用副本集
connect(host="mongodb://my_user:my_password@127.0.0.1:27017/my_db?authSource=admin&ssl=true&replicaSet=globaldb")

备选连接方式：关键字参数

对于偏好显式配置的开发者，可以使用关键字参数方式：

connect(
    'my_db', 
    host='127.0.0.1', 
    port=27017,
    username='my_user',
    password='my_password',
    authentication_source='admin'
)

这种方式支持PyMongo MongoClient的所有参数，包括read_preference、replicaset、tls等。

多数据库管理

MongoEngine支持同时连接多个数据库，通过别名机制实现：

# 注册多个数据库连接
connect(alias='user-db-alias', db='user-db')
connect(alias='book-db-alias', db='book-db')

文档级数据库分配

可以在文档类的meta中指定使用的数据库别名：

class User(Document):
    name = StringField()
    meta = {'db_alias': 'user-db-alias'}

连接断开管理

使用disconnect函数可以断开指定别名的连接：

from mongoengine import disconnect
disconnect(alias='db1')  # 断开特定连接
disconnect()  # 断开默认连接

上下文管理器

MongoEngine提供了强大的上下文管理器，用于临时切换数据库或集合。

切换数据库

from mongoengine.context_managers import switch_db

with switch_db(User, 'archive-user-db') as ArchivedUser:
    ArchivedUser(name='Old Data').save()  # 保存到归档数据库

切换集合

from mongoengine.context_managers import switch_collection

with switch_collection(Group, 'historical_groups') as HistoricalGroup:
    HistoricalGroup(name='Deprecated').save()  # 保存到历史集合