데이터베이스 명령 실행
개요
이 가이드 에서는 Java Reactive Streams 운전자 를 사용하여 데이터베이스 명령 을 실행 하는 방법을 학습 수 있습니다. 데이터베이스 명령을 사용하여 서버 통계 가져오기, 복제본 세트 초기화 또는 집계 파이프라인 실행 과 같은 다양한 관리 및 진단 작업을 수행할 수 있습니다.
팁
데이터베이스 명령보다 드라이버 메서드 선호
운전자 는 많은 데이터베이스 명령에 대한 메서드를 제공합니다. 가능하면 데이터베이스 명령을 실행하는 대신 운전자 메서드를 사용하는 것이 좋습니다.
관리 작업을 수행하려면 Java Reactive Streams 운전자 대신 MongoDB Shell 을 사용합니다. MongoDB Shell db.runCommand() 메서드를 호출하는 것은 shell 과 드라이버 간에 일관적인 인터페이스를 제공하므로 데이터베이스 명령을 실행하는 데 선호되는 메서드입니다.
중요
프로젝트 리액터 라이브러리
이 가이드 에서는 Project Reactor 라이브러리를 사용하여 Java Reactive Streams 운전자 메서드에서 반환된 Publisher
인스턴스를 사용합니다. Project Reactor 라이브러리 및 사용 방법에 학습 보려면 시작하기 를 참조하세요. Reactor 문서에서 확인 가능합니다. 이 가이드 에서 Project Reactor 라이브러리 메서드를 사용하는 방법에 학습 보려면 MongoDB 에 데이터 쓰기 가이드 를 참조하세요.
명령 실행
데이터베이스 명령 을 실행 하려면 문서 에 명령을 지정하고 runCommand()
메서드에 문서 를 전달합니다. 다음 코드는 데이터베이스 에서 runCommand()
메서드를 호출하여 서버 가 응답하는지 테스트하는 데 사용되는 no-op 명령인 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 설명서를 참조하세요.