运行数据库命令

概述

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

执行一个命令

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

以下示例在一个数据库上运行 hello 命令，该命令返回有关服务器的信息。选择异步或同步选项卡以查看相应的代码。

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

设置读取偏好

RunCommand() 方法不会继承您可能已在 MongoDatabase 实例上设置的读取偏好。默认情况下，RunCommand() 使用 primary 读取偏好。

您可以通过将 ReadPreference 实例作为参数传递给 RunCommand() 来为命令执行设置读取偏好，如下例所示。选择异步或同步选项卡以查看相应的代码。

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

响应

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

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 }

更多信息

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

• db.runCommand()

• 数据库命令

• hello命令

• dbStats命令