Esta página describe los cambios introducidos en MongoDB 9.0 que pueden afectar la compatibilidad con versiones antiguas de MongoDB.
Obsolescencias
Obsoleto | Descripción |
|---|---|
| A partir de MongoDB 9.0, los tipos de query |
| No se pueden anular los lÃmites internos en las queries de subcadenas en campos cifrados en MongoDB 9.0. |
Agregación
Nombres de campos vacÃos en $group
A partir de MongoDB 9.0, la etapa $group devuelve un error si una expresión de acumulador tiene un nombre de campo vacÃo. Para obtener más información, consulte Restricción de $group de nombre de campo vacÃo.
allowPartialResults en el agregado $queryStats Clave
A partir de MongoDB 9.0, la clave $queryStats para los comandos aggregate incluye la opción allowPartialResults cuando la opción se establece explÃcitamente. Las estadÃsticas de query pueden luego distinguir entre solicitudes donde se omite allowPartialResults, explÃcitamente true o explÃcitamente false.
La adición cambia la serialización de key y keyHash para las consultas de aggregate que establecen allowPartialResults. El queryShapeHash no ha cambiado. Los consumidores posteriores que coincidan con keyHash podrÃan observar valores diferentes para estas consultas.
Para obtener más información, consulte la forma del query del comando aggregate.
Cambios generales
Las query fallan cuando un campo con Ãndice se convierte en multiclave
A partir de MongoDB 9.0, si un campo de Ãndice se convierte en un campo multiclave mientras se ejecuta una query que hace referencia al campo, la query podrÃa fallar con un QueryKilledError. Un campo indexado se convierte en multiclave cuando inserta o actualiza un documento de modo que el campo contenga un valor de arreglo.
Si su query falla con este error, vuelva a ejecutar la query después de que se complete la operación de inserción o actualizar.
Change Streams aplican la preferencia de lectura después de las elecciones
A partir de MongoDB 9.0, un flujo de cambios abierto con un readPreference de primary o secondary devuelve el error reanudable InterruptedDueToReplStateChange (código de error 11602) de getMore si una elección de set de réplicas cambia el rol del nodo de modo que ya no satisfaga la preferencia de lectura. En versiones anteriores, el cursor seguÃa devolviendo resultados del mismo nodo.
driver compatibles y mongos se reanudan automáticamente desde el último token de reanudación. Los bucles manuales getMore y mongosh deben reanudarse con resumeAfter. Para obtener más información, consulte Reanudar un flujo de cambios.
Códigos de error de extracción de claves de Ãndice geoespacial
A partir de MongoDB 9.0, los errores de extracción de claves de Ãndice 2dsphere devuelven los códigos de error con nombre 510 (GeoKeyExtractionFailed) y 511 (GeoKeyExtractionFailedTimeseries). Estos códigos reemplazan los códigos de aserción anteriores 16755 y 16756 para 2Ãndices dsphere regulares y 183934 y 183493 para colecciones de series de tiempo. Si su aplicación coincide con los códigos anteriores, actualÃcela para que coincida con 510 y 511.
Bloqueos de colección más fuertes para varias bases de datos renameCollection
A partir de MongoDB 9.0, cuando cambias el nombre de una colección entre diferentes bases de datos en un set de réplicas, el comando renameCollection mantiene un bloqueo exclusivo en las colecciones de origen y destino. El bloqueo dura toda la operación y bloquea las operaciones DDL y guardar en ambas colecciones. La mayorÃa de las operaciones de lectura utilizan lecturas sin bloqueo y no se bloquean.
Las versiones anteriores liberaron el bloqueo de la colección de origen antes de que renameCollection completara el cambio de nombre. Un guardar simultáneo en la colección de origen durante esa ventana podrÃa perderse.
El cambio afecta solo a los set de réplicas. Los clústeres particionados ya bloquean ambas colecciones durante el cambio de nombre.
Las operaciones de fecha de JavaScript del lado del servidor usan UTC
A partir de MongoDB 9.0, JavaScript del lado del servidor se ejecuta en un motor basado en WebAssembly (WASM) que evalúa las operaciones locales de Date en UTC, independientemente de la zona horaria del host mongod. En versiones anteriores, estas operaciones observaron la zona horaria del host. El cambio afecta a JavaScript que se ejecuta en $function, $accumulator, $where y mapReduce.
El valor de fecha BSON almacenado permanece sin cambios, al igual que las operaciones UTC como Date.prototype.getTime(), Date.prototype.toISOString() y los métodos getUTC*(). La diferencia afecta a las operaciones de hora local:
Date.prototype.toString()Date.prototype.toTimeString()Date.prototype.getHours()y otros getters localesConstructores y establecedores locales de
DateOperaciones que convierten implÃcitamente fechas en cadenas, incluida
Array.prototype.sort()llamada sin un comparador
Considere las siguientes operaciones en un mongod que se ejecuta con TZ=America/New_York:
db.events.insertOne( { name: "before-opening", occurredAt: ISODate("2024-01-15T13:30:00Z")} )
db.events.find( { $expr: { $function: { body: function(date) { return date.getHours() < 9; }, args: [ "$occurredAt" ], lang: "js" } }} )En versiones anteriores, 13:30 UTC es 08:30 en Nueva York, por lo que getHours() devuelve 8 y la query coincide con el documento. A partir de MongoDB 9.0, getHours() devuelve 13 y la query no coincide. La operación se realiza correctamente en ambas versiones porque la fecha almacenada sigue siendo válida, por lo que la diferencia no se notifica como un error. Las implementaciones que ejecutan versiones binarias mixtas pueden devolver resultados diferentes para el mismo JavaScript.
Impacto de la actualización
Antes de actualización a MongoDB 9.0, revisión el JavaScript en su $function, $accumulator, $where, y mapReduce código para uso local de Date, y no confÃe en la mongod zona horaria del host.
Para evaluar fechas en una zona horaria con nombre, utilice un operador de fecha de agregación con un argumento timezone explÃcito en lugar de JavaScript. La siguiente query devuelve los mismos resultados en todas las versiones:
db.events.find( { $expr: { $lt: [ { $hour: { date: "$occurredAt", timezone: "America/New_York" } }, 9 ] }} )Para JavaScript que requiere una comparación determinista o serialización, utilice los métodos getTime(), toISOString() o getUTC*() en lugar de los métodos locales Date o la conversión implÃcita de string. Pase un comparador explÃcito a Array.prototype.sort() cuando los valores ordenados puedan contener fechas.
Para obtener más información, consulte JavaScript del lado del servidor.
JavaScript del lado del servidor no disponible en ppc64le
A partir de MongoDB 9.0, JavaScript del lado del servidor no está disponible en la arquitectura ppc64le. Los mongod y mongos binarios para ppc64le no incluyen un motor de JavaScript. Como resultado, las operaciones de $function, $accumulator, $where y mapReduce fallan en esa arquitectura. Versiones anteriores ejecutaron estas operaciones en ppc64le.
No se puede habilitar JavaScript del lado del servidor en ppc64le mediante un ajuste de archivo de configuración o una opción de lÃnea de comandos.
Impacto de la actualización
Antes de actualizar una implementación ppc64le a MongoDB 9.0, identifique las aplicaciones que utilizan $function, $accumulator, $where o mapReduce. Reescriba estas operaciones para usar etapas del pipeline de agregación y operadores que no requieren JavaScript del lado del servidor. También puede ejecutar las operaciones en una implementación que utiliza una arquitectura diferente.
Para obtener más información, consulte JavaScript del lado del servidor.
Seguridad
Queryable Encryption Prefijo, Sufijo y Subcadena: Migración de la vista previa pública a la disponibilidad general
MongoDB 9.0 marca la disponibilidad general de query de prefijo, sufijo y subcadena en campos de string cifrados en colecciones habilitadas para Queryable Encryption. La funcionalidad GA es incompatible con la versión de Public Preview lanzada en MongoDB 8.2, que no debe utilizarse ahora que la funcionalidad es GA.
Para usar querys de prefijo, sufijo o subcadena con Queryable Encryption, MongoDB debe ser la versión 9.0 o posterior, con driver compatibles con 9.0. Si sigue utilizando Public Preview, MongoDB debe permanecer en la versión 8.2 o 8.3, con 8.2 o 8.3 drivers compatibles.
Los drivers de MongoDB 9.0 pueden descifrar datos creados con los drivers de MongoDB 8.2 o 8.3. Para las opciones de actualización, consulta las siguientes secciones.
Comenzar de nuevo (preferido)
Si es posible, crea nuevas colecciones en lugar de migrar las creadas con la funcionalidad de vista previa pública:
Actualiza el servidor y los controladores de MongoDB a 9.0.
Configura una nueva colección cifrada con un nombre diferente al de la colección anterior.
Inserta nuevos datos o una versión sin cifrar de los datos existentes si dispones de una copia local.
Descarta la colección anterior.
Migrar datos existentes
Si no puedes utilizar datos nuevos o no tienes una versión no cifrada de los datos existentes:
Actualiza el servidor y los controladores de MongoDB a la versión 9.0
Utilizando un driver compatible con 9.0, haz una query en la colección cifrado para descifrarla.
Guarda la salida localmente.
Configura una nueva colección cifrada e ingiere los datos.
Advertencia
Las operaciones
mongoexportymongodumpno descifran la colección. Debes realizar una query de la colección desde un driver para obtener los datos descifrados.Los controladores compatibles con MongoDB 9.0 no pueden hacer una query en campos cifrados en datos cifrados para MongoDB 8.2. Tipos de query de vista previa pública. Para descifrar datos, haz una query en un campo no cifrado o en toda la colección.
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 9.0 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
En MongoDB 9.0, $convert puede convertir un objeto a binData. Para obtener más información, consulte Convertir un objeto a binData.
Si crea una vista que utiliza esta conversión, las query en esa vista devuelven un error después de que baje a una versión anterior.
Antes de degradar de 9.0, actualice o descarte cualquier vista que utilice esta conversión.