/ /

Ejecute un comando de base de datos

Overview

En esta guía, aprenderá a ejecutar un comando de base de datos con el controlador Kotlin Sync. Puede usar comandos de base de datos para realizar diversas tareas administrativas y de diagnóstico, como obtener estadísticas del servidor, inicializar un conjunto de réplicas o ejecutar una canalización de agregación.

Importante

Prefiera los métodos del controlador a los comandos de base de datos

El controlador proporciona métodos de encapsulamiento para numerosos comandos de base de datos. Recomendamos usar métodos de controlador en lugar de ejecutar comandos de base de datos siempre que sea posible.

Para realizar tareas administrativas, utilice el MongoDB Shell en lugar del controlador de sincronización de Kotlin. Llamar al db.runCommand() El método dentro del shell es el método preferido para emitir comandos de base de datos, ya que proporciona una interfaz consistente entre el shell y los controladores.

Ejecutar un comando

Para ejecutar un comando de base de datos, especifique el comando y cualquier parámetro relevante en un documento, luego pase el documento al método runCommand().

El siguiente código muestra cómo puede utilizar el método runCommand() para ejecutar el comando explain, que devuelve una descripción de cómo se ejecutará el comando find si lo llama:

val commandToExplain = Document("find", "restaurants")
val explanation = database.runCommand(Document("explain", commandToExplain))

Para obtener una lista completa de los comandos de base de datos y los parámetros correspondientes, consulte la guía de comandos de base de datos.

Opciones de comando

Puede especificar el comportamiento opcional del comando para el método runCommand() incluyendo un parámetro readPreference. El siguiente ejemplo muestra cómo especificar una preferencia de lectura y pasarla como opción al método runCommand():

val command = Document("hello", 1)
val commandReadPreference = Document("readPreference", "secondary")
val commandResult = database.runCommand(command, commandReadPreference)

Para obtener más información sobre las opciones de preferencia de lectura, consulte Preferencia de lectura en el manual del servidor.

Nota

El método runCommand() ignora la preferencia de lectura que haya definido en su objeto database. Si no se especifica ninguna preferencia de lectura, este método utiliza la preferencia de lectura primary.

Respuesta

El método runCommand() devuelve un objeto Document que contiene la respuesta de la base de datos tras la ejecución del comando. Cada comando de la base de datos realiza una función diferente, por lo que el contenido de la respuesta puede variar según el comando. Sin embargo, cada respuesta contiene documentos con los siguientes campos:

Campo	Descripción
<command result>	Proporciona campos específicos del comando de base de datos. Por ejemplo, `count` devuelve el campo `n` y `explain` el campo `queryPlanner`.
`ok`	Indica si el comando ha tenido éxito (`1`) o ha fallado (`0`).
`operationTime`	Indica el tiempo lógico de la operación. MongoDB utiliza el tiempo lógico para ordenar las operaciones. Para obtener más información sobre el tiempo lógico, consulte nuestra entrada de blog sobre el Reloj Lógico Global.
`$clusterTime`	Proporciona un documento que devuelve la hora de clúster firmada. La hora de clúster es una hora lógica utilizada para ordenar las operaciones. El documento contiene los siguientes campos: `clusterTime`, que es la marca de tiempo del tiempo de clúster más alto conocido para el miembro. `signature`, que es un documento que contiene el hash de la hora del clúster y la ID de la clave utilizada para firmar la hora del clúster.

Ejemplo

El siguiente ejemplo muestra cómo ejecutar el comando buildInfo y el resultado que produce:

import com.mongodb.MongoException
import com.mongodb.kotlin.client.MongoClient
import org.bson.Document
import org.bson.BsonInt64
import org.bson.json.JsonWriterSettings
fun main() {
    // Replace the placeholder with your MongoDB deployment's connection string
    val uri = "<connection string uri>"
    val mongoClient = MongoClient.create(uri)
    val database = mongoClient.getDatabase("sample_mflix")
    try {
        val command = Document("buildInfo", BsonInt64(1))
        val commandResult = database.runCommand(command)
        println(commandResult.toJson(JsonWriterSettings.builder().indent(true).build()))
    } catch (me: MongoException) {
        System.err.println("An error occurred: $me")
    }
    mongoClient.close()
}

{
  version: '8.0.4',
   ...<other command results>...
  ok: 1,
  '$clusterTime': {
      clusterTime: Timestamp({ ... }),
      signature: {
         ...
      }
  },
  operationTime: Timestamp({ ... })
}

Información Adicional

Para más información sobre los conceptos de esta guía, consulta la siguiente documentación:

Volver

Índices de búsqueda vectorial y de búsqueda de MongoDB

MongoDB búsqueda