Notas de versión de MongoDB 8.3

8.3.1 - 4 de mayo de 2026

• SERVIDOR-124974 Asegurar la vida útil de la memoria durante $match análisis de empuje

• Todos los problemas de JIRA cerrados en 8.3.1

• 8.3.1 Registro de cambios

Acceso a los índices de los elementos de la matriz en $map, $filter y $reduce.

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

Estadísticas de FTDC

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

Salida de estado del servidor

serverStatus incluye los siguientes campos nuevos en su resultado:

• aggregate.withExtension subcampo en metrics.commands.aggregate, que registra los recuentos de éxitos y fracasos

• 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 service campo en la serverStatus salida.

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

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

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

Mejoras en la conversión de cadenas

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

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

Mejoras en la conversión de matrices

A partir de MongoDB,8.3 puede convertir cadenas que representan matrices usando o la $convert expresión $toArray abreviada.

También puede convertir entre binData y matrices de valores numéricos. Para obtener más información, consulte Convertir binData a matriz y Convertir una matriz de valores numéricos a binData.

Mejoras en la conversión de objetos

A partir de MongoDB,8.3 puede convertir cadenas que representan objetos usando o la $convert expresión $toObject abreviada.

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 podría requerir la reconstrucción de los índices geoespaciales si sus documentos contienen valores de coordenadas numéricas heredados que preceden a las coordenadas GeoJSON y los índices existentes dependen de ese comportamiento. Revise las consultas geoespaciales para confirmar que devuelven los resultados esperados.

Eliminar cambios de fragmento

A partir de MongoDB,8.3 el comando está obsoleto. Esta versión introduce cuatro nuevos comandos para reemplazar removeShard el removeShard y proporcionar un control más preciso sobre el proceso de drenaje y eliminación de fragmentos.

• startShardDraining

• stopShardDraining

• shardDrainingStatus

• commitShardRemoval

MongoDB proporciona cuatro comandos adicionales para pasar de un servidor de configuración integrado a un servidor de configuración dedicado.

• startTransitionToDedicatedConfigServer

• stopTransitionToDedicatedConfigServer

• getTransitionToDedicatedConfigServerStatus

• commitTransitionToDedicatedConfigServer

Parámetros de límite de conexión de preautenticación

MongoDB 8.3 agrega tres nuevos parámetros de servidor que limitan el consumo de recursos de las conexiones de preautenticación:

• capMemoryConsumptionForPreAuthBuffers

• messageSizeErrorRateSec

• preAuthMaximumMessageSizeBytes

Parámetro cachePressureQueryPeriodMilliseconds

MongoDB 8.3 agrega el cachePressureQueryPeriodMilliseconds parámetro que establece el intervalo de tiempo que MongoDB espera entre comprobaciones de presión de caché del motor de almacenamiento. Si el motor de almacenamiento está bajo presión de caché, MongoDB cancela la transacción más antigua. Para más detalles,cachePressureQueryPeriodMilliseconds consulte.

Parámetro diagnosticDataCollectionDirectorySizeMB

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

Parámetro overloadAwareServerSelectionEnabled

MongoDB 8.3 agrega el parámetro, que controla si los reintentos dirigidos a otros servidores del clúster evitan a los miembros que recientemente devolvieron un error overloadAwareServerSelectionEnabled etiquetado SystemOverloadedError como. Puede habilitar este parámetro para optar por la redirección con detección de sobrecarga.

ingressRequestRateLimiterApplicationExemptions Parameter

A partir de MongoDB,8.3 el ingressRequestRateLimiterApplicationExemptions parámetro permite especificar las aplicaciones que se eximirán de la limitación de la tasa de solicitudes de entrada. Para obtener más información,ingressRequestRateLimiterApplicationExemptions consulte.

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

MongoDB 8.3 agrega dos parámetros que permiten controlar el impacto que el Perfilador de base de datos tiene en el rendimiento de las consultas:

• internalQueryGlobalProfilingLockDeadlineMs

• internalProfilingMaxAbandonedWritesPerSecondPerDb

MongoDB 8.3 también agrega dos métricas relacionadas serverStatus:

• profiler.totalAbandonedWrites

• profiler.dbsPastThreshold

Parámetros de reintento

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

• defaultClientBaseBackoffMillis

• defaultClientMaxBackoffMillis

• defaultClientRetryAttempts

• shardRetryTokenBucketCapacity

• shardRetryTokenReturnRate

Código BSONObjectTooLarge para errores de Upsert

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

Validar actualizaciones de comandos

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

Nueva expresión $subtipo

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

