setFeatureCompatibilityVersion (comando de banco de dados)

Definir versão de compatibilidade do recurso

Obrigatório

Os valores possíveis para version são:

confirmar

Obrigatório

Defina como true para confirmar a alteração da compatibilidade do recurso e permitir que a operação continue.

Se você omitir o parâmetro confirm ou definir confirm como um valor diferente de true, o comando falhará e retornará um aviso sobre a modificação da feature compatibility version.

writeConcern

Opcional

O writeConcern especifica o valor de preocupação de gravação wtimeout em milissegundos:

• O período que o primary aguarda a confirmação da maioria dos nós do conjunto de réplicas. Se o reconhecimento não for recebido no período, a operação falhará.

• O padrão é 60000 milissegundos. Utilize um período mais longo se os membros secundários do conjunto de réplicas tiverem um atraso que exceda o padrão wtimeout.

execução seca

Opcional

Se definido para true, o MongoDB simula uma atualização ou downgrade da versão de compatibilidade do recurso. Se o cluster contiver dados incompatíveis, a operação falhará com um erro.

Atualizar com dados incompatíveis com o encaminhamento

Se você tentar atualizar a versão de compatibilidade do recurso de um cluster que contenha dados incompatíveis com encaminhamento na versão atualizada, receberá um erro CannotUpgrade. Dados incompatíveis com encaminhamento podem se referir a quaisquer dados em seu cluster que dependam de um recurso que foi removido na versão de destino.

Quando esse erro ocorre:

• Modifique os dados do seu cluster para remover os recursos incompatíveis com o encaminhamento e, em seguida, execute novamente o comando setFeatureCompatibilityVersion com a versão atualizada para definir a versão de compatibilidade do recurso para a versão atualizada.

• Execute o comando setFeatureCompatibilityVersion com a versão original rebaixada para configurar a versão de compatibilidade do recurso de volta para a versão original.

  Importante

  A configuração da versão de compatibilidade do recurso para a versão original interrompe o procedimento de atualização e reverte a versão de compatibilidade do recurso para a versão desatualizada. O cluster não retorna ao seu estado antes do início da atualização da versão de compatibilidade do recurso.

  Se a atualização da versão de compatibilidade do recurso confirmar que não há dados incompatíveis com o avanço, mas, caso contrário, parar ou falhar, qualquer tentativa subsequente de desatualização da versão de compatibilidade do recurso também falhará com uma mensagem de erro. Você deve concluir a atualização da versão de compatibilidade do recurso antes de poder desatualizar a versão de compatibilidade do recurso.

Downgrade com dados incompatíveis com versões anteriores

Se você tentar desatualizar a versão de compatibilidade do recurso de um cluster que contenha dados incompatíveis com versões anteriores na versão rebaixada, receberá um erro CannotDowngrade. Dados incompatíveis com versões anteriores podem se referir a quaisquer dados em seu cluster que dependam de um recurso que não esteja disponível na versão de destino.

Quando esse erro ocorre:

• Modifique os dados do cluster para remover funcionalidades incompatíveis com versões anteriores e, em seguida, execute novamente o comando setFeatureCompatibilityVersion com a versão rebaixada para definir o fCV para a versão rebaixada.

• Execute o comando setFeatureCompatibilityVersion com a versão atualizada original para configurar o fCV de volta para a versão original.

  Importante

  A configuração da versão de compatibilidade do recurso para a versão original interrompe o procedimento de downgrade e reverte a versão de compatibilidade do recurso para a versão atualizada. O cluster não retorna ao seu estado antes do início do downgrade da versão de compatibilidade do recurso.

  Se a desatualização da versão de compatibilidade do recurso confirmar que não há dados incompatíveis com versões anteriores, mas parar ou falhar, qualquer tentativa subsequente de atualização da versão de compatibilidade do recurso também falhará com uma mensagem de erro. Você deve concluir a desatualização da versão de compatibilidade do recurso antes de poder atualizar a versão de compatibilidade do recurso.

Política de downgrade no MongoDB 8.3

A partir de 8.3, você pode fazer downgrade da versão de compatibilidade do recurso do seu sistema para a versão secundária imediatamente anterior.

Para saber mais, consulte Downgrade 8.3 para 8.2.

Conflitos com operações em background

Certas operações em segundo plano podem impedir a execução de setFeatureCompatibilityVersion. Utilize o currentOp para identificar quaisquer operações em andamento.

Falhas de sincronização

Se você alterar a versão de compatibilidade do recurso durante uma sincronização inicial, a sincronização poderá falhar com um erro OplogOperationUnsupported ao reproduzir entradas na fase de aplicação oplog. A próxima sincronização é bem-sucedida porque a fase de operação não repete mais a operação.

Default Values

Idempotência

Este comando deve executar gravações em uma coleção interna do sistema. Se o comando não for concluído com êxito, você poderá tentar novamente com segurança. A operação é idempotente.

Cluster-to-Cluster Sync e bloqueio de escrita de usuário

A partir do MongoDB 6.0, se você precisar fazer downgrade da versão de compatibilidade de funcionalidades, certifique-se de desabilitar a replicação de cluster para cluster e o bloqueio de escrita do usuário.

1. Se você ativou a replicação de cluster para cluster, desative-a.

2. Se você habilitou o bloqueio de escrita do usuário, desative-o:

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

3. Aguarde a conclusão do comando anterior.

4. Faça downgrade da versão de compatibilidade de recursos usando setFeatureCompatibilityVersion.

Para obter mais informações sobre o MongoDB Cluster-to-Cluster Sync, consulte a documentação.

Compatibilidade de Funcionalidades em Arbiters

Os árbitros não replicam a collection admin.system.version. Por esse motivo, os árbitros sempre têm uma versão de compatibilidade de recursos igual à versão de downgrade do binário, independentemente do valor fCV do conjunto de réplicas.

Por exemplo, um árbitro em um cluster do MongoDB 5.0 tem um valor FCV de 4.4.

Obter FeatureCompatibilityVersion

Para visualizar o featureCompatibilityVersion para uma instância do mongod, execute o comando getParameter em uma instância do mongod:

db.adminCommand(
   {
      getParameter: 1,
      featureCompatibilityVersion: 1
   }
 )

A saída se assemelha 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 })
}

Definir versão de compatibilidade do recurso no MongoDB 8.0 implantação

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

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

Definir Versão de Compatibilidade de Funcionalidades nos Sistemas do MongoDB 7.0

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

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

Definir Tempo Limite de Write Concern

O exemplo a seguir define o campo de wtimeout de write concern opcional como 5000 (5 segundos).

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