Cambios de compatibilidad en MongoDB 5.0

Ciertos comandos sólo aceptan parámetros reconocidos

A partir de MongoDB 5.0, ciertos comandos de base de datos generan un error si se les pasa un parámetro que no aceptan explícitamente. En MongoDB 4.4 y versiones anteriores, los parámetros no reconocidos se ignoran sin previo aviso.

Comandos afectados:

• abortTransaction

• aggregate

• authenticate

• collMod

• commitTransaction

• create

• createIndexes

• delete

• drop

• dropDatabase

• dropIndexes

• endSessions

• explain

• find

• findAndModify

• getMore

• hello

• insert

• killCursors

• listCollections

• listDatabases

• listIndexes

• ping

• refreshSessions

• update

Comandos eliminados

A partir de MongoDB 5.0, se eliminan estos comandos de base de datos y mongo métodos auxiliares de shell:

Parámetros eliminados

MongoDB 5.0 elimina los siguientes parámetros del servidor:

Tipos de índice eliminados

MongoDB 5.0 elimina el geoHaystack índice obsoleto. En su 2lugar, utiliza un índice d.

Actualizar su instancia de MongoDB a 5.0 y configurar featureCompatibilityVersion en 5.0 eliminará cualquier índice geoHaystack preexistente.

Métricas eliminadas

A partir de MongoDB,5.0 el serverStatus comando no genera, que opReadConcernCounters contenía el nivel de lectura especificado por las operaciones de consulta. En su lugar, el nuevo readConcernCounters reemplaza opReadConcernCounters a y contiene información adicional.

A partir de MongoDB,5.0 el comando no serverStatus genera cache pressure percentage threshold current cache pressure percentage ni wiredTiger.snapshot-window-settings bajo.

Se eliminó la compatibilidad con Raspberry Pi

MongoDB 5.0 ya no es compatible con Raspberry Pi. Para ejecutar MongoDB en Raspberry Pi, instale la versión 4.4.

Comportamiento de TTL cuando se establece en expireAfterSeconds NaN

A partir de MongoDB,5.0 los índicesTTL con expireAfterSeconds establecido en experimentan NaN un cambio de comportamiento en comparación con versiones anteriores.

El cambio de comportamiento afecta:

• actualizaciones directas

• sincronización inicial desde versiones anteriores

• mongorestore de versiones anteriores

Realizar cualquiera de esas acciones hará que un valor expireAfterSeconds de NaN se trate como un expireAfterSeconds de 0. Como resultado, los documentos pueden caducar inmediatamente.

A partir de MongoDB 5.0.14 (y 6.0.2), el servidor no utilizará índices TTL que tengan expireAfterSeconds configurado en NaN.

Cambios de shell

El mongo shell ha quedado obsoleto en MongoDB5.0 v. El shell de reemplazo mongosh es.

El empaquetado de shell también cambia en MongoDB v.5.0 Consulte las instrucciones de instalación para obtener más detalles.

Sets de réplicas

