db.adminCommand() (método mongosh)

Importante

Método mongosh

This page documents a mongosh method. This is not the documentation for a language-specific driver, such as Node.js.

Para los drivers de API de MongoDB, consulte la documentación del driver de MongoDB específica del lenguaje.

Definición

db.adminCommand(command)

Ofrece un asistente para ejecutar comandos de base de datos especificados contra la base de datos admin.

Parameter	Tipo	Descripción
`command`	Documento o string	Un comando de base de datos, especificado ya sea en forma de documento o como una string. Si se especifica como una string, el comando no puede incluir ningún argumento.

Compatibilidad

Este método está disponible en implementaciones alojadas en los siguientes entornos:

MongoDB Atlas: El servicio totalmente gestionado para implementaciones de MongoDB en la nube

Nota

This command is supported in all MongoDB Atlas clusters. For information on Atlas support for all commands, see Unsupported Commands.

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.

Comportamiento

db.adminCommand() runs commands against the admin database regardless of the database context in which it runs. The following commands are equivalent:

db.getSiblingDB("admin").runCommand(<command>)
db.adminCommand(<command>)

Para obtener una lista de los comandos de base de datos administrativos disponibles, consulte Comandos de base de datos.

Nota

Para un mongod o mongos que se ejecute con authorization, el usuario autorizado debe contar con los privilegios apropiados para ejecutar el comando de la base de datos. Consulte la documentación de referencia del comando para obtener más información sobre los requisitos de seguridad.

Respuesta

El método 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 nivel de consistencia de lectura `"local"`, `"snapshot"` y `"linearizable"`, la marca de tiempo de la entrada más reciente en el oplog. Para el nivel de consistencia de lectura `"majority"`, la marca de tiempo de la `majority-acknowledged` entrada más reciente en el oplog. 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.

Ejemplos

killOp

The following example uses the db.adminCommand() method to execute a killOp command to terminate an operation with opid 724. killOp is an administrative command and must be run against the admin database.

db.adminCommand( { "killOp": 1, "op": 724 } )

renameCollection

The following example uses db.adminCommand() to execute the renameCollection administrative database command to rename the orders collection in the test database to orders-2016.

db.adminCommand(
  {
     renameCollection: "test.orders",
     to: "test.orders-2016"
  }
)

createUser

The following example uses the db.adminCommand() method to create a user named bruce with the dbOwner role on the admin database.

Tip

Puedes usar el método passwordPrompt() en conjunto con varios métodos y comandos de gestión de autenticación de usuarios para solicitar la contraseña en lugar de especificar la contraseña directamente en la llamada al método o comando. Sin embargo, aún puedes especificar la contraseña directamente como lo harías con las versiones anteriores del shell mongo.

db.adminCommand(
  {
    createUser: "bruce",
    pwd: passwordPrompt(),  // or <cleartext password>
    roles: [
      { role: "dbOwner", db: "admin" }
    ]
  }
)

Volver

cursor.tryNext

db.aggregate