/ /

Conéctese a MongoDB

Overview

En esta guía, puedes aprender cómo configurar la conexión de tu proyecto Django con MongoDB.

Configuración de conexión

Una vez que hayas instalado Django MongoDB Backend y creado un proyecto, puedes configurar la conexión a MongoDB modificando el ajuste DATABASES en el archivo settings.py del proyecto.

Tip

Para aprender a instalar Django MongoDB Backend y crear un proyecto Django, visite el tutorial Comenzar con Django MongoDB Backend.

Establece DATABASES en un diccionario que contenga la clave default, como se muestra en el siguiente código:

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

Para configurar la clave default, asigna un diccionario anidado como su valor. Este diccionario anidado tiene las siguientes claves:

Clave	Descripción
motor	El controlador de backend que se utilizará para la conexión. Establece esta clave en `"django_mongodb_backend"`.
host	El nombre de host. Para conexiones locales, esta clave es opcional. Para conexiones SRV, debe incluir un prefijo de esquema`mongodb+srv://` (). También puede especificar un URI de conexión en esta clave. Para obtener más información, consulte Configurar automáticamente los ajustes de la base de datos. Para especificar más de un host, incluya todos los nombres de host en una sola cadena. Utilice una coma para separar cada nombre de host. Ejemplo: `"HOST": "mongodb://mongos0.example.com:27017,mongos1.example.com:27017"`
Nombre	La base de datos que desea utilizar.
USER	El nombre de usuario para autenticarse en la base de datos, si la conexión requiere autenticación.
PASSWORD	La contraseña de su usuario de base de datos, si su conexión requiere autenticación.
Puerto	El número de puerto en el que el servidor de base de datos está escuchando. El puerto predeterminado `27017` es. Para las conexiones de MongoDB Atlas, esta clave es opcional.
opciones	Diccionario de opciones de conexión adicionales para la base de datos. Esta clave es opcional. Para ver la lista completa de opciones de conexión que puede configurar en la `OPTIONS` clave, consulte los parámetros opcionales de MongoClient en la documentación de la API de PyMongo.

Esta sección muestra cómo usar el ajuste DATABASES para configurar tu conexión de las siguientes maneras:

Configurar la configuración de la base de datos automáticamente: Utilice la clave HOST anidada para especificar su URI de conexión y configurar automáticamente la configuración de conexión.
Configura los ajustes de la base de datos manualmente: Especifica los ajustes de conexión en varias teclas de diccionario.

Configurar automáticamente la configuración de la base de datos

Importante

Añadido en v5.2.1

Django MongoDB Backend v5.2.1 add soporte para especificar un URI de conexión en la clave anidada HOST. Si utilizas una versión anterior, aún puedes configurar manualmente tu conexión o utilizar la función obsoleta parse_uri().

Para especificar la configuración de la conexión en tu URI de conexión, establece las siguientes claves anidadas de default:

ENGINE: Establecer en "django_mongodb_backend".
HOSTAjuste a tu URI de conexión.
NAME: Establecido en el nombre de la base de datos que deseas usar.

Todas las demás claves descritas en la sección anterior son opcionales.

Ejemplo

Este ejemplo utiliza únicamente las claves ENGINE, HOST y NAME para configurar una conexión con MongoDB. La configuración DATABASES realiza las siguientes acciones:

Proporciona información de autenticación para un usuario de base de datos cuyo nombre de usuario es my_user y contraseña es my_password
Establece la opción de conexión retryWrites en true, lo que configura el driver para reintentar automáticamente ciertas operaciones de guardado si fallan
Establece la opción de conexión w en majority, lo que configura al controlador para esperar la confirmación de la mayoría de los miembros del conjunto de réplicas antes de realizar operaciones de escritura.
Establece la base de datos en 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",
}

Nota

Si se especifican claves adicionales en la configuración DATABASES, los valores de esas claves anulan cualquier valor en conflicto analizado desde la URI de conexión.

Configurar manualmente la configuración de la base de datos

Puedes configurar manualmente la configuración de tu conexión especificando la información de conexión a través de las claves default.

Ejemplo

Este ejemplo utiliza claves de diccionario para configurar la misma conexión de base de datos que el ejemplo anterior:

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",
        },
    },
}

Información Adicional

Para ver un proyecto de muestra que configura una conexión de base de datos MongoDB, consulta el paso Configura tu conexión de MongoDB en el tutorial de comenzar.

Para aprender más sobre la configuración de Django, consulta Configuración en la documentación de Django.

Volver

Empezar

Datos del modelo