Cambios de compatibilidad en MongoDB 7.0

Compatibilidad de servidores y controladores entre vista previa pública y GA

Para utilizar Queryable Encryption con queries de igualdad, el servidor de MongoDB debe ser la versión 7.0 o posterior y los controladores deben ser compatibles con la versión 7.0. Si sigues utilizando la vista previa pública de Queryable Encryption incluida en MongoDB 6.x, el servidor debe permanecer en la versión 6.x y los controladores deben ser compatibles con la versión 6.x. No puedes utilizar controladores compatibles con MongoDB 6.x con un servidor 7.0, ni controladores compatibles con 7.0 con un servidor 6.x. Intentar hacerlo resulta en un error.

Para facilitar la actualización, los drivers de MongoDB 7.0 pueden descifrar datos creados con los drivers de MongoDB 6.x. Para las opciones de actualización, consulta las siguientes secciones.

Comportamiento de autenticación del token de acceso OIDC

A partir de MongoDB 7.0, solo se puede especificar un campo audience oidcIdentityProviders para los tokens de acceso OIDC. Los campos audience con arreglos vacíos o arreglos de varios strings no son válidos.

Para obtener más detalles, consulte Campos oidcIdentityProviders.

Configuraciones de granularidad

A partir de MongoDB 6.3, puedes configurar la granularidad de los buckets de series de tiempo utilizando los nuevos parámetros de buckets personalizados bucketMaxSpanSeconds y bucketRoundingSeconds. Para degradar a una versión inferior a 6.3, debes descartar todas las colecciones con estos parámetros o modificarlas para utilizar el granularity correspondiente. Para obtener más detalles, consulta collMod.

No todos los valores de bucketMaxSpanSeconds y bucketRoundingSeconds corresponden a un valor de granularity. En tales casos, debes descartar la colección.

Índices TTL parciales para colecciones de series de tiempo

A partir de MongoDB 6.3, puedes crear índices parciales de Time To Live (TTL) en colecciones de series de tiempo. Para degradar por debajo de 6.3, debes remover todos los índices parciales de TTL de tus colecciones de series de tiempo.

config.settings Validación de esquema

A partir de MongoDB 6.2, debes establecer value entre 1 y 1024 (inclusive) al insertar o actualizar documentos con el campo _id: chunksize en la colección config.settings. Si especificas un value no válido, MongoDB devuelve un error de validación de esquema.

Cualquier campo value fuera del rango de 1 a 1024 MB (inclusive) establecido antes de MongoDB 6.2 permanece sin cambios.

Opciones eliminadas

A partir de la versión 6.2, MongoDB remueve el campo maxSize del comando addShard. Como resultado:

• Ejecutar addShard con el campo maxSize devuelve un error InvalidOptions.

• Los nuevos documentos en la colección shards ya no incluyen el campo maxSize.

• Se ignoran todas las entradas de campo maxSize preexistentes.

$add Errores de redondeo en números de punto flotante

A partir de MongoDB 6.1, cuando una expresión $add recibe una lista de entrada con múltiples valores de punto flotante, MongoDB puede devolver resultados ligeramente diferentes en comparación con versiones anteriores.

La expresión $add ya no considera errores de redondeo de punto flotante. Como resultado, $add se comporta como la suma en la mayoría de los lenguajes de programación.

Por ejemplo, la siguiente expresión $add devuelve un resultado diferente cuando se ejecuta en MongoDB 6.1 en comparación con versiones anteriores:

db.test.aggregate(
   [
     {
        $project: {
           sumOfValues: {
              $add: [ 0.1, 0.2, 0.3 ]
           }
         }
      }
   ]
)

MongoDB 6.1 y salida posterior:

[
  {
    _id: ObjectId("6390f8085425651d8d0ef0a7"),
    sumOfValues: 0.6000000000000001
  }
]

MongoDB 6.0 y salida anterior:

[
  {
    _id: ObjectId("6390f8085425651d8d0ef0a7"),
    sumOfValues: 0.6
  }
]

Sin división automática de fragmentos

A partir de MongoDB 6.0.3, no se realiza la división automática de fragmentos. Esto se debe a las mejoras en la política de balanceo. Los comandos de división automática aún existen, pero no ejecutan ninguna operación.

A partir de MongoDB 6.1, los siguientes comandos de división automática no realizan ninguna operación:

• sh.enableAutoSplit()

• sh.disableAutoSplit()

Opciones eliminadas

A partir de MongoDB 6.1, el registro en la bitácora siempre está habilitado. Como resultado, MongoDB remueve la opción storage.journal.enabled y las opciones de línea de comandos --journal y --nojournal correspondientes.

A partir de MongoDB 6.1, SNMP ha sido eliminado. Todas las opciones de línea de comandos relacionadas impiden que mongod se inicie. Para supervisar su implementación, utilice MongoDB Ops Manager.

Parámetros del servidor

A partir de MongoDB 6.1, el valor por defecto para coordinateCommitReturnImmediatelyAfterPersistingDecision es false.

Cambios en las métricas de particionado

currentOp.opStatus se elimina de las métricas de redistribución en MongoDB 6.1.

No se permiten vistas en el namespace de la colección

No se puede crear una vista desde un namespace de colección de buckets con serie de tiempo (es decir, una colección con el prefijo system.buckets).

Si estás actualizando a MongoDB 6.1 desde una versión anterior, debes descartar todas las vistas que se hayan creado en las colecciones system.buckets.