db.adminCommand()

Esta versión de la documentación está archivada y ya no recibe soporte. Para actualizar su implementación 5.0, consulte Procedimientos de actualización de MongoDB.6.0

Importante

Método mongosh

Este es un Método mongosh. Esta no es la documentación para Node.js ni para otros métodos de controlador específicos del lenguaje de programación.

En la mayoría de los casos, los métodos funcionan de la misma manera que losmongosh heredados. mongo Métodos de shell. Sin embargo, algunos métodos heredados no están disponibles mongosh en.

Para obtener la documentación del shell heredado, consulte la documentación de la versión correspondiente de MongoDB mongo Server:

Para los controladores de la API de MongoDB, consultar la documentación específica del controlador de MongoDB para cada lenguaje.

Definición

db.adminCommand(command)

Proporciona un ayudante para ejecutar comandos de base de datos específicos contra la admin base de datos.

Parameter	Tipo	Descripción
`command`	documento o cadena	Un comando de base de datos, especificado en formato de documento o como cadena. Si se especifica como cadena, el comando no puede incluir argumentos.

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

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.

Comportamiento

db.adminCommand() ejecuta comandos en la admin base de datos, independientemente del contexto de la base de datos en la que se ejecute. Los siguientes comandos son equivalentes:

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

Para obtener una lista de los comandos de base de datos administrativa disponibles, consulte Comandos de administración.

Nota

Para un mongod o que mongos authorization se ejecuta con, el usuario autorizado debe tener los privilegios adecuados para ejecutar el comando de 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 resultado específicos del `command` que se ejecutó.
`ok`	Un número que indica si el comando tuvo éxito (`1`) o falló (`0`).
`operationTime`	La hora lógica de la operación realizada, representada en MongoDB por la marca de tiempo de la entrada del registro de operaciones. Solo para conjuntos de réplicas y clústeres fragmentados. Si el comando no genera una entrada en el registro de operaciones (por ejemplo, una operación de lectura), la operación no avanza el reloj lógico. En este caso, `operationTime` devuelve: Para las preocupaciones de `"local"` lectura, y, la marca de tiempo de la`"snapshot"` entrada más reciente en el registro de operaciones.`"linearizable"` Para la preocupación de lectura, la marca `"majority"` `majority-acknowledged` de tiempo de la entrada más reciente en el registro de operaciones. Para las operaciones asociadas con sesiones causalmente consistentes, los controladores de MongoDB utilizan el tiempo lógico para establecer automáticamente las operaciones de lectura y el período.`afterClusterTime` Nuevo en la versión 3.6.
`$clusterTime`	Un documento que devuelve la hora firmada del clúster. La hora del clúster es una hora lógica que se utiliza para ordenar las operaciones. Solo para conjuntos de réplicas y clústeres fragmentados. Solo para uso interno. El documento contiene los siguientes campos: `clusterTime`: marca de tiempo del tiempo de clúster más alto conocido para el miembro. `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. Nuevo en la versión 3.6.

Ejemplos

killOp

El siguiente ejemplo utiliza el métododb.adminCommand()para ejecutar un comandokillOppara finalizar una operación con opid 724. killOpes un comando administrativo y debe ejecutarse contra la base de datos admin.

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

renameCollection

El siguiente ejemplo utilizadb.adminCommand()para ejecutar el comando de base de datos administrativarenameCollectionpara cambiar el nombre de la colección orders en la base de datos test a orders-2016.

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

createUser

El siguiente ejemplo utiliza el método para crear un usuario db.adminCommand() llamado bruce con el rol en dbOwner la admin base de datos.

Tip

Puede usar el método junto con varios métodos o comandos de autenticación/gestión de usuarios para solicitar la contraseña en lugar de passwordPrompt() mongo especificarla directamente en la llamada al método/comando. Sin embargo, puede especificarla directamente como lo hacía con versiones anteriores del shell.

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

Volver

Databases

db.aggregate