Esta página describe los cambios y las nuevas características introducidas en MongoDB 8.2.
MongoDB 8.2 es una versión menor, lo que significa que es compatible tanto con MongoDB Atlas como con implementaciones locales. MongoDB 8.2 introduce mejoras incrementales dentro del ciclo de lanzamiento de la versión principal. MongoDB 8.2 también incluye los cambios introducidos en MongoDB 8.1. Esta página describe los cambios introducidos en la versión menor y en MongoDB 8.2.
Para obtener más información sobre las diferencias entre las versiones principales y secundarias, consulte Control de versiones de MongoDB.
Importante
MongoDB 8.2 es la última versión menor. A partir de MongoDB 8.2, las versiones menores están disponibles para implementaciones on-premises (MongoDB Community y Enterprise) para casos de uso específicos. Para obtener más información, consulta MongoDB Versioning.
Para instalar la última versión de MongoDB compatible para uso on-premises, consulta las instrucciones de instalación.
Importante
mongosync no es compatible con MongoDB 8.2.
Versiones de parches
8.2.5 - Feb 10, 2026
SERVIDOR-118711 - No se puede crear el índice de serie temporal 2dsphere con un usuario que no sea del sistema
8.2.4 - Jan 27, 2026
Importante
MongoDB 8.2.4 contiene una solución para
Para obtener la información más reciente sobre las actualizaciones de seguridad de MongoDB, consulte Boletines de seguridad de MongoDB.
Problemas corregidos:
SERVIDOR-112952 - ajuste de perfil de verificación de autenticación del comando
SERVER-113685 - Error de segmentación para consulta en índice comodín compuesto
SERVIDOR-114126 - Reducir el uso de memoria y agregar nuevas barreras de seguridad al simplificador booleano
SERVIDOR-114695 - Actualizar el valor predeterminado para las conexiones pendientes
SERVER-114838 - El administrador de bloqueos es susceptible a un ataque DDOS adversarial
SERVIDOR-115296 - Redactar valores sin procesar de ResourceId de los mensajes de error
SERVIDOR-116206 - Mejor manejo de excepciones para compresores de mensajes
SERVIDOR-116210 - Ajusta el tamaño máximo del búfer para las solicitudes de ingreso
SERVIDOR-116211 - Límite de memoria asignada por los buffers de red
8.2.3 - 19 de diciembre de 2025
Importante
MongoDB 8.2.3 contiene una corrección para CVE-202514847-.
Para obtener la información más reciente sobre las actualizaciones de seguridad de MongoDB, consulte Boletines de seguridad de MongoDB.
Problemas corregidos:
SERVIDOR-:115508 Crea buffers de tamaño mínimo para mensajes sin comprimir
8.2.2 - 19 de noviembre de 2025
Problemas corregidos:
SERVIDOR-:103774 No permitir el uso de índices comodín compuestos como índices de clave de fragmento
SERVIDOR-:105047 Las consultas que utilizan
$ory$neen colecciones fragmentadas podrían incluir documentos huérfanos110423SERVIDOR-:
$grouppuede usar un escaneo distinto en un índice disperso, que excluye los resultados connullmissingvalores oSERVIDOR-:110916 Resuelve un problema de uso después de mover en
targetShardsAndAddMergeCursors()SERVER-112467: rastrea e informa la cantidad de conexiones proxy pendientes
SERVIDOR-:112520 Error al escribir en un índice geográfico al insertar un documento en un depósito de series temporales existente
8.2.1 - 3 de octubre de 2025
Problemas corregidos:
SERVIDOR-:94681 Mover el muestreo al hilo de mantenimiento del límite de registro de operaciones
106469SERVIDOR-: El inicio de mongocryptd falla en la última compilación, Windows.
SERVIDOR-:108565 Mejorar el manejo de escrituras de gran tamaño en colecciones de series de tiempo.
109626SERVIDOR-: Ajustar el comportamiento para emitir campos adicionales en flujos de cambio
SERVIDOR-:110250 Utilizar sesión existente al eliminar el identificador WT del derrame
WT-:15225 Se soluciona el problema de la tabla recién creada y la función drop() EBUSY
particionado
Parámetro de terminación de lecturas secundarias en limpieza huérfana
MongoDB 8.2 agrega el parámetro, que controla si las operaciones de lectura de terminateSecondaryReadsOnOrphanCleanup larga duración en nodos secundarios finalizan automáticamente antes de la eliminación de documentos huérfanos después de una migración de fragmentos.
Por defecto, este parámetro se establece en true. Si una operación de lectura en un nodo secundario comienza antes de que se confirme la migración del chunk, MongoDB termina automáticamente la operación antes de eliminar los documentos huérfanos. En versiones de MongoDB anteriores a 8.2, estas operaciones continúan ejecutándose después de la eliminación de documentos huérfanos y pueden omitir documentos silenciosamente sin devolver un error.
Para respaldar este nuevo comportamiento, el valor predeterminado para ahora orphanCleanupDelaySecs es 3600 900(anteriormente).
Cambios generales
El índice se crea durante la sincronización inicial
A partir de MongoDB,8.2 la creación de índices durante la sincronización inicial 10utiliza el % de la RAM disponible de forma predeterminada. Puede especificar un porcentaje diferente de memoria para MongoDB con el initialSyncIndexBuildMemoryPercentage parámetro.
De forma predeterminada, la cantidad de memoria disponible debe estar entre 200 MB y 16 GB, ambos inclusive. Utilice los siguientes parámetros para especificar diferentes umbrales mínimos y máximos de uso de memoria:
Estadísticas de consultas
A partir de MongoDB,8.2 la salida incluye las siguientes métricas $queryStats sobre tickets morosos:
metrics.delinquentAcquisitionsmetrics.totalAcquisitionDelinquencyMillismetrics.maxAcquisitionDelinquencyMillis
MongoDB considera un ticket de ejecución como atrasado cuando la adquisición toma demasiado tiempo.
Configuración del tamaño de caché de WiredTiger como porcentaje
A partir de MongoDB,8.2 puede configurar el tamaño de la caché interna de WiredTiger mediante una nueva opción porcentual. Además de las --wiredTigerCacheSizeGB storage.wiredTiger.engineConfig.cacheSizeGB opciones de y gigabytes, ahora puede especificar el tamaño de la --wiredTigerCacheSizePct storage.wiredTiger.engineConfig.cacheSizePct caché como un porcentaje de la memoria disponible con las opciones y.
Nuevo tipo de inconsistencia: Eliminación de rango, falta de índice de clave de fragmento
A partir de MongoDB,8.2 se implementa un nuevo tipo de RangeDeletionMissingShardKeyIndex inconsistencia. Este tipo indica que existe una colección fragmentada que no tiene un índice compatible con la clave de fragmento de la colección y que queda al menos una tarea de eliminación de rango por completar.
Nueva expresión de agregación
A partir de MongoDB,8.2 puede usar $currentDate con para devolver la hora actual en el aggregate() servidor.
Nuevo campo $currentOp
La $currentOp etapa de agregación ahora incluye el campo, que proporciona versionContext información sobre la versión de compatibilidad de funciones (FCV) de la operación.
Cambio de salida de serverStatus
serverStatus incluye los siguientes campos nuevos en su resultado:
Explicar la salida para las etapas de desbordamiento del disco
A partir de MongoDB,8.2 los resultados de Explain para las etapas que se vuelcan al disco ahora incluyen métricas estandarizadas con nombres de campo consistentes. Esta actualización proporciona una forma más unificada de rastrear el uso del disco en operaciones con uso intensivo de memoria.
Los nuevos campos incluyen:
Campo de modo de reparación en la salida de validación
A partir de MongoDB 8.2, el comandovalidatey el método auxiliardb.collection.validate()devuelven un nuevo camporepairModeque indica qué tipos de inconsistencias de datos intentó reparar el comando validate, si se detectaron.
Soporte para compresión rápida zstd
A partir de MongoDB,8.2 la storage.wiredTiger.engineConfig.zstdCompressionLevel configuración admite valores negativos para una compresión zstd rápida. Los valores negativos proporcionan velocidades de compresión y descompresión más rápidas, pero a costa de la tasa de compresión. El nuevo rango admitido es de -7 22a.
Lecturas espejeadas dirigidas
A partir de MongoDB 8.2, se pueden reflejar selectivamente las operaciones de lectura en servidores específicos que necesitan calentar sus cachés etiquetando los nodos para las lecturas espejeadas. A diferencia de las lecturas espejeadas generales, la duplicación de lectura dirigida permite dirigirse a nodos ocultos y reflejar desde nodos tanto primarios como secundarios.
Puedes configurar lecturas espejeadas dirigidas utilizando el campo targetedMirroring en el parámetro mirrorReads.
Límite de velocidad de establecimiento de conexión de entrada
A partir de MongoDB 8.2, puede habilitar la limitación de velocidad para las conexiones de entrada para preservar los recursos de la CPU durante la sobrecarga. Al habilitarla, puede ver cuándo la velocidad de las conexiones entrantes supera la velocidad de establecimiento de conexión especificada y configurar parámetros para especificar cómo su implementación de MongoDB gestiona el exceso de conexiones.
Puede configurar la limitación de frecuencia usando los siguientes campos nuevos:
Seguridad
Vista previa pública de consultas de prefijo, sufijo y subcadena de cifrado consultable
Advertencia
Las consultas de prefijo, sufijo y subcadena están en vista previa pública
Las consultas de prefijo, sufijo y subcadena de cifrado consultable están disponibles en la vista previa pública de MongoDB 8.2. No habilite estos tipos de consulta en producción. La función de vista previa pública será incompatible con la función GA, y deberá eliminar cualquier colección que las habilite.
MongoDB 8.2 permite habilitar consultas de prefijo, sufijo y subcadena en campos de cadena cifrados en colecciones con cifrado consultable habilitado. Para más información,consulte "Habilitar consultas de subcadena" y "Expresiones de agregación compatibles".
Para utilizar las consultas de prefijo, sufijo o subcadena de Vista previa pública con, debe descargar por separado la Biblioteca mongosh compartida de cifrado automático 8.2 o superior y luego especificar la ruta de la biblioteca a mongosh utilizando la opción --cryptSharedLibPath.
Problemas conocidos
Esta sección describe problemas conocidos en MongoDB 8.2 y su estado de resolución.
En versión | Problema | Estado |
|---|---|---|
8.2.4, 8.2.5 | SERVIDOR-:118428 Los cambios en To avoid this bug, skip these versions when you upgrade mongocryptd or
use the crypt_shared library. | Irresoluto. |
8.2.0 | SERVIDOR-:106469 Los You can avoid the .NET/C# Driver mongocryptd issue in the following ways:
| Estamos enfocando una solución para este problema en MongoDB 8.2.1. |
8.2.0 | SERVIDOR-:109626 820 Las versiones, y introducen regresiones en el rendimiento de los flujos de cambios. Las aplicaciones que dependen de flujos de cambios para el procesamiento de datos en tiempo real pueden experimentar una 15degradación del rendimiento de hasta un % en comparación con las versiones y.80 | Estamos enfocando una solución para este problema en MongoDB 8.2.1. |
8.2.0 | SERVIDOR-:110250 Los usuarios que ejecutan operaciones que consumen mucha memoria y requieren saturación de disco pueden experimentar fallos del servidor si el número de consultas saturadas | Estamos enfocando una solución para este problema en MongoDB 8.2.1. |
Parámetros del servidor
A partir de MongoDB 8.2, están disponibles los siguientes parámetros de servidor:
Cambios introducidos en MongoDB 8.1
La siguiente sección describe los cambios y las nuevas características introducidas en MongoDB 8.1.
Agregar comentarios a la configuración de la consulta
A partir de MongoDB 8.1 (y 8.0.4), puedes usar setQuerySettings para agregar comentarios a los ajustes de las queries. Por ejemplo, añade un comentario que indique por qué has añadido los ajustes de query.
Acumuladores de agregación
A partir de MongoDB 8.1, están disponibles los siguientes acumuladores de agregación:
Etapas de agregación
A partir de MongoDB 8.1, están disponibles las siguientes etapas de agregación:
Mejoras en el registro de auditoría
A partir de MongoDB 8.1, si una aplicación cliente se conecta a una instancia mongod o mongos mediante un balanceador de carga, las direcciones IP y los puertos del equipo cliente de origen y del balanceador de carga se incluyen en el registro de auditoría. Puede usar el registro para asociar un evento de auditoría con el equipo cliente de origen.
Para obtener más detalles, consulte Mensajes de auditoría de esquema OCSF y Mensajes de auditoría de esquema mongo.
connectionStatus UUID de conexión
A partir de MongoDB,8.1 puede acceder al UUID del cliente conectado actualmente a través connectionStatus.authInfo.UUID de.
Espacio en disco
A partir de MongoDB 8.1 (y 8.0.5), si el espacio en disco se está agotando, MongoDB fallará en las consultas que se desborden al disco.
Mejoras de $geoNear
A partir de MongoDB,8.1 algunas consultas que antes $geoNear fallaban con 2 2índices ocultos d o dsphere ahora se ejecutarán correctamente. En versiones anteriores, algunas $geoNear consultas solían fallar innecesariamente con un IndexNotFound error al incluir un índice oculto debido a una confusión sobre qué índice usar.
Precisión mejorada para la métrica de duración de la operación
A partir de MongoDB,8.1 la durationMillis métrica, reportada en los registros de consultas lentas, representa el tiempo dedicado a procesar la autorización y analizar el comando. Por lo tanto, durationMillis refleja con mayor precisión la duración total del comando.
Tipos de inconsistencia
A partir de MongoDB 8.1, están disponibles los siguientes tipos de inconsistencia:
$lookup Soporte para colecciones cifradas
A partir de MongoDB,8.1 puede hacer referencia a múltiples colecciones cifradas en una $lookup etapa.
Para obtener más información, consulta:
$merge Campos faltantes
A partir de MongoDB,8.1 si el $merge índice de soporte de la etapa de agregación no es disperso, los campos especificados para la opción on pueden faltar o contener un valor nulo.
Estadísticas de consultas
A partir de MongoDB,8.1 se recopilan y reportan estadísticas de consultas para los comandos y. Para más información,count consulte "Forma de distinct consulta del comando count" y "Forma de consulta del comando distinct".
Parámetros del servidor
A partir de MongoDB 8.1, están disponibles los siguientes parámetros de servidor:
AbortExpiredTransactionsSessionCheckoutTimeout(También disponible en 8.0.13)catalogCacheIndexMaxEntries
serverStatus Métricas
A partir de MongoDB 8.1 (y 8.0.4, 7.0.14 y 6.0.20), la secciónindexStatsde la salida del comandoserverStatusrastrea los índices en estado prepareUnique.
MongoDB 8.1 incorpora las siguientes métricas de estado del servidor:
maxTimestampEligibleForTruncateinchangeStreamPreImages.purgingJobmetrics.abortExpiredTransactions.successfulKills(También disponible en 8.0.13)metrics.abortExpiredTransactions.timedOutKills(También disponible en 8.0.13)
Métricas de consultas lentas para el desbordamiento del disco
A partir de MongoDB 8.1, los mensajes de registro de consultas lentas contienen nuevas métricas si la ejecución de la consulta escribe archivos temporales en el disco. Estas métricas están precedidas por la etapa de ejecución de query que causó que la query excediera el límite de memoria. Por ejemplo, sortSpills indica el número de veces que la etapa de clasificación de la ejecución de la query guardó archivos temporales en el disco.
Métrica | Descripción |
|---|---|
| Número de veces que la etapa de ejecución de la consulta correspondiente escribió archivos temporales en el disco |
| Tamaño, en bytes, de la memoria liberada al escribir archivos temporales en el disco |
| Tamaño, en bytes, del espacio en disco utilizado para archivos temporales |
| Número de registros escritos en archivos temporales del disco |
Para obtener más información sobre cómo escribir archivos temporales en el disco, consulta allowDiskUse().
Stable API
A partir de MongoDB,8.1 el renameCollection comando y el método de shell correspondiente,, estándb.collection.renameCollection() incluidos en la API estable1 V.
Compatibilidad con etapas de búsqueda en Explain Results
A partir de MongoDB,8.1 los resultados de explicación incluyen estadísticas de ejecución para las etapas,$search $searchMeta $vectorSearch y.
Para obtener más información, consulta:
Compatibilidad con comandos de índice de búsqueda en las vistas
A partir de MongoDB,8.1 puede createSearchIndexes updateSearchIndexejecutar,, dropSearchIndex y para crear, modificar, eliminar y enumerar índices de búsqueda de $listSearchIndexes Atlas e índices de búsqueda de vectores de Atlas en vistas estándar compatibles que contienen solo las siguientes etapas:
Puede ejecutar canalizaciones de agregación que $search contengan las etapas y en vistas que utilicen un índice de búsqueda. También puede ejecutar $searchMeta $vectorSearch canalizaciones de agregación que contengan la etapa en vistas que contengan un índice de búsqueda vectorial.
Validar salida de especificaciones del índice de órdenes
A partir de MongoDB,8.1 el comando incluye especificaciones validate validate.indexDetails de índice en el campo de salida.
Acción de validación para el manejo de documentos no válidos
A partir de MongoDB 8.1, puede establecer la opción validationAction de su esquema en errorAndLog, en la cual MongoDB rechaza cualquier inserción o actualización que viole los criterios de validación y registra el error en el archivo de registro mongod.
Para obtener más información, consulta Elige cómo gestionar documentos inválidos.
Procedimientos de actualización
Importante
Compatibilidad de características entre versiones
Para actualizar a MongoDB 8.2 desde una implementación 8.0, la implementación 8.0 debe tener featureCompatibilityVersion configurado en 8.0. Para verificar la versión:
db.adminCommand( { getParameter: 1, featureCompatibilityVersion: 1 } )
Para actualizar a MongoDB 8.2, se debe consultar las instrucciones de actualización específicas para la implementación de MongoDB:
Si necesita orientación 8.2 para actualizar a, los servicios profesionales de MongoDB ofrecen soporte para garantizar una transición fluida y sin interrupciones en su aplicación MongoDB. Para obtener más información,consulte Consultoría de MongoDB.
Descargar
Para descargar MongoDB 8.2, dirígete al Centro de descargas de MongoDB.
Consideraciones para la degradación
Solo se admiten degradaciones de una sola versión.
MongoDB solamente soporta degradaciones de una única versión. No se puede retroceder a una versión que esté varias versiones por detrás de la versión actual.
Por ejemplo, puedes degradar una implementación de la serie 8.2 a una de la serie 8.0. Sin embargo, no se brinda soporte a seguir degradando esa implementación de la serie 8.0 a una implementación de la serie 7.0.
Política de degradación
MongoDB Community Edition no brinda soporte a las degradaciones binarias.
No puedes degradar tu implementación FCV hacia o desde una versión de lanzamiento menor de MongoDB.
Si actualizas o degradas la compatibilidad de características entre versiones de tu implementación, no puedes degradar la versión binaria de tu implementación para empresas sin asistencia de soporte.