Notas de versión de MongoDB 8.3

8.3.3 - Próximamente

Problemas corregidos:

• SERVIDOR-115250 Pausar JWKSetRefreshJob durante el tiempo de inactividad

• SERVER-121822 Las colecciones agrupadas no filtran correctamente los resultados con $lt on _id

• SERVER-125887 Agregar soporte para archivos PEM cifrados para la salida gRPC

• SERVER- La126049 comprobación del límite de montón por ámbito de MozJS utiliza un contador GC global del proceso.

• WT-16780 Contexto de error insuficiente en WT_PANIC fallos de punto de control en __wt_block_checkpoint_resolve

• Todos los problemas de JIRA cerrados en 8.3.3

• 8.3.3 Registro de cambios

8.3.2 - 12 de mayo de 2026

Problemas corregidos:

• SERVIDOR-126021 Comportamiento indefinido al insertar datos con nombres de campo duplicados en colecciones de series temporales

• Todos los problemas de JIRA cerrados en 8.3.2

• 8.3.2 Registro de cambios

8.3.1 - 4 de mayo de 2026

Problemas corregidos:

• SERVER-121610 Asegúrate de que las llamadas almacenadas en caché de emit() no realicen ninguna operación

• SERVIDOR-121895 Mejorar la restricción de los errores de validación

• SERVER-124974 Garantizar la vida útil de la memoria durante el análisis de inmersión $match

• Todos los problemas de JIRA cerrados en 8.3.1

• 8.3.1 Registro de cambios

8.3.0 - 4 de mayo de 2026

Acceso a los índices de elementos de arreglos en $map, $filter y $reduce

MongoDB 8.3 mejora el acceso a los índices de elementos de arreglos en las expresiones de agregación de $map, $filter y $reduce. Puedes usar el nuevo campo arrayIndexAs para establecer una variable que almacene el índice de un elemento de un arreglo. También puedes utilizar la nueva variable del sistema de agregación $$IDX para acceder al índice del elemento actual del arreglo si omites arrayIndexAs.

Estadísticas FTDC

A partir de MongoDB 8.3, Full Time Diagnostic Data Capture (FTDC) recopila connPoolStats métricas para mongod procesos.

Salida de serverStatus

serverStatus incluye los siguientes campos nuevos en su resultado:

• aggregate.withExtension subcampo en metrics.commands.aggregate, seguimiento del recuento de éxitos y fallos

• shardingStatistics.databaseCriticalSectionStatistics

• shardingStatistics.collectionCriticalSectionStatistics

• shardingStatistics.databaseVersionUpdateCounters

• metrics.ttl.deletedKeys

• metrics.ttl.durationMicros

• metrics.ttl.examinedDocuments

• metrics.ttl.examinedKeys

• metrics.extension

• metrics.extension.totalAggStageExecMicros

• metrics.extension.apiCallSuccesses

• metrics.extension.apiCallFailures

• metrics.extension.vectorSearch

• metrics.extension.vectorSearch.legacyVectorSearchUsed

• metrics.extension.vectorSearch.extensionVectorSearchUsed

• metrics.extension.vectorSearch.onViewKickbackRetries

• metrics.extension.vectorSearch.inSubpipelineKickbackRetries

• metrics.repl.network.oplogFetcherLagSeconds

• metrics.repl.network.oplogGetMoresProcessed

• queues.execution.admissions

• queues.execution.backgroundTasksDeprioritization

• queues.execution.deprioritizationGate

• queues.execution.heuristicDeprioritization

• queues.execution.heuristicDeprioritizationThreshold

• queues.execution.totalDeprioritizations

• queues.execution.usesPrioritization

• queues.execution.usesThroughputProbing

• queues.execution.nonDeprioritizable

• queues.execution.deprioritizable

• queues.execution.read.normalPriority.totalDelinquentAcquisitions

• queues.execution.read.normalPriority.totalAcquisitionDelinquencyMillis

• queues.execution.read.normalPriority.maxAcquisitionDelinquencyMillis

• queues.execution.read.lowPriority

MongoDB 8.3 elimina el campo service en la salida serverStatus.

A partir de MongoDB 8.3, puedes excluir todos los campos opcionales de la salida de serverStatus especificando none: 1. Después de excluir todos los campos opcionales, puede especificar los campos que desea incluir.

