运行数据库命令

Overview

在本指南中，您可以学习；了解如何使用.NET/ C#驱动程序来运行数据库命令。 您可以使用数据库命令执行各种管理和诊断任务，例如获取服务器统计信息、初始化副本集或运行聚合管道。

执行命令

要运行数据库命令，请创建指定该命令的 BsonDocument对象，并将其作为参数传递给 RunCommand() 或 RunCommandAsync() 方法。 您可以通过指定类型参数来指定这些方法返回的类型。 您可以使用 BsonDocument 类型返回命令响应，也可以指定自己的强类型类来反序列化命令响应。

以下示例对数据库运行 hello 命令，该命令会返回有关服务器的信息。 选择 Synchronous 或 Asynchronous标签页以查看相应的代码。

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

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

设置读取偏好

RunCommand() 方法不会继承您可能在 MongoDatabase实例上设立的读取偏好（read preference）。 默认下，RunCommand() 使用 primary读取偏好（read preference）。

您可以将 ReadPreference实例作为参数传递给 RunCommand()，为命令执行设置设立读取偏好（read preference），如以下示例所示。 选择 Synchronous 或 Asynchronous标签页以查看相应的代码。

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

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

响应

RunCommand() 方法返回的原始命令响应文档包含以下字段：

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

var command = new BsonDocument("dbStats", 1);
var result = await database.RunCommandAsync<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 }

更多信息

有关本指南中概念的更多信息，请参阅MongoDB Server手册中的以下文档：

• db.runCommand()

• 数据库命令

• hello 命令

• dbStats 命令