データベースコマンドの実行

Overview

このガイドでは、 .NET/ C#ドライバーを使用してデータベースコマンドを実行する方法を学習できます。データベースコマンドを使用して、サーバー統計の取得、レプリカセットを初期化、集計パイプラインの実行中など、さまざまな管理および診断タスクを実行できます。

コマンドの実行

データベースコマンドを実行するには、コマンドを指定する BsonDocumentオブジェクトを作成し、それをパラメーターとして RunCommand() メソッドまたは RunCommandAsync() メソッドに渡します。型パラメーターを指定することで、これらのメソッドによって返される型を指定できます。コマンドの応答を返すには、BsonDocument 型を使用します。また、独自の 厳密に型指定されたクラスを指定して、コマンドの応答を逆直列化することもできます。

次の例では、データベースに対して hello コマンドを実行し、サーバーに関する情報を返します。対応するコードを表示するには、Asynchronous タブまたは Synchronousタブを選択します。

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

読み込み設定（read preference）の設定

RunCommand() メソッドは、MongoDatabaseインスタンスに設定した読み込み設定（ 読み込み設定 (read preference) ）を継承しません。デフォルトでは 、RunCommand() は primary 読み込み設定（ 読み込み設定 (read preference)） を使用します。

次の例に示すように、ReadPreferenceインスタンスをパラメータとして RunCommand() に渡すことで、コマンド実行の読み込み設定 (read preference)を設定できます。対応するコードを表示するには、Asynchronous タブまたは Synchronousタブを選択します。

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 Serverマニュアルの次のドキュメントを参照してください。

• db.runCommand()

• データベース コマンド

• hello コマンド

• dbStats コマンド