Ejecute un comando de base de datos

Overview

En esta guía, aprenderá a usar el controlador .NET/C# para ejecutar un comando de base de datos. 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.

Ejecutar un comando

Para ejecutar un comando de base de datos, cree un objeto BsonDocument que especifique el comando y páselo como parámetro al método RunCommand() o RunCommandAsync(). Puede especificar el tipo que devuelven estos métodos especificando el parámetro de tipo. Puede usar el tipo BsonDocument para devolver la respuesta del comando o especificar su propia clase fuertemente tipada para deserializar la respuesta del comando.

El siguiente ejemplo ejecuta el comando hello en una base de datos, que devuelve información sobre el servidor. Seleccione el Asynchronous o la pestaña Synchronous para ver el código correspondiente.

var command = new BsonDocument("hello", 1);
var result = await database.RunCommandAsync<BsonDocument>(command);

var command = new BsonDocument("hello", 1);
var result = database.RunCommand<BsonDocument>(command);

Establecer una preferencia de lectura

El método RunCommand() no hereda la preferencia de lectura que podría haber configurado en su instancia MongoDatabase. De forma predeterminada, RunCommand() utiliza la preferencia de lectura primary.

Puede establecer una preferencia de lectura para la ejecución del comando pasando una instancia ReadPreference como parámetro a RunCommand(), como se muestra en el siguiente ejemplo. Seleccione la pestaña Asynchronous o Synchronous para ver el código correspondiente.

var command = new BsonDocument("hello", 1);
var result = await database.RunCommandAsync<BsonDocument>(command, ReadPreference.Secondary);

var command = new BsonDocument("hello", 1);
var result = database.RunCommand<BsonDocument>(command, ReadPreference.Secondary);

Respuesta

El documento de respuesta del comando sin procesar devuelto por el método RunCommand() contiene los siguientes campos:

var command = new BsonDocument("dbStats", 1);
var result = await database.RunCommandAsync<BsonDocument>(command);
Console.WriteLine(result.ToJson());

var command = new BsonDocument("dbStats", 1);
var result = database.RunCommand<BsonDocument>(command);
Console.WriteLine(result.ToJson());

{ "db" : "sample_restaurants", "collections" : 2, "views" : 0, "objects" :
NumberLong(25438), "avgObjSize" : 548.95172576460413, "dataSize" : NumberLong(13964234),
"storageSize" : NumberLong(8056832), "totalFreeStorageSize" : NumberLong(0),
"numExtents" : NumberLong(0), "indexes" : 2, "indexSize" : NumberLong(1044480),
"indexFreeStorageSize" : NumberLong(0), "fileSize" : NumberLong(0), "nsSizeMB" : 0, "ok" : 1 }

Información Adicional

Para obtener más información sobre los conceptos de esta guía, consulte la siguiente documentación en el manual de MongoDB Server:

• db.runCommand()

• Comandos de base de datos

• Hola Comando

• Comando dbStats