Definición
replSetResizeOplogreplSetResizeOplogTambién admite la especificación del número mínimo de horas para conservar una entrada de registro de operaciones.Cambiado en la 5.0 versión: Para establecer el
replSetOplogtamaño enmongosh, utilice elDouble()constructor.replSetResizeOplogle permite cambiar el tamaño del registro de operaciones o su período mínimo de retención de forma dinámica sin reiniciar el sistema.mongodproceso.Debe ejecutar este comando contra la base de datos
admin.
Compatibilidad
Este comando 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.
Nota
Para cambiar el tamaño del registro de operaciones en Atlas, consulte Establecer ventana mínima de registro de operaciones.
Sintaxis
El comando tiene la siguiente forma:
db.adminCommand( { replSetResizeOplog: <int>, size: <double>, minRetentionHours: <double> } )
Campos de comandos
El comando toma los siguientes campos:
Campo | Tipo | Descripción |
|---|---|---|
| Int | Se debe establecer en |
| doble | El tamaño máximo del oplog en megabytes.
|
| doble | Opcional. El número mínimo de horas que se conserva una entrada del registro de operaciones, donde los valores decimales representan fracciones de hora. Por ejemplo, un valor de El valor debe ser mayor o igual a Un configurado
Para verificar el período mínimo de retención de oplog configurado actualmente, consulte en |
Comportamiento
Puede utilizar replSetResizeOplog en instancias que mongod se ejecuten con el motor de almacenamiento Wired Tiger o el motor de almacenamiento en memoria.
Consulte el tutorial Cambiar el tamaño del registro de operaciones de los miembros del conjunto de réplicas autoadministradas para obtener un procedimiento sobre el uso replSetResizeOplog del comando para cambiar el tamaño del registro de operaciones.
El oplog puede crecer más allá de su límite de tamaño configurado para evitar borrar el majority commit point.
No se puede eliminar la local.oplog.rs colección. Para obtener más información sobre esta restricción, consulte Comportamiento de la colección de registros de operaciones.
replSetResizeOplog anula el tamaño máximo del registro de operaciones o el período mínimo de retención del registro de operaciones establecido al inicio mediante:
storage.oplogMinRetentionHours/--oplogMinRetentionHoursrespectivamente.
El nuevo tamaño del registro de operaciones persiste después de reiniciar el servidor, a menos que utilice:
Importante
Al reducir el tamaño máximo del oplog se truncan las entradas del oplog más antiguas hasta que el oplog alcanza el nuevo tamaño configurado.
De manera similar, reducir el período mínimo de retención del oplog da como resultado el truncamiento de las entradas del oplog más antiguas que el período especificado si el oplog ha excedido el tamaño máximo configurado.
El truncamiento del oplog debido a un tamaño reducido del oplog o del período de retención puede generar un comportamiento inesperado en los clientes que aún leen esas entradas del oplog, entre ellos:
Los flujos de cambio abiertos pueden quedar invalidados
Es posible que los secundarios que no hayan replicado esas entradas del registro de operaciones requieran resincronización.
Es posible que las copias de seguridad que utilizan
mongodumpcon contra el miembro no capturen entradas anteriores al truncamiento.--oplog
Período mínimo de retención del oplog
Un tiene el siguiente comportamiento cuando se configura con un período mínimo de retención de registro de mongod operaciones:
El oplog puede crecer sin restricciones para retener las entradas del oplog durante el número de horas configurado. Esto puede resultar en la reducción o el agotamiento del espacio en disco del sistema debido a una combinación de un alto volumen de guardado y un largo período de retención.
Si el registro de operaciones supera su tamaño máximo,
mongodpuede seguir manteniendo ese espacio en disco incluso si el registro de operaciones vuelve a su tamaño máximo o está configurado para un tamaño máximo menor. Consulte "Reducir el tamaño del registro de operaciones no devuelve inmediatamente el espacio en disco".El
mongodcompara el reloj de pared del sistema con el tiempo de creación del reloj de pared de una entrada de oplog al aplicar la retención de entradas de oplog. La deriva de reloj entre los componentes del clúster puede dar lugar a un comportamiento inesperado de retención de oplog. Consulta la sincronización del reloj para obtener más información sobre esta sincronización entre los miembros del clúster.
replSetResizeOplog No se replica a otros miembros
Cambiar el tamaño del registro de operaciones o el periodo mínimo de retención de un miembro del conjunto de réplicas con replSetResizeOplog no modifica el tamaño del registro de operaciones de ningún otro miembro del conjunto de réplicas. Debe ejecutar replSetResizeOplog en cada miembro del conjunto de réplicas del clúster para cambiar el tamaño del registro de operaciones o el periodo mínimo de retención de todos los miembros.
Reducir el tamaño del registro de operaciones no devuelve inmediatamente el espacio en disco
Reducir el tamaño del registro de operaciones no recupera inmediatamente ese espacio en disco. Esto incluye la reducción del tamaño del registro de operaciones debido al truncamiento de eventos de registro de operaciones anteriores al período mínimo de retención.
Para liberar inmediatamente espacio en disco no utilizado tras reducir el tamaño del registro de operaciones,compact ejecute oplog.rs en la colección de la local base de datos durante un periodo de mantenimiento. compact bloquea todas las operaciones en la base de datos en la que se ejecuta. Por lo tanto, ejecutar compact en oplog.rs impide la sincronización del registro de operaciones. Para obtener información sobre cómo redimensionar el registro de operaciones y compactar,oplog.rs consulte Cambiar el tamaño del registro de operaciones de los miembros del conjunto de réplicas autogestionadas.
Bloqueo de recursos
replSetResizeOplog toma un bloqueo exclusivo (W) en y bloquea otras operaciones en la colección hasta que oplog finalice.
Para obtener más información sobre el bloqueo en MongoDB, consulte Preguntas frecuentes: Concurrencia.
Ejemplos
Cambiar el tamaño máximo del registro de operaciones
Utilice el método para mostrar el tamaño máximo actual del registro db.collection.stats() mongosh demaxSize operaciones,, en megabytes. Por ejemplo:
db.getSiblingDB("local").oplog.rs.stats(1024*1024).maxSize
El comando anterior devuelve el tamaño de registro de operaciones de este nodo en megabytes:
990
El siguiente comando utiliza replSetResizeOplog para cambiar el tamaño del registro de operaciones de este miembro a 16384 megabytes:
db.adminCommand({ "replSetResizeOplog": 1, size: Double(16384)})
Para verificar el nuevo tamaño de oplog, vuelva a ejecutar el método db.collection.stats():
db.getSiblingDB("local").oplog.rs.stats(1024*1024).maxSize
El comando anterior devuelve:
"maxSize": Long("16834")
Advertencia
Al reducir el tamaño del registro de operaciones de un nodo, se eliminan datos del mismo. Esto puede provocar que los miembros de la réplica que se sincronizan con ese nodo queden obsoletos. Para resincronizar esos miembros, consulte Resincronizar un miembro de un conjunto de réplicas autoadministradas.
Cambiar el período mínimo de retención de oplog
Opcional. Use el comando para verificar el valor mínimo actual de retención de registros de
db.serverStatus()operacionesoplogTruncation.oplogMinRetentionHourscomo:db.getSiblingDB("admin").serverStatus().oplogTruncation.oplogMinRetentionHours El comando devuelve el periodo mínimo de retención del registro de operaciones configurado actualmente para. Por
mongodejemplo:1.5 Si no tiene un período mínimo de retención de oplog, la operación devuelve un resultado
mongodvacío.Utilice el comando
replSetResizeOplogpara modificar el periodo mínimo de retención de registros de operaciones configurado. Por ejemplo, el siguiente comando establece el periodo mínimo de retención de registros de operaciones en2horas:db.adminCommand({ "replSetResizeOplog" : 1, "minRetentionHours" : 2 })