运行数据库命令
概述
在本指南中,您可以学习如何使用Java反应式流驱动程序运行数据库命令。您可以使用数据库命令执行各种管理性和诊断任务,例如检索服务器统计信息、初始化副本集或运行聚合管道。
提示
优先使用驱动程序方法而不是数据库命令
驱动程序为许多数据库命令提供了方法。我们建议在可能的情况下使用驱动程序方法而不是执行数据库命令。
要执行管理任务,请使用MongoDB Shell而不是Java反应式流驱动程序。调用MongoDB Shell的db.runCommand()方法是发出数据库命令的首选方法,因为它在shell和驱动程序之间提供了一个一致的接口。
重要
Project Reactor库
本指南使用Project Reactor库来消费Publisher
实例,这些实例是由Java反应式流驱动程序方法返回的。有关Project Reactor库的更多信息以及如何使用它,请参阅入门中的Reactor文档。有关本指南中如何使用Project 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 服务器手册中的 数据库命令。
API 文档
要了解更多关于 runCommand()
方法的知识,请参阅 runCommand() API 文档。