Para obtener más detalles, consulta Excluir todos los campos opcionales.

También puedes especificar opcionalmente lockContentionMetrics: 1 en el comando serverStatus para incluir lockContentionMetrics en la salida.

Mejoras en la conversión de string

A partir de MongoDB 8.3, $toString puede convertir tipos BSON adicionales a cadenas, incluidos objetos, arreglos, expresiones regulares, MaxKeys, MinKeys y marcas de tiempo. Para más detalles, consulta $toString.

MongoDB 8.3 introduce el argumento opcional base para $convert para convertir entre valores de string y numéricos utilizando las bases 2, 8, 10 y 16. Para más detalles, consulte $convert.

Mejoras en la Conversión de Arreglos

Desde MongoDB 8.3, puedes convertir cadenas que representan arrays utilizando $convert o la expresión abreviada $toArray.

También puedes convertir entre binData y arreglos de valores numéricos. Para más detalles, consulte Convertir binData a arreglo y Convertir un arreglo de valores numéricos en binData.

Mejoras en la conversión de objetos

A partir de MongoDB 8.3, puedes convertir cadenas que representen objetos utilizando $convert o la expresión abreviada $toObject.

Generación de índices geoespaciales

A partir de MongoDB 8.3, si un documento contiene tanto GeoJSON como campos legados de coordenadas numéricas, la generación de índices geoespaciales prioriza las coordenadas GeoJSON.

Si tus documentos contienen valores de coordenadas numéricas heredadas que preceden a las coordenadas GeoJSON y los índices existentes dependen de ese comportamiento, es posible que debas reconstruir tus índices geoespaciales.

Este cambio puede requerir que reconstruyas los índices geoespaciales si tus documentos contienen valores de coordenadas numéricas anteriores que preceden a las coordenadas GeoJSON y los índices existentes dependen de ese comportamiento. Revisa las consultas geoespaciales para confirmar que devuelvan los resultados previstos.

Remover modificaciones de partición

A partir de MongoDB 8.3, el comando removeShard se ha desaprobado. Esta versión introduce cuatro nuevos comandos para reemplazar removeShard y proporcionar un control granular sobre el proceso de drenaje y eliminación de particiones.

• startShardDraining

• stopShardDraining

• shardDrainingStatus

• commitShardRemoval

MongoDB proporciona cuatro comandos adicionales para la transición de un servidor de configuración incrustado a un servidor de configuración dedicado.

• startTransitionToDedicatedConfigServer

• stopTransitionToDedicatedConfigServer

• getTransitionToDedicatedConfigServerStatus

• commitTransitionToDedicatedConfigServer

Parámetros del límite de conexiones PreAuth

MongoDB 8.3 añade tres nuevos parámetros de servidor que limitan el consumo de recursos de las conexiones previas a la autenticación:

• capMemoryConsumptionForPreAuthBuffers

• messageSizeErrorRateSec

• preAuthMaximumMessageSizeBytes

Parámetro cachePressureQueryPeriodMilliseconds

MongoDB 8.3 añade el parámetro cachePressureQueryPeriodMilliseconds, que establece el intervalo de tiempo que MongoDB espera entre las comprobaciones de presión de caché del motor de almacenamiento. Si el motor de almacenamiento está bajo presión de caché, MongoDB aborta la transacción más antigua. Para obtener detalles, consulta cachePressureQueryPeriodMilliseconds.

Parámetro diagnosticDataCollectionDirectorySizeMB

MongoDB 8.3 aumenta el valor por defecto de diagnosticDataCollectionDirectorySizeMB de 200 a 500 MiB.

Parámetro overloadAwareServerSelectionEnabled

MongoDB 8.3 añade el parámetro overloadAwareServerSelectionEnabled, que controla si los reintentos que se dirigen a otros servidores del clúster evitan a los nodos que recientemente devolvieron un error etiquetado como SystemOverloadedError. Puede activar este parámetro para optar por la redirección consciente de la sobrecarga.

ingressRequestRateLimiterApplicationExemptions Parameter

A partir de MongoDB 8.3, el parámetro ingressRequestRateLimiterApplicationExemptions te permite especificar aplicaciones a eximir de la limitación de la tasa de solicitudes de entrada. Para más detalles, consulta ingressRequestRateLimiterApplicationExemptions.

Parámetros y métricas del perfilador de base de datos