if [ (#arbiters > 0) AND (#non-arbiters <= majority(#voting-nodes)) ]
    defaultWriteConcern = { w: 1 }
else
    defaultWriteConcern = { w: "majority" }

Nivel de consistencia de lectura snapshot sobre colecciones con tamaño fijo

A partir de MongoDB,5.0 no se puede utilizar "snapshot" la preocupación de lectura al leer desde una colección limitada.

local es la preocupación de lectura predeterminada

A partir de MongoDB 5.0, "local" es el nivel de consistencia de lectura por defecto para las operaciones de lectura en el primario y los secundarios. En MongoDB 4.4, las consultas dirigidas a secundarios de clúster particionado utilizan el nivel de consistencia de lectura "available" y pueden devolver documentos huérfanos.

Esto puede introducir un aumento significativo de latencia para las queries de conteo que usan un filtro y para queries cubiertas.

Puede optar por no realizar este comportamiento configurando la preocupación de lectura setDefaultRWConcernde todo el clúster con.

Nuevo cursor.map() tipo de retorno

cursor.map() devolvió un Array en el mongo shell heredado. El tipo de retorno es Cursor mongoshen. Puede usar .toArray() para convertir los resultados.

Actualizar cambios del operador

A partir de MongoDB,5.0 ya no genera un error cuando se utilizan los siguientes operadores de actualización con una expresión de operandomongod vacía{ } ():

• $addToSet

• $bit

• $currentDate

• $inc

• $max

• $min

• $mul

• $pop

• $pull

• $pullAll

• $push

• $rename

• $set

• $setOnInsert

• $unset

Una actualización vacía no produce cambios y no genera ninguna entrada en el oplog (lo que significa que la operación es una “no-op").

$setWindowFields Etapa con transacciones y lectura de instantáneas

En versiones de MongoDB anteriores 5.3 a, la $setWindowFields etapa de canalización de agregación no se puede utilizar con transacciones ni con la "snapshot" pregunta de lectura.

Límites de parámetros del operador de pipeline de agregación

Los siguientes operadores de canalización de agregación ahora tienen un límite máximo de valor entero de 64bits.

• $sort

• $limit

Si pasa un valor que excede este límite, la canalización devuelve un error de argumento no válido.

listDatabases Cambios en la salida

A partir de MongoDB 5.0, la salida del comandolistDatabasesque se ejecuta contra unmongodes más consistente con la salida delistDatabasesque se ejecuta contra unmongos.

La siguiente tabla muestra las diferencias entre los tipos de datos de los campos de salida de listDatabases entre MongoDB 5.0 y versiones anteriores. Sólo se listan los campos que difieren entre la versión 5.0 y las anteriores.

La salida de ahora incluye listDatabases el totalSizeMb campo al ejecutarse con o. En mongos mongodMongoDB,4 4 y versiones anteriores, totalSizeMb solo aparece al ejecutarse mongos con. totalSizeMb es la suma de los sizeOnDisk campos, expresada en megabytes.

Al ejecutarse contra,mongos el shards campo de la salida contiene un par campo-valor para cada colección de un fragmento específico. Los valores de tamaño listDatabases del shards campo se expresan como enteros.

Seguridad

Map-Reduce

A partir de la 5.0 versión, MongoDB deja obsoleta la operación map-reduce.

Para obtener ejemplos de alternativas de canalización de agregación a operaciones de map-reduce, consulte Map-Reduce a canalización de agregación yEjemplos de Map-Reduce.

Auditoría

MongoDB 5.0 agrega capacidades de auditoría que se pueden configurar en tiempo de ejecución.

Si auditLog.runtimeConfiguration se establece true en, los mongod mongos archivos de configuración y ya no pueden establecer setParameter.auditAuthorizationSuccess ni configurar filtros de auditoría. Si los archivos de configuración del servidor contienen estas opciones, el servidor no se iniciará y registrará un error.

Si auditLog.runtimeConfiguration se establece en false y hay un documento de configuración de filtro de auditoría, se emitirá una advertencia de inicio, pero el servidor no se interrumpirá.

Reducir el riesgo de fragmentos obsoletos en transacciones particionadas

A partir de MongoDB,5.0 si cambia el parámetro,transactionLifetimeLimitSeconds transactionLifetimeLimitSeconds también debe cambiar al mismo valor en todos los miembros del conjunto de réplicas del servidor de configuración. Para mantener este valor constante:

• Garantiza que el historial de la tabla de enrutamiento se conserve al menos durante el tiempo límite de vida de las transacciones en los miembros del set de réplicas del fragmento.

• Reduce la frecuencia de reintentos de transacciones y, por lo tanto, mejora el rendimiento.

Cambios generales

A partir de MongoDB 5.0:

• Si featureCompatibilityVersion "5.0" se establece en o mayor, los usuarios ya no pueden escribir directamente en la <database>.system.views colección.

• El comando reIndex y el método de shell db.collection.reIndex() solo se pueden ejecutar en instancias independientes.

• La cantidad de etapas de canalización de agregación permitidas en una sola canalización está limitada 1000 a.

• Al eliminar la colección final en una base de datos (o eliminar la base de datos en sí) cuando directoryPerDB o está habilitado, se elimina el subdirectorio recién vacío para esa base de --directoryperdb datos.

• El $subtract operador de agregación convertirá el tipo de dato del resultado si es necesario para representarlo con precisión. Consulte para conocer las conversiones $subtract específicas.

• MongoDB remueve la opción de línea de comandos --serviceExecutor y la correspondiente opción de configuración net.serviceExecutor.

• No puedes autenticarte como usuarios simultáneos en la misma sesión de cliente si la opción --apiStrict está activada. Si intentas autenticarte como un nuevo usuario mientras ya has iniciado sesión como usuario existente y la opción de propiedad --apiStrict está activada, se generará un mensaje de error una vez por cada intento de autenticación. Si no usas la opción --apiStrict, autenticarte como un nuevo usuario mientras ya has iniciado sesión como uno existente guardará una advertencia en el registro una vez por cada intento de autenticación.

• La opción de $text pesos solo está permitida para índices.

• Debe configurar explícitamente la preocupación de escritura predeterminada global antes de intentar reconfigurar un conjunto de réplicas no fragmentadas con una configuración que cambie la preocupación de escritura predeterminada implícita. Para configurar la preocupación de escritura predeterminada global, utilice el setDefaultRWConcern comando.

• Para establecer el replSetOplog tamaño en, utilice mongosh el Double() constructor con el replSetResizeOplog comando.

5.0 Compatibilidad de funciones

Algunas funciones de 5.0 requieren no solo los 5.0 binarios de, sino también la featureCompatibilityVersion (FCV) establecida 5.0 en. Estas funciones incluyen:

• La creación de colecciones de series de tiempo requiere que FCV esté configurado en 5.0+.

• Paraconfigurar la administración del filtro de auditoría en 5.0tiempo de ejecución, es necesario que FCV esté configurado en +.

• El uso de . y $ en los nombres de campo requiere que FCV esté configurado en 5.0+.

• Para volver a fragmentar una colección es necesario que FCV esté configurado en 5.0+.