Notas de versión

Versión 6.0.3

La versión v6.0.3 de Django MongoDB backend incluye las siguientes funcionalidades, mejoras y correcciones:

• Agrega soporte para ObjectId coincidencia en los patrones de URL. Para obtener más información, consulta Despachador de URL en la documentación de la API.

• Añade soporte para índices en los subcampos PolymorphicEmbeddedModelField y PolymorphicEmbeddedModelArrayField. Utiliza la misma sintaxis que los índices de subcampos EmbeddedModelField, como se muestra en el índice de subcampos del modelo incrustado sección de la guía Crear índices.

• Agrega soporte para restricciones únicas en los subcampos PolymorphicEmbeddedModelField y PolymorphicEmbeddedModelArrayField. Utiliza la misma sintaxis que las restricciones de unicidad de subcampo EmbeddedModelField, como se muestra en la sección Restricciones de campo incrustado de la guía Crear Modelos.

• Actualiza la operación str(queryset.query) para que genere MQL en lugar de SQL.

• Evita la creación de modelos que tengan campos cifrados en bases de datos no cifradas al generar un error cuando Queryable Encryption no está configurado.

• Instruye al comando makemigrations para que serialice las referencias de modelos incrustados como cadenas. Como resultado, no necesitas ajustar las referencias de modelo en las migraciones si los modelos se eliminan más tarde.

• Agrega un NotSupportedError para los métodos QuerySet.extra(where=...) y StringAgg(..., distinct=True), que anteriormente devolvían errores menos específicos.

• Deprecia el uso de unique=True, db_index=True, Meta.constraints, Meta.indexes y Meta.unique_together para definir índices y restricciones en campos de modelos embebidos. En cambio, use EmbeddedFieldIndex y EmbeddedFieldUniqueConstraint en el modelo de nivel superior. Para obtener más información sobre la nueva sintaxis, consulta el Índice de subcampos de modelo embebido y Restricciones de campos embebidos.

Versión 6.0.2

La versión v6.0.2 de Django MongoDB backend incluye las siguientes funcionalidades, mejoras y correcciones:

• Agrega soporte para los métodos QuerySet.intersection() y QuerySet.difference().

• Agrega compatibilidad con el parámetro nulls_distinct del constructor UniqueConstraint, lo que permite almacenar solo un documento que tenga un valor NULL. Para obtener más información, consulta Especificar restricciones únicas en la guía Crear modelos.

• Se añade la clase EmbeddedFieldIndex, que activa los índices en los subcampos de los valores de EmbeddedModelField y EmbeddedModelArrayField. Para obtener más información, consulta Índice de Subcampo de Modelo Incorporado en la guía Crear Índices.

• Añade la clase EmbeddedFieldUniqueConstraint, que habilita restricciones únicas en subcampos de los valores de EmbeddedModelField y EmbeddedModelArrayField. Para obtener más información, consulte Restricciones de campos incorporados en la guía Crear modelos.

• Corrige un error que causaba un mensaje de error al llamar Model.save() en modelos con campos cifrados.

Versión 6.0.1

La versión v6.0.1 de Django MongoDB backend incluye las siguientes funcionalidades, mejoras y correcciones:

• Agrega compatibilidad para Queryable Encryption. Para obtener más información, consulta el tutorial sobre Queryable Encryption.

• Agrega soporte para búsquedas espaciales. Para obtener más información, consulte Consultar valores geoespaciales en la guía Especificar una consulta.

• Evita que se ejecuten dos veces las comprobaciones del sistema Index.

• Agrega mensajes de excepción a las excepciones DatabaseError y IntegrityError.

• Corrige el comportamiento de QuerySet.defer() y QuerySet.only() para que los métodos proyecten los campos correctos.

• Elimina el uso de $facet de los pipelines de agregación, lo que mejora el rendimiento de las consultas.

Versión 6.0.0

Versión 5.2.4

La versión v5.2.4 de Django MongoDB backend incluye las siguientes funcionalidades, mejoras y correcciones:

• Mejora el rendimiento de las operaciones de unión, que utilizan la etapa de agregación de $lookup, al trasladar condiciones complejas de la etapa de $match a la de $lookup

Versión 5.2.3

