db.fsyncUnlock() (método mongosh)

Definição

db.fsyncUnlock()

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

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

Importante

Método mongosh

This page documents a mongosh method. This is not the documentation for database commands or language-specific drivers, such as 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.

Servers maintain an fsync lock count. The fsyncLock() method increments the lock count while the fsyncUnlock() method decrements it. To unlock writes on a server or cluster, call the fsyncUnlock() method until the lock count reaches zero.

db.fsyncUnlock() is an administrative operation. Use this method to unlock a server or cluster after a backup operation

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.

The db.fsyncUnlock() method wraps the fsyncUnlock command.

Compatibilidade

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

Importante

Este comando não é aceito em clusters do MongoDB Atlas. Para obter informações sobre o suporte do Atlas a todos os comandos, consulte Comandos não suportados.

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 sobre os 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 quedb.fsyncLock()foi emitido duas vezes. A seguinte operação dodb.fsyncUnlock()reduz as travas feitas pelodb.fsyncLock()pelo 1:

db.fsyncUnlock()

A operação retorna o seguinte documento:

{ "info" : "fsyncUnlock completed", "lockCount" : Long(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" : Long(0), "ok" : 1 }

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

Voltar

db.fsyncLock

db.getCollection