/ /

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 la situación actual. configuración del conjunto de réplicas.
Tip
En mongosh, este comando también se puede ejecutar a través del método rs.conf() auxiliar.
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
estado de compromiso	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 se puede especificar la opción `commitmentStatus: true` al ejecutar el comando en el servidor principal. El comando genera un error si se ejecuta con `commitmentStatus: true` en un servidor 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`	Configuracióndel conjunto de réplicas. Para obtener una descripción de cada opción de configuración, consulte Configuración del conjunto de réplicas autogestionadas.
estado de compromiso	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 del conjunto de réplicas más reciente para la instancia principal se ha propagado a la mayoría de los miembros y La última operación de escritura en el conjunto de réplicas con la configuración anterior fue `majority-commited` en la nueva configuración. Si `true` es, la configuración se ha confirmado y el conjunto de réplicas puede reconfigurarse. Para reconfigurar el conjunto de réplicas, consulte el comando o `replSetReconfig` el `mongosh` `rs.reconfig()`método. 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 el comando tuvo éxito (`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