/ /

Comandos de base de datos

Replicación

Docs Home

Desarrollo

Comandos de base de datos

Replicación

replSetGetConfig (comando de base de datos)

Definición

replSetGetConfig: Devuelve un documento que describe el estatus actual configuración del set de réplicas.
Tip
En mongosh, este comando también puede ejecutarse a través del método asistente rs.conf().
Los métodos asistente son convenientes para usuarios de mongosh, pero es posible que no proporcionen el mismo nivel de información que los comandos de base de datos. En los casos en que no se necesite la conveniencia o se requieran campos de retorno adicionales, utiliza el comando de base de datos.

Compatibilidad

Este comando está disponible en implementaciones alojadas en los siguientes entornos:

MongoDB Atlas: El servicio totalmente gestionado para implementaciones de MongoDB en la nube

Importante

Este comando no es compatible con los clústeres M0 y Flex. Para obtener más información, 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.

Sintaxis

Para ejecutarse, replSetGetConfig debe emitirse contra la base de datos admin. El comando tiene la siguiente sintaxis:

db.adminCommand(
   {
     replSetGetConfig: 1,
     commitmentStatus: <boolean>,
     comment: <any>
   }
)

Campos de comandos

Campo	Tipo	Descripción
`replSetGetConfig`	any	Cualquier valor
commitmentStatus	booleano	opcional. Especifica `true` para incluir un campo commitmentStatus en la salida. El campo de salida commitmentStatus indica si la reconfiguración anterior del set de réplicas ha sido confirmada, de modo que el set de réplicas está listo para ser reconfigurado nuevamente. Para obtener más detalles, consulte Campo de salida commitmentStatus. Solo puede especificar la opción `commitmentStatus: true` al ejecutar el comando en el nodo primario. El comando genera errores si se ejecuta con `commitmentStatus: true` en un nodo secundario.
`comment`	any	Opcional. Un comentario proporcionado por el usuario para adjuntar a este comando. Una vez configurado, este comentario aparece junto a los registros de este comando en las siguientes ubicaciones: Mensajes de registro de mongod, en el campo `attr.command.cursor.comment`. Salida del perfilador de base de datos, en el campo `command.comment`. `currentOp` de salida, en el campo `command.comment`. Un comentario puede ser de cualquier tipo BSON válido (string, objeto, arreglo, etc.).

mongosh proporciona el método rs.conf() que envuelve el comando replSetGetConfig:

rs.conf();

Ejemplo de salida

El siguiente es un ejemplo de salida de la ejecución del comando replSetGetConfig con commitmentStatus: true en el primario:

{
   "config" : {
      "_id" : "myRepl",
      "version" : 180294,
      "term" : 1,
      "protocolVersion" : Long(1),
      "writeConcernMajorityJournalDefault" : true,
      "members" : [
         {
            "_id" : 0,
            "host" : "m1.example.net:27017",
            "arbiterOnly" : false,
            "buildIndexes" : true,
            "hidden" : false,
            "priority" : 1,
            "tags" : {
            },
            "secondaryDelaySecs" : Long(0),
            "votes" : 1
         },
         {
            "_id" : 1,
            "host" : "m2.example.net:27017",
            "arbiterOnly" : false,
            "buildIndexes" : true,
            "hidden" : false,
            "priority" : 1,
            "tags" : {
            },
            "secondaryDelaySecs" : Long(0),
            "votes" : 1
         },
         {
            "_id" : 2,
            "host" : "m3.example.net:27017",
            "arbiterOnly" : false,
            "buildIndexes" : true,
            "hidden" : false,
            "priority" : 1,
            "tags" : {
            },
            "secondaryDelaySecs" : Long(0),
            "votes" : 1
         }
      ],
      "settings" : {
         "chainingAllowed" : true,
         "heartbeatIntervalMillis" : 2000,
         "heartbeatTimeoutSecs" : 10,
         "electionTimeoutMillis" : 10000,
         "catchUpTimeoutMillis" : -1,
         "catchUpTakeoverDelayMillis" : 30000,
         "getLastErrorModes" : {
         },
         "getLastErrorDefaults" : {
            "w" : 1,
            "wtimeout" : 0
         },
         "replicaSetId" : ObjectId("5eaa1e9ac4d650aa7817623d")
      }
   },
   "commitmentStatus" : true,
   "ok" : 1,
   "$clusterTime" : {
      "clusterTime" : Timestamp(1588212091, 1),
      "signature" : {
         "hash" : BinData(0,"veOHa2mOeRTzuR0LKqnzGxWV77k="),
         "keyId" : Long("6821298283919441923")
      }
   },
   "operationTime" : Timestamp(1588212091, 1)
}

Campo	Descripción
`config`	La configuración del set de réplicas. Para la descripción de cada configuración, consulte Configuración de set de réplicas autogestionadas.
commitmentStatus	Un booleano que indica si la configuración más reciente del set de réplicas ha sido confirmada; es decir. La configuración de set de réplicas más reciente para el primario se ha propagado a la mayoría de los nodos, y La última operación de guardado en el set de réplicas con la configuración anterior ha sido `majority-committed` en la nueva configuración. Si `true`, entonces la configuración ha sido confirmada y el set de réplicas puede ser reconfigurado. Para reconfigurar el set de réplicas, ve el comando `replSetReconfig` o el método `mongosh` `rs.reconfig()`. Si `false`, entonces la configuración no se ha guardado, y el set de réplicas no puede ser reconfigurado.
`ok`	Un número que indica si la orden fue exitosa (`1`) o falló (`0`).
`operationTime` `$clusterTime`	Devuelto con cada comando para un set de réplicas. Consulta db.adminCommand Response para más detalles.

Tip

Volver

replSetFreeze

replSetGetStatus