Overview
在本指南中,您可以学习如何使用Java Reactive Streams驱动程序运行数据库命令。您可以使用数据库命令执行各种管理和诊断任务,例如获取服务器统计信息、初始化副本集或运行聚合管道。
提示
优先使用驱动程序方法而非数据库命令
驱动程序为许多数据库命令提供了方法。我们建议尽可能使用驱动程序方法,而不是执行数据库命令。
要执行管理任务,请使用 MongoDB Shell 而不是 Java Reactive Streams 驱动程序。调用MongoDB Shell db.runCommand() 方法是发出数据库命令的首选方法,因为它在shell和驱动程序之间提供了一致的接口。
重要
项目 Reactor 库
本指南使用 Project Reactor 库来使用Java Reactive Streams驱动程序方法返回的 Publisher 实例。要学习;了解有关 Project Reactor 库及其使用方法的更多信息,请参阅 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文档。