setFeatureCompatibilityVersion (comando de base de datos)

setFeatureCompatibilityVersion

Requerido

Los valores posibles para version son:

confirme

Requerido

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

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.

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 anteriores en la versión actualizada, recibirás un error CannotUpgrade. Los datos no compatibles hacia adelante pueden referirse a cualquier dato de tu clúster que dependa de una funcionalidad que fue eliminada en la versión de destino.

Cuando se produce este error, se puede:

• Modifique los datos de su clúster para eliminar funciones que sean incompatibles con versiones futuras y, a continuación, vuelva a ejecutar el comando setFeatureCompatibilityVersion con la versión actualizada para establecer la compatibilidad de características entre versiones en la versión actualizada.

• Ejecute el comando setFeatureCompatibilityVersion con la versión original degradada para restablecer la compatibilidad de características entre versiones a la versión original.

  Importante

  Si se establece la compatibilidad de características entre versiones a la versión original, se detiene el procedimiento de actualización y se cambia la compatibilidad de características entre versiones de nuevo a la versión degradada. Este procedimiento no restablece el clúster al estado anterior al inicio de la actualización de compatibilidad de características entre versiones.

  Si la actualización del FCV confirma que no hay datos incompatibles en el futuro pero por lo demás se detiene o falla, cualquier intento posterior de degradación del FCV también fallará con un mensaje de error. Debes completar la actualización de compatibilidad de características entre versiones antes de intentar degradar la compatibilidad de características entre versiones.

Descenso de categoría con datos incompatibles

Si intentas rebajar la compatibilidad de características entre versiones de un clúster que contiene datos incompatibles con la versión rebajada, recibirás un error CannotDowngrade. Los datos incompatibles con versiones anteriores pueden referirse a cualquier dato en tu 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 setFeatureCompatibilityVersion con la versión degradada para establecer la compatibilidad de características entre versiones en la versión degradada.

• Ejecuta el comando setFeatureCompatibilityVersion con 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 cambia la compatibilidad de características entre versiones de nuevo a la versión mejorada. Este procedimiento no restablece el clúster al estado anterior a que comenzara la rebaja de compatibilidad de características entre versiones.

  Si la actualización compatibilidad de características entre versiones confirma que no hay datos incompatibles hacia atrás, pero de otro modo se detiene o falla, cualquier intento posterior de actualización de compatibilidad de características entre versiones también fallará con un mensaje de error. Debe completar la degradación de la compatibilidad de características entre versiones antes de intentar actualizar la compatibilidad de características entre versiones.

Política de degradación en MongoDB 8.3

A partir de 8.3, puedes revertir la compatibilidad de características entre versiones de tu 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.

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

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.

1. Si has activado la replicación de clúster a clúster, desactívala.

2. Si has activado el bloqueo de guardado del usuario, desactívalo:

   db.runCommand( { setUserWriteBlockMode: 1, global: false } )

3. Espera a que se complete el comando anterior.

4. 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.

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 })
}

Configurar la compatibilidad de características entre versiones en MongoDB 8.0 implementación

db.adminCommand(
   {
      setFeatureCompatibilityVersion: "8.0",
      confirm: true
   }
)

db.adminCommand(
   {
      setFeatureCompatibilityVersion: "7.0",
      confirm: true
   }
)

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

db.adminCommand(
   {
      setFeatureCompatibilityVersion: "7.0",
      confirm: true
   }
)

db.adminCommand(
   {
      setFeatureCompatibilityVersion: "6.0",
      confirm: true
   }
)

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).

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