Para agentes de IA: hay un índice de documentación disponible en https://www.mongodb.com/es/docs/llms.txt — versiones en markdown de todas las páginas están disponibles agregando .md a cualquier ruta URL.
Docs Menu

Utilizar comandos de base de datos

La interfaz de comando de MongoDB ofrece acceso a todas las operaciones no CRUD de la base de datos. Obtener estadísticas del servidor, inicializar un set de réplicas y ejecutar una pipeline de agregación o una tarea de Map-Reduce se logran mediante comandos.

Ver Comandos de base de datos para ver la lista de todos los comandos ordenados por función.

Primero especificas un comando construyendo un documento BSON estándar cuya primera clave es el nombre del comando. Por ejemplo, especifica el comando hello usando el siguiente documento BSON:

{ hello: 1 }

mongosh proporciona un método asistente para ejecutar comandos llamados db.runCommand(). La siguiente operación en mongosh ejecuta el comando anterior:

db.runCommand( { hello: 1 } )

Muchos Controladores proporcionan un equivalente para el db.runCommand() método. Internamente, ejecutar comandos con db.runCommand() es equivalente a una query especial sobre la colección $cmd.

Muchos comandos habituales tienen sus propios asistentes de shell o contenedores en mongosh y controladores, como el método db.hello() en mongosh.

Puede usar la opción maxTimeMS para especificar un límite de tiempo para la ejecución de un comando, consulte Terminar un Comando para obtener más información sobre la finalización de la operación.

Debe ejecutar algunos comandos en la base de datos admin. Normalmente, esas operaciones se parecen a las siguientes:

use admin
db.runCommand( {buildInfo: 1} )

Sin embargo, también existe un asistente de comandos que ejecuta automáticamente el comando en el contexto de la admin base de datos:

db.adminCommand( {buildInfo: 1} )

Para todos los comandos, MongoDB devuelve un documento de respuesta que contiene los siguientes campos:

Campo
Descripción

<command result>

Campos de resultados específicos para el/la command que se ejecutó.

ok

Un número que indica si el comando se ejecutó correctamente (1) o no (0).

operationTime

El tiempo lógico de la operación. MongoDB utiliza el tiempo lógico para ordenar las operaciones. Solo para sets de réplicas y clústeres.

Si el comando no genera una entrada de oplog, por ejemplo, una operación de lectura, la operación no avanza el reloj lógico. En este caso, operationTime devuelve:

Para las operaciones asociadas con sesiones causalmente coherentes, los drivers de MongoDB utilizan el tiempo lógico para establecer automáticamente el período de Operaciones de lectura y afterClusterTime.

$clusterTime

Un documento que devuelve el tiempo de clúster firmado. El tiempo de clúster es un tiempo lógico utilizado para el ordenamiento de las operaciones. Sólo para sets de réplicas y clústeres fragmentados. Sólo para uso interno.

El documento contiene los siguientes campos:

  • clusterTime: marca de tiempo del tiempo de clúster más alto conocido para el nodo.

  • signature: un documento que contiene el hash del tiempo del clúster y el id de la clave utilizada para firmar el tiempo del clúster.