Importante
MongoDB 8.3 es la última versión menor. A partir de MongoDB 8.2, las versiones menores están disponibles para implementaciones on-premises (Community y EA) para casos de uso específicos. Para obtener más información, consulta 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 antiguas de MongoDB.
Indexes
Validación más estricta del índice comodín
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 siguen funcionando, pero no se puede crear nuevos índices que no cumplan con estos requisitos.
Para obtener detalles completos sobre las reglas de validación, consulte Restricciones de índices comodín.
Cambios generales
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.
Si creas una vista o una regla de validación de colección que utiliza la nueva funcionalidad del índice de elementos de arreglo, debes actualizar o remover la vista o la regla antes de revertir desde MongoDB 8.3 a una versión anterior.
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.
Características incompatibles con versiones anteriores
Las siguientes secciones ofrecen información sobre cómo remover funcionalidades incompatibles con versiones anteriores de su implementación. Si está degradando de MongoDB 8.3 a una versión anterior, revise las siguientes secciones para garantizar que su implementación se ejecute correctamente después de la degradación.
Expresiones en Vistas
Si creaste vistas que utilizan expresiones introducidas en MongoDB 8.3, esas vistas podrían dejar de funcionar después de que reduzcas la versión a una que no admita esas expresiones.
Si necesitas realizar un downgrade desde 8.3, primero debes actualizar o descartar cualquier vista que dependa de expresiones no admitidas en la versión de destino.
Parámetros y Variables en Vistas y Validadores
Si creas vistas o validadores de colección que utilicen parámetros o variables introducidos en MongoDB 8.3, estos objetos podrían fallar en la validación o evaluación tras el retroceso de versión.
Si necesitas cambiar a una versión anterior de 8.3, primero debes actualizar o remover cualquier vista o validador que haga referencia a parámetros o variables no compatibles con la versión objetivo.
Colecciones validadas
MongoDB 8.3 puede marcar colecciones como validadas utilizando nuevas semánticas de validación que no son compatibles con versiones anteriores a la 8.3. Si se intenta realizar una degradación mientras existan colecciones validadas, la degradación falla.
Si necesita cambiar a una versión anterior de 8.3, primero debe cambiar las colecciones validadas a un nivel de validación admitido en la versión de destino o descartar esas colecciones.
$facet Código de Error de Límite de Memoria
A partir de MongoDB 8.3, cuando una etapa $facet construye un document que supera el límite de 100 megabytes, MongoDB devuelve el error ExceededMemoryLimit.
En versiones anteriores, las etapas que exceden el límite de memoria devuelven el código de error 4031700. Si tienes aplicaciones, controladores o herramientas que verifiquen explícitamente 4031700, puedes ajustar tu código para reconocer ExceededMemoryLimit en su lugar.
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, donde el dígito más significativo tiene ceros a la izquierda y el exponente tiene el valor más bajo posible. En versiones anteriores de MongoDB, el servidor devuelve un error cuando intentas analizar estos números.
Para más detalles, consulte Números subnormales.
Configuración de la ventana de balanceador
Cuando cambie de MongoDB 8.3 a una versión anterior, la configuración activeBalancerWindowDOW no estará disponible. En reducción de versión, el equilibrador utiliza por defecto la configuración activeWindow.
No se requieren pasos manuales de degradación, pero cualquier configuración personalizada de día de la semana (DOW) realizada en 8.3 no se aplica después de la degradación.