Executar um comando de banco de dados

Visão geral

Neste guia, você pode aprender como usar o .NET/C# Driver para executar um comando de banco de dados. Você pode usar comandos de banco de dados para executar uma variedade de tarefas administrativas e de diagnóstico, como buscar estatísticas do servidor , inicializar um conjunto de réplicas ou executar um pipeline de agregação .

Executar um comando

Para executar um comando de banco de dados, crie um objeto BsonDocument que especifique o comando e passe-o como um parâmetro para o método RunCommand() ou RunCommandAsync() . Você pode especificar o tipo retornado por esses métodos especificando o parâmetro type. Você pode usar o tipo BsonDocument para retornar a resposta do comando ou pode especificar sua própria classe fortemente digitada para desserializar a resposta do comando.

O exemplo seguinte executa o comando hello em um banco de dados, que retorna informações sobre o servidor. Selecione a aba Asynchronous ou Synchronous para ver o código correspondente.

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);

Definir uma preferência de leitura

O método RunCommand() não herda a preferência de leitura que você pode ter definido na sua instância do MongoDatabase. Por padrão, o RunCommand() utiliza a preferência de leitura primary .

Você pode definir uma preferência de leitura para a execução do comando passando uma instância do ReadPreference como um parâmetro para o RunCommand(), como mostrado no exemplo a seguir . Selecione a aba Asynchronous ou Synchronous para ver o código correspondente.

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);

Resposta

O documento de resposta do comando bruto retornado pelo método RunCommand() contém os seguintes 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 }

Informações adicionais

Para obter mais informações sobre os conceitos deste guia, consulte a seguinte documentação no manual do MongoDB Server :

• db.runCommand()

• Comandos de banco de dados

• olá comando

• Comando dbStats