Nuevas expresiones para la conversión JSON extendida

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

• $serializeEJSON - Convierte valores BSON al formato JSON extendido con envoltorios de tipo. Admite los formatos JSON extendido canónico y relajado.

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

Estas expresiones se pueden combinar con para analizar cadenas JSON, transformar valores JSON extendidos en valores BSON nativos y convertirlos de nuevo al formato $convert JSON.

Nueva expresión $createObjectId

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

Nuevas expresiones de hash

MongoDB 8.3 introduce dos nuevas expresiones de agregación para generar hashes a partir de cadenas UTF-8 o datos binarios:

• $hash - Genera un BinData valor hash a partir de una8 cadena UTF- o datos binarios utilizando MD,5 SHA-256 o XXH.64

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

Fechas de la época anterior

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

Generación de índices geoespaciales

MongoDB 8.3 continúa con el comportamiento introducido en MongoDB 8.2. Si un documento contiene campos de coordenadas numéricas GeoJSON y heredadas, la generación del índice geoespacial 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 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 tuberías de conversión

A partir de MongoDB,8.3 el servidor puede analizar todo el rango de números de coma flotante de doble precisión representables. Esto incluye números subnormales donde el dígito más significativo tiene ceros iniciales y el exponente tiene el menor valor 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 cadena que proporcione a chars está limitada a 4096 caracteres. Para obtener más detalles, consulte Limitaciones de $trim.

Funciones de ventana

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

sp.process() límite Opción

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

Búsqueda de texto que se desborda en el motor de consultas

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

• Si allowDiskUse es true, la etapa derrama los resultados intermedios al disco.

• Si allowDiskUse es false, la consulta falla con un error de límite de memoria excedido.

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

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

A partir de MongoDB,8.3 lasoperaciones DDL y solo se pueden ejecutar en applyOps un mongos para todos los clústeres fragmentados.

findShardsOnConfigTimeoutMS Parameter

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

config.csrs.indexes Eliminado

MongoDB 8.3 elimina el espacio de nombres config.csrs.indexes.

2dsphereIndexVersion

A partir de MongoDB,8.3 2dsphereIndexVersion se establece en la versión 4 de forma predeterminada.

Si necesita degradar el FCV a 8.3 cualquier 2dsphere valor inferior a, primero debe eliminar los 4 índices de la versión.

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

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

Conversión a fragmento de configuración incrustado

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

En versiones anteriores, para convertir un conjunto de réplicas en un clúster fragmentado con una partición de configuración integrada, era necesario migrar primero a un clúster fragmentado con un conjunto de réplicas de servidor de configuración dedicado.

Si reinicia un conjunto de réplicas con las opciones --replicaSetConfigShardMaintenanceMode y --configsvr, puede convertir el nodo principal directamente en un fragmento de configuración integrado.

Para obtener más información, consulte Convertir un conjunto de réplicas en un fragmento de configuración integrado.

refinarFormatoCollectionShardKey

A partir de MongoDB,8.3 refineCollectionShardKey para colecciones de series temporales solo acepta claves de fragmentación especificadas mediante los campos de metadatos lógicos y de tiempo de la colección. MongoDB ya no admite la especificación de claves mediante el formato de cubetas subyacente.

Restricciones en la 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 campos de tiempo

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

Campos para realizar un seguimiento del uso de memoria por parte de las consultas

A partir de MongoDB 8.3, puede utilizar los siguientes campos nuevos para realizar un seguimiento del uso de memoria de las consultas:

Ambos campos aparecen en los siguientes lugares:

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

• db.currentOp() salida

• Database profiler output

• Mensajes de registro

• Mensajes de registro de consultas lentas

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

• Explicar los resultados

• PlanCache.list() salida

• $planCacheStats salida

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

• metrics.numInterruptChecksPerSec

• metrics.overdueInterruptApproxMaxMillis

Campo de forma de consulta de Mongos

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

• find

• aggregate

• count

• distinct

Registros de consultas lentas en curso

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

Clústeres fragmentados

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

Modo SCRAM-SHA-1 y FIPS

A partir de MongoDB,8.3 no se puede especificar SCRAM-SHA-1 para mientras también authenticationMechanisms se especifica mongod --tlsFIPSMode mongos --tlsFIPSModeo.

Si intenta especificar SCRAM-SHA-1 para authenticationMechanisms y al mismo tiempo especifica --tlsFIPSMode, el servidor genera 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 características que no son compatibles con versiones anteriores. Para volver a una versión anterior desde 8.3, es necesario eliminar los datos que utilizan estas características.

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