La versión v5.2.3 de Django MongoDB backend incluye las siguientes funcionalidades, mejoras y correcciones:

• Evita que las consultas QuerySet.union() dupliquen la etapa $project del pipeline.

• Actualiza la clase Value para envolver los valores de string, diccionarios y tuplas con el operador $literal, a fin de evitar que MongoDB los interprete como expresiones. De manera similar, las consultas que actualizan los modelos ahora envuelven valores en el operador como $literal, por la misma razón.

• Simplifica las query $lookup utilizando localField y foreignField.

Versión 5.2.2

La versión v5.2.2 de Django MongoDB backend incluye las siguientes funcionalidades, mejoras y correcciones:

• Agrega los siguientes argumentos SearchIndex, que te permiten crear índices más complejos:

  • field_mappings

  • analyzer

  • search_analyzer

  Para obtener más información, consulta Índices de búsqueda en la guía de Índices.

• Corrige una excepción KeyError que ocurría al cargar modelos que contienen campos EmbeddedModel usando un conversor de bases de datos, si el campo no estaba presente en los datos.

• Garantiza que el argumento db_column se aplique a los campos EmbeddedModel.

• Corrige el tipo de índice de búsqueda de los valores EmbeddedModelField y PolymorphicEmbeddedModelField de embeddedDocuments a document.

• Corrige el error transaction.atomic() que se producía cuando no se inicializaba la conexión con la base de datos.

• Desaprueba el método django_mongodb_backend.utils.parse_uri(). Este método se eliminará en una versión futura.

Versión 5.2.1

La versión v5.2.1 de Django MongoDB backend incluye las siguientes funcionalidades, mejoras y correcciones:

• Agrega soporte para especificar la cadena de conexión en la clave DATABASES["HOST"] en lugar de usar el método django_mongodb_backend.utils.parse_uri(). Para obtener más información, consulte Configurar automáticamente la configuración de la base de datos en la guía Configure su conexión de base de datos.

• Instruye a las operaciones de migración que agregan o eliminan índices de búsqueda que esperen hasta que la operación se complete en el servidor, lo que previene conflictos al ejecutar múltiples operaciones de manera secuencial.

• Configura consultas simples que utilizan los siguientes operadores para usar $match en lugar de $expr, lo que les permite utilizar índices:

  • $eq

  • $in

  • $and

  • $or

  • $gt

  • $gte

  • $lt

  • $lte

Versión 5.2.0

Django MongoDB Backend v5.2.0 es la versión inicial de disponibilidad general (GA). Para obtener más información sobre las funcionalidades de GA, consulta la entrada de blog Backend de MongoDB para Django ahora disponible en general.

Versión 5.2.0 beta 3

Versión 5.2.0 beta 2

El Backend de Django MongoDB v5.2.0 la beta 2 incluye las siguientes funcionalidades, mejoras y correcciones:

• Añade soporte para consultas de búsqueda de MongoDB. Para obtener más información, consulta la guía sobre cómo ejecutar una MongoDB Search query.

• Añade soporte de subconsultas para los valores de EmbeddedModelArrayField. Para aprender más, consulta Query Embedded Model Arreglo Values en la guía Especificar una consulta.

• Agrega el parámetro options al método django_mongodb_backend.utils.parse_uri().

• Añade soporte para transacciones de base de datos. Para obtener más información, consulta la guía sobre Transacciones y Sesiones.

• Agrega los campos PolymorphicEmbeddedModelField y PolymorphicEmbeddedModelArrayField, que almacenan una instancia de modelo o una lista de instancias de modelo que pueden pertenecer a más de una clase de modelo. Para obtener más información, consulte Almacenar datos de modelos incrustados polimórficos en la guía Crear modelos.

• Agrega soporte para GeoDjango. Para obtener más información, consulte la guía Modelar Datos Geoespaciales.

• Actualiza QuerySet.explain() para devolver una string que pueda ser analizada como JSON.

• Corrige la generación de restricciones únicas para los campos IntegerField y PositiveBigIntegerField, que permitían incorrectamente valores duplicados mayores de 32 bits. Debes recrear las restricciones únicas existentes para usar $type: long en vez de int.

