db.fsyncUnlock()
Nesta página
Definição
db.fsyncUnlock()
Reduz a contagem de bloqueios no servidor para reativar as operações de gravação.
A partir do MongoDB 6.0.11 (também disponível a partir de 5.0.22) os métodos
db.fsyncLock()
edb.fsyncUnlock()
podem ser executados emmongos
para bloquear 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 travas do fsync. O método
fsyncLock()
aumenta a contagem de bloqueios, e o métodofsyncUnlock()
a diminui. Para destravar escritas em um servidor ou cluster, chame o métodofsyncUnlock()
até que a contagem de bloqueios 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 backupdb.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
(Novidade na versão 3.4)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 comandofsyncUnlock
.
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 diário ou snapshots do WiredTiger. Embora isso não afete os dados lógicos (por exemplo, dados acessados por clientes), alguns utilitários de backup podem detectar essas alterações e emitir avisos ou falhar com os erros. Para obter mais informações sobre os procedimentos e utilidades de backup recomendados pelo MongoDB, 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.