Definición
db.fsyncUnlock()Reduce el recuento de bloqueos en el servidor para habilitar nuevamente las operaciones de escritura.
A partir de MongoDB 6.0.11 (también disponible a partir de 5.0.22) el
db.fsyncLock()Losdb.fsyncUnlock()métodos y se pueden ejecutar en para bloquear y desbloquear un clústermongosfragmentado.Importante
Método mongosh
Esta página documenta un método
mongosh. Esta no es la documentación para los comandos de base de datos ni para los drivers específicos de lenguajes, como Nodo.js.Para el comando de base de datos, consulta el comando
fsyncUnlock.Para los drivers de API de MongoDB, consulte la documentación del driver de MongoDB específica del lenguaje.
Los servidores mantienen un recuento de bloqueos fsync. El
fsyncLock()método incrementa el recuento de bloqueos, mientras que el método lo disminuye. Para desbloquear escriturasfsyncUnlock()fsyncUnlock()en un servidor o clúster, llame al método hasta que el recuento de bloqueos llegue a cero.db.fsyncUnlock()es una operación administrativa. Utilice este método para desbloquear un servidor o clúster después de una copia de seguridad.db.fsyncUnlock()tiene la sintaxis:db.fsyncUnlock() La operación devuelve un documento con los siguientes campos:
infoInformación sobre el estado de la operación.
lockCountLa cantidad de bloqueos que quedan en la instancia después de la operación.
okEl código de estado.
El método
db.fsyncUnlock()envuelve el comandofsyncUnlock.
Compatibilidad
Este método está disponible en implementaciones alojadas en los siguientes entornos:
Importante
Este comando no es compatible con los clústeres de MongoDB Atlas. Para obtener información sobre el soporte de Atlas para todos los comandos, consulta Comandos no compatibles.
MongoDB Enterprise: La versión basada en suscripción y autogestionada de MongoDB
MongoDB Community: La versión de MongoDB con código fuente disponible, de uso gratuito y autogestionada.
Compatibilidad con WiredTiger
db.fsyncLock() garantiza que los archivos de datos se puedan copiar de forma segura mediante utilidades de copia de seguridad de bajo nivel cp como, scp taro. Un que empieza a usar los archivos copiados contiene datos escritos por el usuario que son indistinguibles de los datos escritos por el usuario en mongod el mongod bloqueado.
Los archivos de datos de un bloqueado mongod pueden cambiar debido a operaciones como sincronizaciones de registro o instantáneas de WiredTiger. Si bien esto no afecta a los datos lógicos (por ejemplo, a los datos a los que acceden los clientes), algunas utilidades de copia de seguridad pueden detectar estos cambios y emitir advertencias o errores. Para obtener más información sobre las utilidades y procedimientos de copia de seguridad recomendados por MongoDB, consulte Métodos de copia de seguridad para una implementación autogestionada.
Ejemplo
Consideremos una situación en la que se ha emitido db.fsyncLock() dos veces. La siguiente operación reduce db.fsyncUnlock() db.fsyncLock() los 1 bloqueos tomados por en:
db.fsyncUnlock()
La operación devuelve el siguiente documento:
{ "info" : "fsyncUnlock completed", "lockCount" : Long(1), "ok" : 1 }
Como lockCount es mayor 0 que, la instancia queda bloqueada contra mongod db.fsyncLock() escrituras. Para desbloquear la instancia, ejecute de nuevo:
db.fsyncUnlock()
La operación devuelve el siguiente documento:
{ "info" : "fsyncUnlock completed", "lockCount" : Long(0), "ok" : 1 }
La instancia está desbloqueada para mongod escrituras.