db.runCommand()

정의

db.runCommand(command, [options])

지정된 데이터베이스 명령을 실행하기 위한 도우미를 제공합니다. 이는 셸과 드라이버 간에 일관적인 인터페이스를 제공하므로 데이터베이스 명령을 실행하는 데 선호되는 방법입니다.

Parameter	유형	설명
command	문서 또는 문자열	명령을 지정하는 문서 또는 문자열입니다. 문자열로 지정된 경우 db.runCommand()는 문자열을 문서로 변환합니다.
options	문서	mongosh 2.0부터는 mongosh 명령 실행 방법을 지정하는 옵션이 추가되었습니다.
options.readPreference	readPreference	명령을 실행할 읽기 설정입니다. 지정하지 않은 경우 기본값은 primary입니다. db.runCommand()는 setReadPref()를 사용하거나 연결 문자열에 readPreference를 지정하는 등 다른 모든 읽기 설정 전역 구성 집합을 무시합니다. mongosh 1.x에서 db.runCommand()는 options 인수를 사용하지 않습니다. 읽기 설정을 설정하려면 Mongo.setReadPref()를 사용하거나 연결 문자열에 readPreference를 지정합니다.

시간 제한을 밀리초 단위로 지정하려면 실행 중인 작업 종료를 참조하세요.

호환성

이 메서드는 다음 환경에서 호스팅되는 배포에서 사용할 수 있습니다.

• MongoDB Atlas: 클라우드에서의 MongoDB 배포를 위한 완전 관리형 서비스

• MongoDB Enterprise: MongoDB의 구독 기반 자체 관리 버전

• MongoDB Community: MongoDB의 소스 사용 가능 무료 자체 관리 버전

행동

db.runCommand()는 현재 데이터베이스의 컨텍스트에서 명령을 실행합니다. 일부 명령은 admin 데이터베이스의 컨텍스트에서만 적용할 수 있으며, 이러한 명령을 실행하기 전에 db 객체를 변경하거나 db.adminCommand()를 사용해야 합니다.

예시

다음 예에서는 db.runCommand()를 사용하여 데이터베이스 명령을 실행하는 방법을 보여 줍니다.

db.runCommand( { hello: 1 } )

db.runCommand( { hello: 1 }, { readPreference: "secondaryPreferred" } )

응답

이 메서드는 다음 필드가 포함된 응답 문서를 반환합니다.