rs.stepDown() (método mongosh)

Descripción

rs.stepDown(stepDownSecs, secondaryCatchUpPeriodSecs)

Indica al primario del set de réplicas que pase a ser un secundario. Después de que el primario renuncie, los secundarios elegibles llevan a cabo una elección para primario.

El método no reduce inmediatamente la primaria. Si ningún electable secundario está al día con el primario, el primario espera hasta secondaryCatchUpPeriodSecs (por defecto 10 segundos) para que un secundario se ponga al día. Una vez que se dispone de una secundaria elegible, el método de descenso se realiza en la primaria.

Una vez replegado, el primario original se convierte en secundario y no es elegible para volver a ser primario durante el resto del tiempo especificado por stepDownSecs.

Para una explicación detallada de la ejecución del método, consulte Comportamiento.

Nota

El método solo es válido para el primario y arroja un error si se ejecuta en un miembro que no es primario.

Importante

Método mongosh

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

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

Para los drivers de API de MongoDB, consulte la documentación del driver de MongoDB específica del lenguaje.

El método tiene los siguientes rs.stepDown() parámetros:

Parameter	Tipo	Descripción
`stepDownSecs`	Número	El número de segundos para degradar el primario, durante el cual el nodo degradado no es elegible para convertirse en primario. Si se especifica un valor no numérico, la comando utiliza `60` segundos. El periodo de reducción de potencia comienza en el momento en que el `mongod` recibe la orden. El período Secuencia posterior debe ser superior an el `secondaryCatchUpPeriodSecs`.
`secondaryCatchUpPeriodSecs`	Número	opcional. El número de segundos que `mongod` esperará a que un secundario elegible se ponga al nivel del primario. Cuando se especifica, `secondaryCatchUpPeriodSecs` anula el tiempo de espera por defecto de `10` segundos.

Compatibilidad

Este método está disponible en implementaciones alojadas en los siguientes entornos:

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

Operaciones Concurrentes

El rs.stepDown() método intenta terminar las operaciones de usuario de larga duración que impiden que el proceso principal pase a un segundo plano, como la creación de un índice, una operación de escritura o un trabajo de map-reduce.

Disponibilidad de secundarios elegibles

El método entonces inicia un período de actualización en el que espera hasta secondaryCatchUpPeriodSeconds, por defecto 10 segundos, para que un secundario se ponga al día con el primario. El primario solo se baja si un secundario está actualizado con el primario durante el período de puesta al día para evitar reversiones.

Si ningún secundario elegible cumple con este criterio al final del periodo de espera, el primario no cede y el método produce un error.

Una vez que el nodo primario se retira con éxito, ese nodo no puede convertirse en el primario durante el resto del período stepDownSecs, que comenzó cuando el nodo recibió el método.

Conexiones del cliente

rs.stepDown() el método no cierra todas las conexiones de clientes.

Escribe durante la reducción

Nota

Todas las escrituras en el primario fallan durante el período que comienza cuando rs.stepDown() se recibe el método hasta que se elige un nuevo primario o, si no hay secundarios elegibles, el primario original reanuda su funcionamiento normal.

Las escrituras que estaban en curso cuando rs.stepDown() se ejecuta se cancelan. Las transacciones en curso también fallan con y se pueden volver a TransientTransactionError intentar en su totalidad.

El período en el que fallan los guardados es, como máximo:

secondaryCatchUpPeriodSecs (10s por defecto) + electionTimeoutMillis (10s por defecto).

Entrega de elecciones

Cuando se reduce una primaria usando rs.stepDown() o sin establecer replSetStepDown el force campo true en, la primaria reducida nomina a una secundaria elegible para convocar una elección de inmediato.

Volver

rs.status

rs.syncFrom