Definición
setFeatureCompatibilityVersionActiva o desactiva las caracterÃsticas que mantienen datos incompatibles con versiones anteriores de MongoDB. Sólo puedes emitir el
setFeatureCompatibilityVersioncontra la base de datosadmin.
Para aprender qué es la compatibilidad de caracterÃsticas entre versiones y cómo admite las degradaciones, consulte Versiones de MongoDB y rutas de actualización.
Advertencia
La habilitación de caracterÃsticas incompatibles con versiones anteriores puede complicar el proceso de degradación, ya que debes Remover cualquier caracterÃstica incompatible con versiones anteriores que persista antes de realizar la degradación.
Después de actualizar, permita que la implementación se ejecute sin habilitar funcionalidades incompatibles con versiones anteriores durante un perÃodo de prueba. Habilite estas funcionalidades solo después de estar seguro de que es poco probable que se realice una degradación.
Compatibilidad
Este comando está disponible en implementaciones alojadas en los siguientes entornos:
MongoDB Enterprise: La versión basada en suscripción y autogestionada de MongoDB
MongoDB Community: La versión de MongoDB con código fuente disponible, de uso gratuito y autogestionada.
Sintaxis
Cambiado en la versión 8.3.
El comando tiene la siguiente sintaxis:
db.adminCommand( { setFeatureCompatibilityVersion: <version>, confirm: true, writeConcern: { wtimeout: <timeout> }, dryRun: <boolean> })Campos de comandos
El comando setFeatureCompatibilityVersion toma los siguientes campos:
setFeatureCompatibilityVersion
Requerido
Los valores posibles para version son:
Versión | Descripción |
|---|---|
| Disponible en MongoDB 8.3. Implementaciones Permite las 8.3 caracterÃsticas que persisten datos incompatibles con MongoDB 8.2. |
| Disponible en MongoDB 8.2 y MongoDB 8.3 Implementaciones A partir de MongoDB 8.3, puede degradar compatibilidad de caracterÃsticas entre versiones de |
| Disponible en MongoDB 8.0. Implementaciones Permite las 8.0 caracterÃsticas que persisten datos incompatibles con MongoDB 7.0. |
| Disponible en las implementaciones de MongoDB 7.0 Habilita las caracterÃsticas de 7.0 que mantienen datos incompatibles con MongoDB 6.0. |
confirme
Requerido
Nuevo en la versión 7.0.
Establece en true para confirmar el cambio de compatibilidad de caracterÃsticas y permitir que la operación continúe.
Si omites el parámetro confirm o estableces confirm en un valor distinto de true, el comando falla y devuelve una advertencia sobre la modificación de la compatibilidad de funcionalidades entre versiones.
writeConcern
Opcional
El writeConcern especifica el valor wtimeout del nivel de confirmación de escritura en milisegundos:
El perÃodo de tiempo que el primario espera la confirmación de la mayorÃa de los miembros del Set de réplicas. Si no se recibe el acuse de recibo en el perÃodo de tiempo, la operación falla.
Por defecto es
60000milisegundos. Utiliza un perÃodo de tiempo más largo si los miembros secundarios del Set de réplicas tienen un retraso que excede elwtimeoutpor defecto.
dryRun (Ejecutar en seco)
Opcional
Si se establece en true, MongoDB simula una actualización o degradación de la compatibilidad de caracterÃsticas entre versiones. Si el clúster contiene datos incompatibles, la operación falla con un error.
Nuevo en la versión 8.3.
Comportamiento
Si debes reducir la compatibilidad de caracterÃsticas entre versiones por debajo de 8.0, debes ejecutar primero el comando transitionToDedicatedConfigServer. Para obtener detalles sobre la degradación, consulta Degradación de la compatibilidad de caracterÃsticas entre versiones.
Actualización con datos incompatibles hacia adelante
Si intentas actualizar la compatibilidad de caracterÃsticas entre versiones de un clúster que contiene datos incompatibles con versiones posteriores en la versión actualizada, recibirás un error CannotUpgrade. Los datos incompatibles con versiones posteriores pueden referirse a cualquier dato de su clúster que dependa de una funcionalidad que se eliminó en la versión de destino.
Cuando se produce este error, se puede:
Modifique los datos del clúster para remover funcionalidades incompatibles con versiones posteriores, luego vuelva a ejecutar el comando
setFeatureCompatibilityVersioncon la versión actualizada para establecer la compatibilidad de caracterÃsticas entre versiones en la versión actualizada.Ejecuta el comando
setFeatureCompatibilityVersioncon la versión degradada original para restablecer la compatibilidad de caracterÃsticas entre versiones a la versión original.Importante
Configurar la compatibilidad de caracterÃsticas entre versiones a la versión original detiene el procedimiento de actualización y revierte la compatibilidad de caracterÃsticas entre versiones a la versión degradada. El clúster no vuelve a su estado anterior a que comenzara la actualización de compatibilidad de caracterÃsticas entre versiones.
Si la actualización de compatibilidad de caracterÃsticas entre versiones confirma que no hay datos incompatibles con versiones posteriores, pero, por lo demás, se detiene o falla, cualquier intento posterior de degradación de la compatibilidad de caracterÃsticas entre versiones también falla con un mensaje de error. Debes completar la actualización de la compatibilidad de caracterÃsticas entre versiones antes de que puedas rebajar la compatibilidad de caracterÃsticas entre versiones.
Descenso de categorÃa con datos incompatibles
Si intentas reducir la compatibilidad de caracterÃsticas entre versiones de un clúster que contiene datos incompatibles con versiones anteriores en la versión reducida, recibirás un error CannotDowngrade. Los datos incompatibles con versiones anteriores pueden referirse a cualquier dato de su clúster que dependa de una funcionalidad que no esté disponible en la versión de destino.
Cuando se produce este error, se puede:
Se deben modificar los datos del clúster para eliminar las funcionalidades incompatibles con versiones anteriores, luego se debe volver a ejecutar el comando
setFeatureCompatibilityVersioncon la versión degradada para establecer la compatibilidad de caracterÃsticas entre versiones en la versión degradada.Ejecuta el comando
setFeatureCompatibilityVersioncon la versión mejorada original para restablecer la compatibilidad de caracterÃsticas entre versiones a la versión original.Importante
Configurar la compatibilidad de caracterÃsticas entre versiones a la versión original detiene el procedimiento de degradación y revierte la compatibilidad de caracterÃsticas entre versiones a la versión mejorada. El clúster no vuelve a su estado anterior a que comenzara la rebaja de compatibilidad de caracterÃsticas entre versiones.
Si la degradación de la compatibilidad de caracterÃsticas entre versiones confirma que no hay datos incompatibles con versiones anteriores, pero por lo demás se detiene o falla, cualquier intento posterior de actualización de la compatibilidad de caracterÃsticas entre versiones también fallará con un mensaje de error. Debes completar la rebaja de la compatibilidad de caracterÃsticas entre versiones antes de poder actualizar la compatibilidad de caracterÃsticas entre versiones.
PolÃtica de degradación en MongoDB 8.3
A partir de 8.3, puede degradar la compatibilidad de caracterÃsticas entre versiones de su implementación a la versión menor inmediatamente anterior.
Para aprender más, consultar Degradar 8.3 a 8.2.
Conflictos con las operaciones en segundo plano
Ciertas operaciones en segundo plano pueden impedir la ejecución de setFeatureCompatibilityVersion. Utiliza currentOp para identificar cualquier operación en curso.
Importante
A partir de MongoDB 9.0, si hay una creación de Ãndices en curso en cualquier colección del clúster, setFeatureCompatibilityVersion falla rápidamente con un error BackgroundOperationInProgressForNamespace y no realiza ningún cambio en el catálogo. La compatibilidad de caracterÃsticas entre versiones permanece sin cambios. Una creación de Ãndices que se inicia después de que se ejecuta la comprobación aún puede hacer que el comando falle más tarde. Para reintentar el comando, primero espere a que se complete la creación de Ãndices o abórtela.
Fallos de sincronización
Si se cambia la compatibilidad de caracterÃsticas entre versiones durante una sincronización inicial, la sincronización puede fallar con un error OplogOperationUnsupported al reproducir las entradas en la fase de aplicación oplog. La siguiente sincronizar tiene éxito porque la fase de operación ya no repite la operación.
Default Values
Implementaciones | featureCompatibilityVersion |
|---|---|
Para los nuevos 8.3 implementaciones |
|
Para 8.3 implementaciones actualizadas desde 8.2 |
|
Para los nuevos 8.0 implementaciones |
|
Para 8.0 implementaciones actualizadas desde 7.0 |
|
Para nuevas implementaciones de 7.0 |
|
Para implementaciones de 7.0 actualizadas desde 6.0 |
|
Idempotencia
Este comando debe realizar guardados en una colección interna del sistema. Si el comando no se completa correctamente, puede volver a intentarlo con seguridad. La operación es idempotente.
Cluster-to-Cluster Sync y bloqueo de guardado de usuarios
A partir de MongoDB 6.0, si necesita degradar la compatibilidad de caracterÃsticas entre versiones, asegúrate de deshabilitar la replicación de clúster a clúster y el bloqueo de escritura de usuarios.
Si has activado la replicación de clúster a clúster, desactÃvala.
Si has activado el bloqueo de guardado del usuario, desactÃvalo:
db.runCommand( { setUserWriteBlockMode: 1, global: false } )Espera a que se complete el comando anterior.
Reduce la compatibilidad de caracterÃsticas entre versiones usando
setFeatureCompatibilityVersion.
Para obtener más información sobre MongoDB Cluster-to-Cluster Sync, consulta la documentación.
Compatibilidad de caracterÃsticas en árbitros
Los árbitros no replican la admin.system.version colección. Por esta razón, los árbitros siempre tienen una compatibilidad de caracterÃsticas entre versiones igual a la versión de degradación del binario, independientemente del valor de la compatibilidad de caracterÃsticas entre versiones del Set de réplicas.
Por ejemplo, un árbitro de un clúster de MongoDB 5.0 tiene un valor de compatibilidad de caracterÃsticas entre versiones de 4.4.
Ejemplos
Obtener FeatureCompatibilityVersion
Para ver el featureCompatibilityVersion de una instancia de mongod, ejecuta el comando getParameter en una instancia de mongod:
db.adminCommand( { getParameter: 1, featureCompatibilityVersion: 1 } )La salida es similar a:
{ featureCompatibilityVersion: { version: '5.0' }, ok: 1, '$clusterTime': { clusterTime: Timestamp({ t: 1660318752, i: 5 }), signature: { hash: Binary(Buffer.from("ce0cff3621e9b089fa6d8e9a1e1efc1a1ff15dab", "hex"), 0), keyId: Long("7129893797260951557") } }, operationTime: Timestamp({ t: 1660318752, i: 5 })}Nota
La operación no está definida en las instancias de mongos.
En un clúster particionado que tiene habilitado el control de acceso, debe conectarse al fragmento como usuario local del fragmento para ejecutar el comando.
Configurar la compatibilidad de caracterÃsticas entre versiones en MongoDB 8.0 implementación
Habilite 8.0 Funcionalidades incompatibles hacia atrás
Para habilitar las 8.0 funcionalidades que persisten datos incompatibles con MongoDB 7.0, configura la compatibilidad de la funcionalidad en "8.0" en la implementación de MongoDB 8.0:
Nota
Ejecuta el comando setFeatureCompatibilityVersion en la base de datos admin.
db.adminCommand( { setFeatureCompatibilityVersion: "8.0", confirm: true })Deshabilitar 8.0 Funcionalidades incompatibles hacia atrás
Para desactivar 8.0 las funcionalidades que persisten datos incompatibles con MongoDB 7.0, establece la compatibilidad funcional a "7.0" en la implementación MongoDB 8.0:
Nota
Ejecuta el comando setFeatureCompatibilityVersion en la base de datos admin.
Para una instancia autónoma, ejecuta el comando en la instancia
mongodautónoma.Para un Set de réplicas, ejecuta el comando en el Primario. La mayorÃa de los miembros portadores de datos deben estar disponibles.
Para un clúster fragmentado, ejecuta el comando en una instancia
mongos.
"7.0"featureCompatibilityVersion es compatible con las implementaciones de MongoDB 7.0 y MongoDB 8.0.
db.adminCommand( { setFeatureCompatibilityVersion: "7.0", confirm: true })Si ejecutas este comando como parte del proceso de degradación de MongoDB 8.0 a MongoDB 7.0, también se deben remover todas las funcionalidades persistentes que sean incompatibles con 7.0. Consulte los procedimientos apropiados de degradación.
Establecer la versión de compatibilidad de caracterÃsticas entre versiones en implementaciones de MongoDB 7.0
Habilita caracterÃsticas incompatibles con versiones anteriores de 7.0
Para habilitar las caracterÃsticas de 7.0 que persisten datos incompatibles con MongoDB 6.0, establece la compatibilidad de caracterÃsticas en "7.0" en la implementación de MongoDB 7.0:
Nota
Ejecuta el comando setFeatureCompatibilityVersion en la base de datos admin.
db.adminCommand( { setFeatureCompatibilityVersion: "7.0", confirm: true })Desactivar caracterÃsticas incompatibles con versiones anteriores de 7.0
Para desactivar las caracterÃsticas de 7.0 que persisten datos incompatibles con MongoDB 6.0, configura la compatibilidad de caracterÃsticas a "6.0" en la implementación de MongoDB 7.0:
Nota
Ejecuta el comando setFeatureCompatibilityVersion en la base de datos admin.
Para una instancia autónoma, ejecuta el comando en la instancia
mongodautónoma.Para un Set de réplicas, ejecuta el comando en el Primario. La mayorÃa de los miembros portadores de datos deben estar disponibles.
Para un clúster fragmentado, ejecuta el comando en una instancia
mongos.
"6.0"featureCompatibilityVersion es compatible solo con las implementaciones de MongoDB 6.0 y MongoDB 7.0.
db.adminCommand( { setFeatureCompatibilityVersion: "6.0", confirm: true })Si se ejecutan como parte del proceso de degradación de MongoDB 7.0 a MongoDB 6.0, también debes remover todas las caracterÃsticas persistentes que sean incompatibles con 6.0. Consulta los procedimientos de degradación apropiados.
Establecer el Tiempo de Espera del Nivel de Confirmación de Escritura
El siguiente ejemplo establece el campo opcional de nivel de confirmación de escritura wtimeout en 5000 (5 segundos).
Nota
Ejecuta el comando setFeatureCompatibilityVersion en la base de datos admin.
db.adminCommand( { setFeatureCompatibilityVersion: "5.0", writeConcern: { wtimeout: 5000 }} )Solución de problemas
Si experimentas problemas de inicio después de configurar la compatibilidad de caracterÃsticas entre versiones, comunÃcate con el Soporte de MongoDB para buscar ayuda.