Executar um comando de banco de dados
Visão geral
Neste guia, você pode aprender como executar um comando de banco de dados de dados com o driver Java Reactive Streams. Você pode usar comandos de banco de dados de dados para executar uma variedade de tarefas administrativas e de diagnóstico, como buscar estatísticas do servidor , inicializar um conjunto de réplicas ou executar um pipeline de agregação .
Dica
Preferir métodos de driver a comandos de banco de dados
O driver fornece métodos para muitos comandos de banco de dados de dados. Recomendamos usar métodos de driver em vez de executar comandos de banco de dados de dados quando possível.
Para executar tarefas administrativas, use o MongoDB Shell em vez do driver Java Reactive Streams. Chamar o método MongoDB Shell db.runCommand() é o método preferido para emitir comandos do banco de dados de dados, pois fornece uma interface consistente entre o shell e os drivers.
Importante
Biblioteca do Reator do Projeto
Este guia usa a biblioteca Project Reactor para consumir instâncias do Publisher retornadas pelos métodos de driver Java Reactive Streams. Para saber mais sobre a biblioteca do Project Reactor e como usá-la, consulte Introdução na documentação do Reactor. Para saber mais sobre como usamos os métodos da biblioteca do Project Reactor neste guia, consulte o guia Gravar dados no MongoDB .
Execute um comando
Para executar um comando de banco de dados de dados, especifique o comando em um documento e passe o documento para o método runCommand() . O código a seguir chama o método runCommand() em um banco de dados de dados para executar o comando ping , que é um comando sem operação usado para testar se um servidor responde.
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}}
Informações adicionais
Para ver uma lista completa de comandos de banco de dados de dados e seus parâmetros disponíveis, consulte Comandos de banco de dados no manual do MongoDB Server .
Documentação da API
Para saber mais sobre o runCommand() método , consulte a documentação da API runCommand().