Importante
MongoDB 8.3 es la última versión menor. A partir de MongoDB 8.2, las versiones menores están disponibles para implementaciones locales (Community y EA) para casos de uso específicos. Para obtener más información, consulte Versionado de MongoDB.
Para instalar la última versión de MongoDB compatible para uso on-premises, consulta las instrucciones de instalación.
Esta página describe los cambios introducidos en MongoDB 8.3 que pueden afectar la compatibilidad con versiones anteriores de MongoDB.
Indexes
Validación de índice comodín más estricta
A partir de MongoDB 8.3 (y 8.2.4, 8.0.18, 7.0.29), se aplican reglas de validación más estrictas a wildcardProjection especificaciones en índices comodín compuestos. Los índices existentes que no cumplen con los nuevos requisitos de validación seguirán funcionando, pero no se pueden crear nuevos índices que no cumplan con estos requisitos.
Para obtener información completa sobre las reglas de validación, consulte Restricciones del índice de comodines.
Cambios generales
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.
Si crea una regla de validación de vista o colección que utilice la nueva función de índice de elementos de matriz, debe actualizar o eliminar la vista o regla antes de degradar de MongoDB 8.3 a una versión anterior.
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.
Características incompatibles con versiones anteriores
Las siguientes secciones proporcionan información para eliminar funciones incompatibles con versiones anteriores de su implementación. Si está migrando de MongoDB 8.3 a una versión anterior, revise las siguientes secciones para asegurarse de que su implementación se ejecute correctamente después de la migración.
Expresiones en puntos de vista
Si creó vistas que utilizan expresiones introducidas en MongoDB 8.3, es posible que esas vistas dejen de funcionar después de que vuelva a una versión que no admita esas expresiones.
Si necesita degradar la versión 8.3, primero debe actualizar o eliminar cualquier vista que dependa de expresiones no compatibles con la versión de destino.
Parámetros y variables en vistas y validadores
Si creó vistas o validadores de colecciones que utilizan parámetros o variables introducidos en MongoDB 8.3, es posible que esos objetos no fallen en la validación o evaluación después de realizar una degradación.
Si necesita degradar desde 8.3, primero debe actualizar o eliminar cualquier vista o validador que haga referencia a parámetros o variables no compatibles con la versión de destino.
Colecciones validadas
MongoDB 8.3 puede marcar las colecciones como validadas utilizando una nueva semántica de validación que no es compatible con versiones anteriores a 8.3. Si intenta degradar la versión mientras existen colecciones validadas, la degradación fallará.
Si necesita degradar la versión 8.3, primero debe cambiar las colecciones validadas a un nivel de validación compatible con la versión de destino o eliminar esas colecciones.
Código de error de límite de memoria de $facet
A partir de MongoDB,8.3 cuando una etapa construye un documento más grande que $facet el 100 límite de megabytes, MongoDB devuelve el ExceededMemoryLimit error.
En versiones anteriores, las etapas que superan el límite de memoria devuelven el código de 4031700 error. Si tiene aplicaciones, controladores o herramientas que comprueban 4031700 explícitamente, puede ajustar su código para que reconozca en ExceededMemoryLimit su lugar.
Números subnormales en tuberías de conversión
A partir 8.3 de MongoDB, 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. En versiones anteriores de MongoDB, el servidor devuelve un error al intentar analizar estos números.
Para más detalles, consulte Números subnormales.
Configuración de la ventana del balanceador
Al degradar de MongoDB 8.3 a una versión anterior, la configuración activeBalancerWindowDOW no está disponible. Al degradar, el balanceador utiliza por defecto la configuración activeWindow.
No se requieren pasos de degradación manual, pero cualquier configuración personalizada de día de la semana (DOW) realizada en 8.3 no se aplicará después de la degradación.