Para agentes de IA: hay un índice de documentación disponible en https://www.mongodb.com/es/docs/llms.txt — versiones en markdown de todas las páginas están disponibles agregando .md a cualquier ruta URL.

Cambios de compatibilidad en MongoDB 9.0

Esta página describe los cambios introducidos en MongoDB 9.0 que pueden afectar la compatibilidad con versiones antiguas de MongoDB.

Obsoleto
Descripción

prefixPreview, suffixPreview, substringPreview

A partir de MongoDB 9.0, los tipos de query prefixPreview, suffixPreview y substringPreview que utilizan el algoritmo text quedan obsoletos y se eliminan. Utilice los tipos de query prefix, suffix o substring con el algoritmo string en su lugar.

fleDisableSubstringPreviewParameterLimits

No se pueden anular los límites internos en las queries de subcadenas en campos cifrados en MongoDB 9.0.

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.

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.

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.

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.

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.

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.

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 locales

  • Constructores y establecedores locales de Date

  • Operaciones 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.

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.

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.

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.

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.

Si es posible, crea nuevas colecciones en lugar de migrar las creadas con la funcionalidad de vista previa pública:

  1. Actualiza el servidor y los controladores de MongoDB a 9.0.

  2. Configura una nueva colección cifrada con un nombre diferente al de la colección anterior.

  3. Inserta nuevos datos o una versión sin cifrar de los datos existentes si dispones de una copia local.

  4. Descarta la colección anterior.

Si no puedes utilizar datos nuevos o no tienes una versión no cifrada de los datos existentes:

  1. Actualiza el servidor y los controladores de MongoDB a la versión 9.0

  2. Utilizando un driver compatible con 9.0, haz una query en la colección cifrado para descifrarla.

  3. Guarda la salida localmente.

  4. Configura una nueva colección cifrada e ingiere los datos.

Advertencia

  • Las operaciones mongoexport y mongodump no 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.

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.

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.