MongoDB 8.3 añade dos parámetros que te permiten controlar el impacto que el perfilador de base de datos tiene en el rendimiento de las queries:

• internalQueryGlobalProfilingLockDeadlineMs

• internalProfilingMaxAbandonedWritesPerSecondPerDb

MongoDB 8.3 también añade dos métricas relacionadas serverStatus:

• profiler.totalAbandonedWrites

• profiler.dbsPastThreshold

Parámetros de reintento

MongoDB 8.3 añade parámetros para configurar cómo los clientes internos del lado del servidor (entre mongos y mongod) retroceden al reintentar operaciones que fallan debido a sobrecarga.

• defaultClientBaseBackoffMillis

• defaultClientMaxBackoffMillis

• defaultClientRetryAttempts

• shardRetryTokenBucketCapacity

• shardRetryTokenReturnRate

Código BSONObjectTooLarge para errores de inserción

A partir de la 8.3, las operaciones de inserción que generan un objeto BSON demasiado grande devuelven el código de error 10334 BSONObjectTooLarge. En versiones anteriores, las operaciones upsert que producen un objeto BSON demasiado grande devuelven los códigos de error 17419 o 17420.

validate Command Updates

A partir de 8.3, MongoDB ya no habilita automáticamente el campo checkBSONConformance en el método db.collection.validate() cuando full es true. Además, el método db.collection.validate() ahora verifica que una colección no tenga ningún document que supere los 16 MB.

Nueva Expresión $subtype

MongoDB 8.3 introduce una nueva $subtype expresión para extraer el subtipo de los objetos de tipo binary de los datos.

Nuevas expresiones para conversión JSON extendida

MongoDB 8.3 introduce nuevas expresiones de agregación para la conversión entre BSON y el formato Extended JSON (EJSON):

• $serializeEJSON - Convierte valores BSON al formato Extended JSON con contenedores de tipo. Admite tanto los formatos canónicos como los formatos extendidos relajados de JSON.

• $deserializeEJSON - Convierte el formato JSON extendido de nuevo a valores BSON nativos.

Estas expresiones pueden combinarse con $convert para analizar cadenas JSON, transformar valores Extended JSON en valores BSON nativos y volver a convertirlos a formato JSON.

Nueva expresión $createObjectId

A partir de MongoDB 8.3, puedes usar $createObjectId para generar nuevos ObjectId() valores aleatorios en pipelines y actualizaciones basadas en expresiones.

Nuevas expresiones de hash

MongoDB 8.3 introduce dos nuevas expresiones de agregación para generar huellas desde cadenas UTF-8 o datos binary:

• $hash – Genera un valor hash de BinData a partir de una cadena UTF-8 o datos binary utilizando MD5, SHA-256 o XXH64.

• $hexHash - Genera un hash de string hexadecimal en mayúsculas a partir de una string UTF-8 o datos binary utilizando MD5, SHA-256 o XXH64.

New $meta Keyword

MongoDB 8.3 introduce una nueva "searchRootDocumentId" palabra clave para la expresión. Puede usar esta palabra clave para devolver $meta el _id valor del documento raíz para los documentos incrustados en el conjunto $search de resultados. Para obtener más información, consulte searchRootDocumentId.

Fechas anteriores a la Época

A partir de MongoDB 8.3, si unit no es "millisecond" en $dateAdd o $dateSubtract y la fecha de input es anterior a ISODate("1970-01-01T00:00:00Z"), el resultado será un segundo mayor que en versiones anteriores de MongoDB. Esto también afecta los resultados de agregaciones que realizan cálculos basados en el tiempo como $setWindowFields y $densify.

Generación de índices geoespaciales

MongoDB 8.3 continua el comportamiento introducido en MongoDB 8.2. Si un document contiene tanto GeoJSON como campos de coordenadas numéricas heredadas, la generación del índice geoespacial da prioridad a las coordenadas GeoJSON.

Si tus documentos contienen valores de coordenadas numéricas heredadas que preceden a las coordenadas GeoJSON y los índices existentes dependen de ese comportamiento, es posible que debas reconstruir tus índices geoespaciales.

Este cambio podría requerir que vuelvas a crear índices geoespaciales si tus documentos contienen valores de coordenadas numéricas heredadas que preceden a las coordenadas GeoJSON y los índices existentes dependen de ese comportamiento. Revisar las consultas geoespaciales para confirmar que devuelvan resultados esperados.

