/ /

Replicación

Docs Home

Desarrollo

Comandos de base de datos

Replicación

Docs Home

Desarrollo

Comandos de base de datos

Replicación

hola (comando de base de datos)

Definición

hello

Nuevo en la versión 5.0.

hello devuelve un documento que describe el rol del mongod Instancia. Si saslSupportedMechs se especifica el campo opcional, el comando también devuelve un utilizado para crear las credenciales del usuario array of SASL mechanisms especificado.

Si la instancia es miembro de un conjunto de réplicas, entonces hello devuelve un subconjunto de la configuración y el estado del conjunto de réplicas, incluido si la instancia es o no la principal del conjunto de réplicas.

Cuando se envía a una mongod instancia que no es miembro de un conjunto de réplicas, devuelve un subconjunto de estahello información.

MongoDB drivers y clientes usan hello para determinar el estado de los miembros del set de réplicas y descubrir otros miembros de un set de réplicas.

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

Nota

Este comando es compatible con todos los clústeres de MongoDB Atlas. Para obtener información sobre el soporte de Atlas para todos los comandos, consulte 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

El comando tiene la siguiente sintaxis:

db.runCommand(
   {
     hello: 1
   }
)

El comando acepta los campos hello opcionales saslSupportedMechs: <db.user> para devolver un campo adicional en su resultado hello.saslSupportedMechs y comment <any> para agregar un comentario de registro asociado con el comando.

db.runCommand(
   {
     hello: 1,
     saslSupportedMechs: "<db.username>",
     comment: <any>
   }
)

El db.hello() método en proporciona una envoltura mongosh alrededor hello de.

Comportamiento

Desconexión del cliente

Si el cliente que emitió hello se desconecta antes de que la operación se complete, MongoDB marca hello para su terminación usando killOp.

Salida

Todas las instancias

Los siguientes campos son comunes a todos los hello roles:

hello.isWritablePrimary

Un valor booleano que indica cuándo se puede escribir en este nodo. Si true es, esta instancia es principal en un conjunto de réplicas, una mongos instancia o una instancia mongod independiente.

Este campo será false si la instancia es un miembro secundario de un conjunto de réplicas o si el miembro es un árbitro de un conjunto de réplicas.

hello.topologyVersion: Para uso interno de MongoDB.

hello.maxBsonObjectSize: El tamaño máximo permitido de un objeto BSON en bytes para este proceso. Si no se proporciona, los clientes deben asumir un tamaño máximo de mongod "16 * 1024 * 1024".

hello.maxMessageSizeBytes: El tamaño máximo permitido de un mensaje del protocolo de conexión BSON. El valor por defecto es 48000000 bytes.

hello.maxWriteBatchSize

El número máximo de operaciones de escritura permitidas en un lote de escritura. Si un lote supera este límite, el controlador del cliente lo divide en grupos más pequeños, cada uno con recuentos menores o iguales al valor de este campo.

El valor de este límite es 100,000 escrituras.

hello.localTime: Devuelve la hora del servidor local en UTC. Este valor es una fecha ISO.

hello.logicalSessionTimeoutMinutes

El tiempo en minutos que una sesión permanece activa después de su uso más reciente. Las sesiones que no hayan recibido una nueva operación de lectura/guardado del cliente o que no se hayan actualizado con refreshSessions dentro de este umbral se eliminan de la caché. El servidor puede limpiar el estado asociado a una sesión caducada en cualquier momento.

Sólo disponible cuando featureCompatibilityVersion es "3.6" o mayor.

hello.connectionId: Un identificador para la conexión saliente mongod de la instancia / mongos al cliente.

hello.minWireVersion

La versión más antigua del protocolo de cable que esta instancia mongod o puede utilizar para comunicarse con los clientes.mongos

Los clientes pueden usar para ayudar a negociar la compatibilidad con minWireVersion MongoDB.

hello.maxWireVersion

La última versión del protocolo de cable que esta instancia mongod o puede utilizar para comunicarse con los mongos clientes.

Los clientes pueden usar para ayudar a negociar la compatibilidad con maxWireVersion MongoDB.

hello.readOnly: Un valor booleano que, cuando true es, indica que mongod o se está ejecutando en modo de solo mongos lectura.

hello.compression

Una matriz que enumera los algoritmos de compresión utilizados o disponibles para su uso (es decir, comunes tanto para el cliente como para la mongod mongos instancia o) para comprimir la comunicación entre el cliente y la instancia mongod mongos o.

El campo solo está disponible si se utiliza compresión. Por ejemplo:

Si el mongod está habilitado para usar ambos compresores snappy,zlib y un cliente ha especificado zlib, el campo compression contendría:
```
"compression": [ "zlib" ]
```
Si el mongod está habilitado para usar ambos compresores snappy,zlib y un cliente ha especificado zlib,snappy, el campo compression contendría:
```
"compression": [ "zlib", "snappy" ]
```
Si el está habilitado para usar mongod el snappy compresor y un cliente ha zlib,snappy especificado, el campo compression contendrá:
```
"compression": [ "snappy" ]
```
Si el está habilitado para usar mongod el snappy compresor y un cliente ha especificado zlib o el cliente no ha especificado ningún compresor, se omite el campo.

Es decir, si el cliente no especifica compresión o si el cliente especifica un compresor no habilitado para la mongod conectada o la instancia de mongos, el campo no se devuelve.

hello.saslSupportedMechs

Una serie de mecanismos SASL utilizados para crear las credenciales del usuario. Los mecanismos SASL compatibles son:

GSSAPI
SCRAM-SHA-256
SCRAM-SHA-1

El campo se devuelve solo cuando el comando se ejecuta con el campo saslSupportedMechs:

db.runCommand( { hello: 1, saslSupportedMechs: "<db.username>" } )

Instancias fragmentadas

mongos instancias agregan el siguiente campo al hello documento de respuesta:

hello.msg: Contiene el valor isdbgrid cuando regresa hello mongos de una instancia.

Sets de réplicas

hello contiene estos campos cuando lo devuelve un miembro de un conjunto de réplicas:

hello.hosts

Una matriz de cadenas en el formato "[hostname]:[port]" que enumera todos los miembros del conjunto de réplicas que no son ocultos, pasivosni árbitros.

Los controladores utilizan esta matriz y para determinar qué miembros hello.passives leer.

hello.setName: El nombre del conjunto :replica actual.

hello.setVersion: La versión de configuración del conjunto de réplicas actual.

hello.secondary: Un valor booleano que, cuando true es, indica si mongod es un miembro secundario de un conjuntode réplicas.

hello.passives

Una matriz de cadenas en el formato que "[hostname]:[port]" enumera todos los miembros del conjunto de réplicas que tienen un members[n].priority 0de.

Este campo solo aparece si hay al menos un miembro con un members[n].priority 0de.

Los controladores utilizan esta matriz y para determinar qué miembros hello.hosts leer.

hello.arbiters

Un arreglo de cadenas en formato "[hostname]:[port]" que enumera todos los miembros del set de réplicas que son árbitros.

Este campo solo aparece si hay al menos un árbitro en el conjunto de réplicas.

hello.primary: Una cadena en el formato que "[hostname]:[port]" enumera el miembro principal actual del conjunto de réplicas.

hello.arbiterOnly: Un valor booleano que, cuando true es, indica que la instancia actual es un árbitro. El campo solo está presente si la instancia es un arbiterOnly árbitro.

hello.passive: Un valor booleano que, cuando true es, indica que la instancia actual es pasiva. El campo solo está passive members[n].priority presente 0para miembros con un valor de o.

hello.hidden: Un valor booleano que, cuando true es, indica que la instancia actual está oculta. El campo solo está presente para miembros hidden ocultos.

hello.tags

Un documento tags contiene pares de campo de etiqueta y valor definidos por el usuario para el set de réplicas.

{ "<tag1>": "<string1>", "<tag2>": "<string2>",... }

Para las operaciones de lectura, se puede especificar un conjunto de etiquetas en la preferencia de lectura para dirigir las operaciones a los miembros del set de réplicas con las etiquetas especificadas.
Para las operaciones de escritura, puede crear una preocupación de escritura personalizada utilizando settings.getLastErrorModes settings.getLastErrorDefaultsy.

Para obtener más información, consultar Configurar conjuntos de etiquetas del set de réplicas.

Tip

members[n].tags

hello.me: El [hostname]:[port] del miembro que hello devolvió.

hello.electionId: Un identificador único para cada elección. Se incluye solo en la salida de hello para la primaria. Es utilizado por los clientes para determinar cuándo ocurren las elecciones.

hello.lastWrite

Un documento que contiene optime e información de fecha para la operación de guardar más reciente de la base de datos.

hello.lastWrite.opTime: Un objeto que proporciona el tiempo óptimo de la última operación de escritura.

hello.lastWrite.lastWriteDate: Un objeto de fecha que contiene la hora de la última operación de escritura.

hello.lastWrite.majorityOpTime: Un objeto que proporciona el tiempo óptimo de la última operación de escritura legible por majority lecturas.

hello.lastWrite.majorityWriteDate: Un objeto de fecha que contiene la hora de la última operación de escritura legible por majority lecturas.

Para obtener detalles sobre el ok campo de estado, el operationTime campo y el $clusterTime campo, consulte Respuesta del comando.

Volver

aplicarOps

replSetAbortPrimaryCatchUp