• Envía los siguientes campos a MongoDB como valores bson.int64.Int64, lo que corrige las restricciones únicas en valores inferiores a 32 bits:

  • IntegerField

  • BigIntegerField

  • PositiveIntegerField

  • PositiveBigIntegerField

  • DurationField

• Mejora el rendimiento QuerySet al remover el límite inferior en la fragmentación del lado del servidor.

• Mejora el rendimiento de las operaciones de combinación, que utilizan la etapa de agregación $lookup, al trasladar algunas condiciones simples de la etapa $match a la etapa $lookup.

Versión 5.2.0 beta 1

El Backend de Django MongoDB v5.2.0 la beta 1 incluye las siguientes funcionalidades, mejoras y correcciones:

• Añade el campo EmbeddedModelArrayField para almacenar una lista de instancias del modelo. Para obtener más información, consulta Almacenar datos de matriz de modelo integrado en la guía Crear modelos.

• Corrige un fallo que ocurría al cargar modelos que tienen un valor nulo ArrayField y un base_field utilizando un convertidor de base de datos.

Versión 5.2.0 beta 0

El Backend de Django MongoDB v5.2.0 la beta 0 incluye las siguientes funcionalidades, mejoras y correcciones:

• Agrega las clases SearchIndex y VectorSearchIndex, que le permiten crear índices de MongoDB Search y Vector Search. Para saber más, consulta Índices de búsqueda y Índices de búsqueda vectorial en la guía Crear índices.

• Utiliza el agrupamiento de conexiones de PyMongo por defecto.

• Agrega soporte para las búsquedas y transformaciones personalizadas de un campo en un EmbeddedModelField.

• Corrige los resultados de las consultas que utilizan el parámetro tzinfo de las funciones de base de datos Trunc.

• Agrega soporte para los métodos QuerySet.dates() y QuerySet.datetimes().

• Corrige la carga de QuerySet resultados para campos de modelos embebidos que usan conversores de bases de datos.

Versión 5.1.0 beta 4

El Backend de Django MongoDB v5.1.0 la beta 4 incluye las siguientes funcionalidades, mejoras y correcciones:

• Soluciona un fallo que se producía al cargar modelos que tienen un valor ArrayField nulo y donde el base_field utiliza un convertidor de base de datos.

• Mejora el rendimiento QuerySet al remover el límite inferior en la fragmentación del lado del servidor.

Versión 5.1.0 beta 3

El Backend de Django MongoDB v5.1.0 la beta 3 incluye las siguientes funcionalidades, mejoras y correcciones:

• Agrega soporte para consultas personalizadas de un campo y transformaciones en un EmbeddedModelField

• Corrige los resultados de las consultas que utilizan el parámetro tzinfo de las funciones de base de datos Trunc

• Añade soporte para los métodos QuerySet.dates() y QuerySet.datetimes()

• Corrige la carga de QuerySet resultados para campos de modelos embebidos que utilizan convertidores de la base de datos

Versión 5.1.0 beta 2

El Backend de Django MongoDB v5.1.0 la beta 2 incluye las siguientes funcionalidades, mejoras y correcciones:

• Agrega soporte para almacenamiento en caché de bases de datos. Este soporte se elimina posteriormente en la v5.1.4.

• Corrige la inicialización del campo QuerySet.raw_aggregate() cuando el orden de las claves del documento no coincide con el orden de los campos del modelo.

Versión 5.1.0 beta 1

El Backend de Django MongoDB v5.1.0 la beta 1 incluye las siguientes funcionalidades, mejoras y correcciones:

• Añade soporte para guardar formularios de modelos anidados o incrustados

• Soluciona las conexiones persistentes a la base de datos

• Agrega soporte para operaciones asincrónicas

• Agrega el parámetro db_name al método django_mongodb_backend.utils.parse_uri()

• Agrega un enrutador django_mongodb_backend.routers.MongoRouter, que garantiza que Django MongoDB backend no cree colecciones para modelos incrustados y que el comando dumpdata no incluya modelos incrustados

Versión 5.1.0 beta 0

Django MongoDB Backend v5.1.0 beta 0 es la versión previa inicial pública. Para aprender más sobre las funcionalidades de la vista previa pública, consulta la entrada de blog "Backend oficial de Django MongoDB ahora disponible en vista previa pública".