/ /

Comandos de base de datos

Administración

Docs Home

Manual de base de datos

Referencia

Comandos de base de datos

Administración

setFeatureCompatibilityVersion (comando de base de datos)

Esta versión de la documentación está archivada y ya no recibe soporte. Para actualizar su implementación 6.0, consulte Procedimientos de actualización de MongoDB.7.0

Definición

setFeatureCompatibilityVersion: Activa o desactiva las características que mantienen datos incompatibles con versiones anteriores de MongoDB. Sólo puedes emitir el setFeatureCompatibilityVersion contra la base de datos admin.

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.

Se recomienda que, después de actualizar, se permita que la implementación se ejecute sin habilitar funcionalidades incompatibles con versiones anteriores durante un período de prueba para asegurar que la probabilidad de tener que realizar una degradación sea mínima. Cuando te tenga la certeza de que la probabilidad de degradación es mínima, se deben activar estas funcionalidades.

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

El comando tiene la siguiente sintaxis:

db.adminCommand(
   {
     setFeatureCompatibilityVersion: <version>,
     writeConcern: { wtimeout: <timeout> }
   }
)

Campos de comandos

Los valores posibles para version son:

Versión	Descripción
`"6.0"`	Disponible en MongoDB 6.0. Implementaciones Permite las 6.0 características que persisten datos incompatibles con MongoDB 5.0.
`"5.0"`	Disponible en las implementaciones de MongoDB 5.0 y 6.0 Permite las 5.0 características que persisten datos incompatibles con MongoDB 4.4.

El opcional writeConcern especifica el valor de preocupación de escritura wtimeout 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 60000 milisegundos. Utiliza un período de tiempo más largo si los miembros secundarios del Set de réplicas tienen un retraso que excede el wtimeout por defecto.

Nota

Para una instancia autónoma, ejecuta el comando en la instancia mongod autó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.

Comportamiento

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.

Fallos de sincronización

Si se produce un setFeatureCompatibilityVersion cambio de trigger durante una sincronización inicial, la sincronización puede fallar con un mensaje de error OplogOperationUnsupported al reproducir las entradas en la fase de aplicación oplog. La sincronización después de este intento tiene éxito porque la fase de Operación ya no repite la Operación.

Default Values

Implementaciones	`featureCompatibilityVersion`
Para nuevas implementaciones de 6.0	`"6.0"`
Para las 6.0 implementaciones actualizadas desde 5.0	`"5.0"` hasta que `setFeatureCompatibilityVersion` a `"6.0"`.

Idempotencia

Este comando debe realizar guardados en una colección interna del sistema. Si por alguna razón el comando no se completa correctamente, puede volver a intentarlo con seguridad, ya que 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.

Establecer la versión de compatibilidad de características entre versiones en las implementaciones de MongoDB 6.0

Activar las características incompatibles con versiones anteriores de 6.0

Para habilitar las 6.0 funciones que persisten datos incompatibles con MongoDB,5.0 configure la compatibilidad de funciones en en la "6.0" 6.0 implementación de MongoDB:

Nota

Ejecuta el comando setFeatureCompatibilityVersion en la base de datos admin.

Para una instancia autónoma, ejecuta el comando en la instancia mongod autó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.

db.adminCommand( { setFeatureCompatibilityVersion: "6.0" } )

Desactivar características incompatibles con la versión 6.0

Para deshabilitar las 6.0 funciones que persisten datos incompatibles con MongoDB,5.0 configure la compatibilidad de funciones en en la "5.0" 6.0 implementación de MongoDB:

Nota

Ejecuta el comando setFeatureCompatibilityVersion en la base de datos admin.

Para una instancia autónoma, ejecuta el comando en la instancia mongod autó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.

"5.0" featureCompatibilityVersion es compatible solo con las implementaciones de MongoDB 5.0 y MongoDB 6.0.

db.adminCommand( { setFeatureCompatibilityVersion: "5.0" } )

Si se ejecuta como parte del proceso de degradación de MongoDB 6.0 a MongoDB,5.0 también debe eliminar todas las características persistentes que sean incompatibles con. Consulte 5.0 los procedimientos de degradación correspondientes.

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.

Para una instancia autónoma, ejecuta el comando en la instancia mongod autó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.

db.adminCommand( {
   setFeatureCompatibilityVersion: "5.0",
   writeConcern: { wtimeout: 5000 }
} )

Volver

setClusterParameter

setIndexCommitQuorum