replSetGetConfig (comando de base de datos)

Definición

replSetGetConfig: Devuelve un documento que describe la configuración actual del set de réplicas.
Tip
In mongosh, this command can also be run through the rs.conf() helper method.
Helper methods are convenient for mongosh users, but they may not return the same level of information as database commands. In cases where the convenience is not needed or the additional return fields are required, use the database command.

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 ejecutarlo, se debe emitir contrareplSetGetConfig la admin base de datos. 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	Optional. Specify `true` to include a commitmentStatus field in the output. The commitmentStatus output field indicates whether the replica set's previous reconfig has been committed, so that the replica set is ready to be reconfigured again. For details, see commitmentStatus Output Field. 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 provides the rs.conf() method that wraps the replSetGetConfig command:

rs.conf();

Ejemplo de salida

The following is an example output of the replSetGetConfig command run with commitmentStatus: true on the primary:

{
   "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` la configuración se ha confirmado y el conjunto de réplicas se puede reconfigurar. Para reconfigurar el conjunto de réplicas, consulte el comando o `replSetReconfig` el `mongosh` `rs.reconfig()`método. 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