Números subnormales en las $convert pipeline

A partir de MongoDB 8.3, el servidor puede analizar todo el rango de números representables de punto flotante de double precisión. Esto incluye números subnormales en los que el dígito más significativo tiene ceros a la izquierda y el exponente el valor mínimo posible.

Para más detalles, consulte Números subnormales.

Límite de longitud de caracteres para $trim, $ltrim y $rtrim

A partir de MongoDB 8.3, la longitud de la string que proporcionas a chars está limitada a 4096 caracteres. Para más detalles, ver $trim Limitaciones.

Funciones de ventana

A partir de MongoDB 8.3, puede utilizar $mergeObjects en las operaciones de $setWindowFields.

sp.process() limit Option

A partir de MongoDB 8.3, sp.process() admite el parámetro de input options.limit. Después de que sp.process() devuelva limit document a su terminal, la sesión terminará.

Derrame de la búsqueda de texto en el query de motor

A partir de MongoDB 8.3, el motor de query limita el uso de memoria de la etapa TextOr a 100 megabytes. La etapa TextOr procesa $text queries que leen los metadatos de la puntuación del text. Por ejemplo, TextOr procesa queries que ordenan los resultados por puntuación de texts. Si la etapa TextOr supera este límite:

• Si allowDiskUse es true, la etapa vierte los resultados intermedios en disco.

• Si allowDiskUse es false, la query falla con un error por superación del límite de memoria.

En versiones anteriores, la etapa TextOr no tenía límite de memoria y consumía RAM sin restricciones, lo que corría el riesgo de errores de falta de memoria (OOM).

Límite de longitud de caracteres para $trim, $ltrim y $rtrim

A partir de MongoDB 8.3, la longitud de la string que proporcionas a chars está limitada a 4096 caracteres. Para más detalles, ver $trim Limitaciones.

Las operaciones DDL para clústeres fragmentados solo pueden ejecutarse en mongos

A partir de MongoDB 8.3, solo puedes ejecutar operaciones DDL y applyOps en un mongos para todos los clústeres fragmentados. Estas operaciones pueden estar temporalmente no disponibles durante la transición de un set de réplicas a un clúster.

findShardsOnConfigTimeoutMS Parameter

MongoDB 8.3 añade el parámetro findShardsOnConfigTimeoutMS que establece el tiempo de espera en milisegundos para las operaciones find en el namespace config.shards. Para obtener más detalles, consulte findShardsOnConfigTimeoutMS.

config.csrs.índices Eliminado

MongoDB 8.3 elimina el el config.csrs.indexes namespace.

2dsphereIndexVersion

A partir de MongoDB 8.3, 2dsphereIndexVersion está configurado en la versión 4 por defecto.

Si necesitas degradar la compatibilidad de características entre versiones a cualquier valor por debajo del 8.3, primero debes descartar los 2dsphere índices de la versión 4.

Estadísticas de consultas de particiones para consultas originadas en mongos

A partir de MongoDB 8.3, los servidores de fragmentos incluyen las consultas que se originan en mongos en las estadísticas de consultas cuando queryStats está activado. Anteriormente, la mayoría de las consultas reenviadas desde mongos a particiones no aparecían en las estadísticas de consultas a nivel de partición, lo que reducía la exhaustividad de los diagnósticos a nivel de partición.

Conversión a clústeres particionados

A partir de MongoDB 8.3, los conjuntos de réplicas que anteriormente eran clusters fragmentados no se pueden volver a convertir en conjuntos de réplicas.

La conversión de un clúster fragmentado en un conjunto de réplicas preserva los metadatos de particionado de su implementación anterior, incluido un document de identidad de partición, lo que impide que vuelva a convertirse en un clúster fragmentado. Si intentas una reconversión autogestionada a un clúster particionado, MongoDB devolverá un error.

Para convertir estos sets de réplicas en clústeres fragmentados, contacta con el soporte técnico.

Conversión a partición de configuración incrustada

MongoDB 8.3 introduce la opción mongod --replicaSetConfigShardMaintenanceMode.

En versiones anteriores, convertir un set de réplicas en un clúster con una partición de configuración embebida requería migrar primero a un clúster con un set de réplicas de servidor de configuración dedicado.

