db.fsyncLock() (método mongosh)

Definición

db.fsyncLock()

Vacía todos los guardados pendientes de la capa de almacenamiento en el disco y bloquea el servidor para evitar cualquier guardado adicional hasta que se libere el bloqueo.

A partir de MongoDB 7.1 (también disponible a partir de 7.0.2, 6.0.11, y 5.0.22) el db.fsyncLock() y Los db.fsyncUnlock() métodos pueden ejecutarse en mongos para bloquear y desbloquear un clúster sharded.

Importante

Método mongosh

Esta página documenta a Método mongosh. Esta no es la documentación de comandos de base de datos ni de controladores específicos del lenguaje, como Node.js.

Para el comando de base de datos, consulta el comando fsync.

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 método fsyncLock() incrementa el conteo de bloqueos, mientras que el método fsyncUnlock() lo decrementa. Para desbloquear guardados en un servidor o clúster, llama al método fsyncUnlock() hasta que el recuento de bloqueos llegue a cero.

db.fsyncLock() tiene la sintaxis:

db.fsyncLock()

La operación devuelve un documento con los siguientes campos:

Campo	Descripción
`info`	Información sobre el estado de la operación.
`lockCount`	Número de bloqueos actualmente en la instancia.
`seeAlso`	Enlace a la documentación del comando `fsync`.
`ok`	El código de estado.

db.fsyncLock() es un comando administrativo. Use este método para bloquear un servidor o clúster antes de realizar copias de seguridad.

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.

Comportamiento

db.fsyncLock() garantiza que los archivos de datos sean seguros de copiar utilizando herramientas de copia de seguridad de bajo nivel como cp, scp o tar. Un mongod iniciado con los archivos copiados contiene datos escritos por el usuario que no se distinguen de los datos escritos por el usuario en el mongod bloqueada.

Los archivos de datos de un mongod bloqueado pueden cambiar debido a operaciones como sincronizaciones de diarios o instantáneas de WiredTiger. Si bien esto no tiene ningún efecto en los datos lógicos (por ejemplo, datos a los que acceden los clientes), algunas utilidades de copia de seguridad pueden detectar estos cambios y emitir advertencias o fallar con 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.

Bloqueos de Fsync tras fallos

Los bloqueos fsync se ejecutan en el primario en un set de réplicas o clúster.

Si el primario se cae o se vuelve inaccesible debido a problemas de red, el clúster elige un nuevo primario de entre los secundarios disponibles. Si un primario con un bloqueo fsync se cae, el nuevo primario no retiene el bloqueo fsync y puede gestionar operaciones de escritura. Cuando se realizan elecciones durante las operaciones de copia de seguridad, la copia de seguridad resultante puede ser inconsistente o inutilizable.

Para recuperarse de la caída de la primaria:

Ejecute el método hasta que el recuento de bloqueos llegue a cero para liberar el bloqueo en todos los db.fsyncUnlock() nodos.
Emita el comando db.fsyncLock() para restablecer el bloqueo fsync en el clúster.
Reiniciar la copia de seguridad.

Además, los bloqueos de fsync son persistentes. Cuando la principal antiguo vuelva a estar en línea, deberás ejecutar el comando db.fsyncUnlock() para liberar el bloqueo del nodo.

Ejemplo

La siguiente operación ejecuta db.fsyncLock():

db.fsyncLock()

La operación devuelve el siguiente documento de estado que incluye el lockCount:

{
   "info" : "now locked against writes, use db.fsyncUnlock() to unlock",
   "lockCount" : Long(1),
   "seeAlso" : "http://dochub.mongodb.org/core/fsynccommand",
   "ok" : 1
}

Si ejecutas db.fsyncLock() de nuevo, la operación incrementa el lockCount:

{
   "info" : "now locked against writes, use db.fsyncUnlock() to unlock",
   "lockCount" : Long(2),
   "seeAlso" : "http://dochub.mongodb.org/core/fsynccommand",
   "ok" : 1
}

Para desbloquear la instancia para guardar, debes ejecutar db.fsyncUnlock() dos veces para reducir el lockCount a 0.

Volver

db.dropDatabase

db.fsyncUnlock