Definir versão de compatibilidade do recurso

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. O aviso afirma que, depois de atualizar ou fazer downgrade do fCV do cluster, você não pode fazer downgrade da versão binária sem assistência de suporte.

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.

Downgrade com dados incompatíveis com versões anteriores

Se você tentar fazer downgrade do fCV de um cluster que contenha dados incompatíveis na versão baixada, receberá um erro CannotDowngrade. Quando esse erro ocorre, o cluster permanece no estado de transição downgrading.

Para tirar o cluster do estado downgrading:

• 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 do fCV para a versão original interrompe o procedimento de downgrade e altera o fCV de volta para a versão atualizada. Esse procedimento não redefine o cluster de volta ao estado anterior ao início do downgrade do fCV.

  Se os metadados internos de uma desatualização do fCV com falha não forem limpos, qualquer tentativa subsequente de atualização do FCV falhará com uma mensagem de erro. Você deve concluir a desatualização do fCV antes de tentar atualizar o fCV.

Alterações na Política de Downgrade do MongoDB 7.0

A partir do MongoDB 7.0, não é possível fazer downgrade do fCV do seu sistema ou de uma versão de rapid release do MongoDB.

Se você fizer o upgrade ou downgrade do fCV do seu sistema, não será possível fazer o downgrade da versão binária do seu sistema sem assistência do suporte.

Para saber mais, consulte Downgrade 7.0 para 6.0.

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ê acionar uma alteração de setFeatureCompatibilityVersion durante uma sincronização inicial, a sincronização poderá falhar com uma mensagem de erro OplogOperationUnsupported ao reproduzir entradas na fase de aplicação oplog. A sincronização após essa tentativa é 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 collection interna do sistema. Se, por algum motivo, o comando não for concluído com êxito, você poderá tentar novamente com segurança, pois 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 arbiters não replicam a collection admin.system.version. Por esse motivo, os arbiters 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 arbiter 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 de Funcionalidades nos Sistemas do MongoDB 7.0

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

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

Definir Versão de Compatibilidade de Funcionalidades em Sistemas do MongoDB 6.0

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

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

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

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

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

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