Si reinicias un conjunto de réplicas con las opciones --replicaSetConfigShardMaintenanceMode y --configsvr, puedes convertir directamente el nodo primario en una partición de configuración embebida.

Para más información, consulta Convertir un conjunto de réplicas en una partición de configuración empotrada.

Formato de refineCollectionShardKey

A partir de MongoDB 8.3, refineCollectionShardKey para las colecciones de series temporales solo acepta claves de partición especificadas usando los campos lógicos de metadatos y tiempo de la colección. MongoDB ya no admite la selección de llaves utilizando el formato subyacente de buckets.

Restricciones de nomenclatura de índices

A partir de MongoDB 8.3, crear un índice con el nombre de "_id_" o especificar una sugerencia de "_id_" en colecciones de series temporales genera un error.

Restricciones de nomenclatura de timeField

A partir de MongoDB 8.3, no puedes crear un timeField que comience con un carácter $.

Campos para rastrear el uso de memoria por queries

A partir de MongoDB 8.3, puedes utilizar los siguientes campos nuevos para rastrear el uso de memoria de las queries:

Ambos campos aparecen en los siguientes lugares:

• Output de $currentOp (etapa de agregación)

• db.currentOp() salida

• Database profiler output

• Mensajes de registro

• Mensajes del registro de consultas lentas

El campo peakTrackedMemBytes también aparece en los siguientes lugares:

• Explique los resultados

• PlanCache.list() salida

• $planCacheStats salida

A partir de 8.3, utiliza las siguientes nuevas métricas en $queryStats para medir el comportamiento de checkForInterrupt:

• metrics.numInterruptChecksPerSec

• metrics.overdueInterruptApproxMaxMillis

Campo de la forma del query Mongos

A partir de MongoDB 8.3, las entradas del registro de consultas lentas tienen un campo originalQueryShapeHash opcional que contiene la forma del query de las siguientes operaciones que se originan en mongos :

• find

• aggregate

• count

• distinct

Registros de consultas en progreso lentas

MongoDB 8.3 introduce entradas para el registro de un query en curso que es lento. Los mensajes de registro sobre consultas en curso lentas contienen menos información que los registros estándar de consultas lentas. MongoDB registra las consultas como máximo una vez si la duración de la consulta supera slowOpInProgressThreshold. Puedes establecer el umbral con db.setProfilingLevel() o con la nueva opción de línea de comandos mongod --defaultSlowInProgMS.

Clústeres fragmentados

A partir de MongoDB 8.3, si ejecutas explain() en una base de datos que no existe en un clúster fragmentado, la etapa de ejecución llega hasta el final de la transmisión y la operación no crea la base de datos. Para obtener más información sobre las estadísticas de ejecución de fin de flujo, consulta explain.executionStats.executionStages.isEOF.

SCRAM-SHA-1 y modo FIPS

A partir de MongoDB 8.3, no se puede especificar SCRAM-SHA-1 para authenticationMechanisms y a la vez especificar mongod --tlsFIPSMode o mongos --tlsFIPSMode.

Si intentas especificar SCRAM-SHA-1 para authenticationMechanisms mientras también especificas --tlsFIPSMode, el servidor arroja un error y registra un mensaje similar al siguiente:

SCRAM-SHA-1 is not allowed in FIPS mode.

Solo se admiten degradaciones de una sola versión.

MongoDB solo admite degradaciones de una única versión a lo largo de versiones adyacentes. No puedes cambiar a una versión que esté varias versiones por detrás de tu versión actual.

• Para cualquier versión, mayor o menor, puedes actualizar o degradar a sus vecinos adyacentes. Por ejemplo, puedes degradar desde 8.3 hasta 8.2 o actualizar desde 7.0 hasta 8.0.

• Para todas las versiones, tanto mayores como menores, puedes degradar a la versión mayor inmediatamente anterior. Por ejemplo, desde 8.3 hasta 8.0.

• Para cualquier versión menor, puedes actualizar a la siguiente versión inmediatamente. Por ejemplo, desde 8.2 hasta 8.3.

Características incompatibles con versiones anteriores

MongoDB 8.3 incluye funcionalidades que no son compatibles con versiones anteriores. La degradación de la versión 8.3 a una versión anterior requiere que remueva los datos que utilizan estas funcionalidades.

Para obtener más información, consulte Características incompatibles con versiones anteriores.