データベースコマンドの実行
Overview
このガイドでは、 Java Reactive Streams ドライバーを使用してデータベースコマンドを実行する方法を学習できます。 データベースコマンドを使用して、サーバー統計の取得、レプリカセットを初期化、集計パイプラインの実行中など、さまざまな管理および診断タスクを実行できます。
Tip
データベースコマンドよりもドライバーメソッドを優先
ドライバーは、多くのデータベースコマンドのメソッドを提供します。 可能な場合は、データベースコマンドを実行する代わりにドライバー メソッドを使用することをお勧めします。
管理タスクを実行するには、 Java Reactive Streams ドライバーの代わりに MongoDB Shellを使用します。 MongoDB Shell db.runCommand()メソッドを呼び出すことは、 shellとドライバー間の一貫したインターフェースを提供するため、データベースコマンドを発行するための推奨される方法です。
重要
プロジェクトリ アクター ライブラリ
このガイドでは、プロジェクト Reactive ライブラリを使用して、 Java Reactive Streams ドライバー メソッドによって返された Publisherインスタンスを消費します。 Project Reactive ライブラリとその使用方法の詳細については、「 使用 開始 」を 参照してください。 （Reactor ドキュメントの参照）。このガイドでは、プロジェクト Reactor ライブラリ メソッドの使用方法の詳細については、「 MongoDBへのデータの書込み」ガイドを参照してください。
コマンドの実行
データベースコマンドを実行するには、ドキュメントでコマンドを指定し、そのドキュメントをrunCommand()メソッドに渡します。 次のコードでは、データベースでrunCommand()メソッドを呼び出してpingコマンドを実行します。このコマンドは、サーバーが応答するかどうかをテストするために使用されるノーオペレーション コマンドです。
Document command = new Document("ping", 1); Publisher<Document> commandPublisher = database.runCommand(command); Document result = Mono.from(commandPublisher).block(); System.out.println(result);
Document{{ok=1}}
詳細情報
データベースコマンドと使用可能なパラメーターの完全なリストを確認するには、 MongoDB Serverマニュアルの「データベースコマンド」を参照してください。
API ドキュメント
runCommand()メソッドの詳細については、 runCommand() APIドキュメントを参照してください。