db.fsyncUnlock()

Definição

db.fsyncUnlock()

Reduz a contagem de bloqueios no servidor para reativar as operações de gravação.

A partir de MongoDB 7.1 (também disponível a partir de 7.0.2, 6.0.11 e 5.0.22) os métodos db.fsyncLock() e db.fsyncUnlock() podem ser executados no mongos para bloqueio e desbloquear um cluster fragmentado.

Importante

Método mongosh

Esta página documenta um método mongosh. Esta não é a documentação de comandos de banco de dados nem drivers específicos de linguagem, como Node.js.

Para o comando do banco de dados, consulte o comando fsyncUnlock.

Para drivers de API do MongoDB, consulte a documentação do driver do MongoDB específica da linguagem.

Os servidores mantêm uma contagem de bloqueio do fsync . O método fsyncLock() aumenta a contagem de bloqueio , e o método fsyncUnlock() a diminui. Para destravar escritas em um servidor ou cluster, chame o método fsyncUnlock() até que a contagem de bloqueio chegue a zero.

db.fsyncUnlock() é uma operação administrativa. Use este método para desbloquear um servidor ou cluster após uma operação de backup

db.fsyncUnlock() tem a sintaxe:

db.fsyncUnlock()

A operação retorna um documento com os seguintes campos:

info	Informações sobre o status da operação.
lockCount	O número de bloqueio restantes na instância após a operação.
ok	O código de status.

O método db.fsyncUnlock() encapsula o comando fsyncUnlock.

Compatibilidade

Esse método está disponível em implantações hospedadas nos seguintes ambientes:

• MongoDB Atlas: o serviço totalmente gerenciado para implantações do MongoDB na nuvem

• MongoDB Enterprise: a versão autogerenciada e baseada em assinatura do MongoDB

• MongoDB Community: uma versão com código disponível, de uso gratuito e autogerenciada do MongoDB

Compatibilidade com WiredTiger

db.fsyncLock() garante que os arquivos de dados estejam seguros para cópia usando utilidades de backup de baixo nível, como cp, scp ou tar. Um mongod iniciado usando os arquivos copiados contém dados gravados pelo usuário que não podem ser distinguidos dos dados gravados pelo usuário no mongod bloqueado.

Os arquivos de dados de um mongod bloqueado podem mudar devido a operações como sincronizações do registro no diário ou snapshots do WiredTiger. Embora isso não tenha efeito nos dados lógicos (por exemplo dados acessados pelos clientes), alguns utilidades de backup podem detectar essas alterações e emitir avisos ou não funcionar com os erros. Para obter mais informações sobre MongoDB- utilidades e procedimentos de backup recomendados, consulte Métodos de backup para um sistema autogerenciado.

Exemplo

Considere uma situação em que db.fsyncLock() foi emitido duas vezes. A operação db.fsyncUnlock() a seguir reduz os bloqueios feitos por db.fsyncLock() por 1:

db.fsyncUnlock()

A operação retorna o seguinte documento:

{ "info" : "fsyncUnlock completed", "lockCount" : NumberLong(1), "ok" : 1 }

Como lockCount é maior que 0, a instância mongod é bloqueada contra gravações. Para desbloquear a instância para escritas, execute db.fsyncLock() novamente:

db.fsyncUnlock()

A operação retorna o seguinte documento:

{ "info" : "fsyncUnlock completed", "lockCount" : NumberLong(0), "ok" : 1 }

A instância mongod está desbloqueada para gravações.