/ /

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, se debe ejecutar enreplSetGetConfig 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	Opcional. Especifique `true` para incluir un campo "commitmentStatus" en la salida. Este campo indica si la reconfiguración anterior del conjunto de réplicas se ha confirmado, de modo que esté listo para ser reconfigurado de nuevo. Para más información,consulte el campo "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() replSetGetConfig que envuelve el comando:

rs.conf();

Ejemplo de salida

El siguiente es un ejemplo de salida del replSetGetConfig comando ejecutado con commitStatus: true en el servidor principal:

{
   "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 valor booleano que indica si se ha confirmado la configuración del conjunto de réplicas más reciente; 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 es `false`, la configuración no se ha confirmado y el conjunto de réplicas no se puede reconfigurar.
`ok`	Un número que indica si la orden fue exitosa (`1`) o falló (`0`).
`operationTime` `$clusterTime`	Se devuelve con cada comando para un conjunto de réplicas. Consulte la respuesta de db.adminCommand para obtener más información.

Tip

Volver

replSetFreeze

replSetGetStatus