/ /

连接至 MongoDB

Overview

在本指南中，您可以学习；了解如何配置 Django 项目与MongoDB的连接。

连接配置

安装 Django MongoDB后端并创建项目后，您可以通过修改项目的 settings.py文件中的 DATABASES 设置来配置与MongoDB的连接。

提示

要学习；了解如何安装 Django MongoDB后端并创建 Django项目，请访问 Django MongoDB后端入门教程。

将 DATABASES 设置为包含 default 键的字典，如以下代码所示：

DATABASES = {
    "default": {
        # Specify nested dictionary keys here
    },
}

要配置 default 键，请将嵌套字典指定为其值。该嵌套字典具有以下键：

键	说明
引擎	用于连接的后端驱动程序。将此键设置为 `"django_mongodb_backend"`。
主机	主机名。对于本地主机连接，此项是可选的。对于 SRV 连接，必须包含模式前缀`mongodb+srv://` ()。您还可以在此键中指定连接 URI。有关详细信息，请参阅自动配置数据库设置。要指定多个托管，请将所有主机名包含在一个字符串中。使用逗号分隔每个主机名。示例：`"HOST": "mongodb://mongos0.example.com:27017,mongos1.example.com:27017"`
名称	要使用的数据库。
用户	如果您的连接需要身份验证，则用于对数据库进行身份验证的用户名。
PASSWORD	如果您的连接需要身份验证，则数据库用户的密码。
端口	数据库服务器正在侦听的端口号。默认端口为`27017` 。对于MongoDB Atlas连接，此键是可选的。
选项	数据库附加连接选项的字典。此键是可选的。要查看可在 `OPTIONS`键中设立的连接选项的完整列表，请参阅PyMongo API文档中 MongoClient 的可选参数。

本部分介绍如何使用 DATABASES 设置通过以下方式配置连接：

自动配置数据库设置：使用嵌套的 HOST 键指定连接 URI 并自动配置连接设置。
手动配置数据库设置：指定跨多个字典键的连接设置。

自动配置数据库设置

重要

在 v5.2.1 中添加

Django MongoDB后端 v5.2.1添加了对在嵌套的 HOST 键中指定连接 URI 的支持。如果使用上一个版本，仍可手动配置连接或使用已弃用的parse_uri()函数。

要在连接 URI 中指定连接设置，设立以下嵌套的 default 键：

ENGINE：设置为"django_mongodb_backend" 。
HOST：设置为您的连接 URI。
NAME：设置为要使用的数据库的名称。

上一节中描述的所有其他键都是可选的。

例子

此示例仅使用 ENGINE、HOST 和 NAME 键来配置与MongoDB的连接。DATABASES 设置执行以下操作：

为用户名名为 my_user、密码为 my_password 的数据库用户提供身份验证信息
将 retryWrites 连接选项设置为 true，这会将驱动程序配置为在某些写入操作失败时自动重试这些写入操作
将 w 连接选项设置为 majority，这会将驱动程序配置为在执行写入操作之前等待大多数副本集成员的确认
将数据库设置为 my_database

DATABASES = {
    "default": {
        "ENGINE": "django_mongodb_backend",
        "HOST": "mongodb+srv://my_user:my_password@cluster0.example.mongodb.net/?retryWrites=true&w=majority",
        "NAME": "my_database",
}

注意

如果您在 DATABASES 设置中指定其他键，则这些键中的值会覆盖从连接 URI 解析的任何冲突值。

手动配置数据库设置

您可以通过 default 键指定连接信息来手动配置连接设置。

例子

此示例使用字典键配置与上一示例相同的数据库连接：

DATABASES = {
    "default": {
        "ENGINE": "django_mongodb_backend",
        "HOST": "mongodb+srv://cluster0.example.mongodb.net",
        "NAME": "my_database",
        "USER": "my_user",
        "PASSWORD": "my_password",
        "PORT": 27017,
        "OPTIONS": {
            "retryWrites": "true",
            "w": "majority",
        },
    },
}