db.adminCommand()
중요
Mongo쉬 방법
이는 mongosh
메서드입니다. 이는 Node.js
또는 기타 프로그래밍 언어별 드라이버 메서드에 대한 설명서가 아닙니다 .
대부분의 경우 mongosh
메서드는 레거시 mongo
shell 메서드와 동일한 방식으로 작동합니다. 그러나 일부 레거시 메서드는 mongosh
에서 사용할 수 없습니다.
레거시 mongo
셸 문서는 해당 MongoDB 서버 릴리스 문서를 참조하세요.
MongoDB API 드라이버의 경우 언어별 MongoDB 드라이버 문서를 참조하세요.
정의
db.adminCommand(command)
admin
데이터베이스에 대해 지정된 데이터베이스 명령을 실행하는 헬퍼를 제공합니다.
행동
db.adminCommand()
는 실행되는 데이터베이스 컨텍스트에 관계없이 admin
데이터베이스 에 대해 명령을 실행합니다. 다음 명령은 이에 해당합니다.
db.getSiblingDB("admin").runCommand(<command>) db.adminCommand(<command>)
사용 가능한 관리 데이터베이스 명령 목록은 관리 명령을 참조하세요.
참고
authorization
과 함께 실행 중인 mongod
또는 mongos
의 경우, 권한 부여된 사용자에게 데이터베이스 명령을 실행할 수 있는 적절한 특권이 있어야 합니다. 보안 요구 사항에 대한 자세한 내용은 명령에 대한 참고 문서를 참조하세요.
응답
이 메서드는 다음 필드가 포함된 응답 문서를 반환합니다.
필드 | 설명 |
---|---|
<command result> | 실행된 command 와 관련된 결과 필드입니다. |
ok | 명령이 성공했는지( 1 ) 또는 실패했는지(0 ) 여부를 나타내는 숫자입니다. |
operationTime | 수행된 작업의 논리적 시간으로, MongoDB 에서 oplog 항목의 타임스탬프로 표시됩니다. 복제본 세트 및 샤딩된 클러스터에만 해당 명령이 oplog 엔트리(예시: 읽기 작업)를 생성하지 않는 경우 작업은 논리적 시계를 진행하지 않습니다. 이 경우
인과적으로 일관적인 세션과 관련된 작업의 경우 MongoDB 드라이버는 논리적 시간을 사용하여 읽기 작업 및 버전 3.6에 새로 추가되었습니다. |
$clusterTime | 서명된 클러스터 시간을 반환하는 문서입니다. 클러스터 시간은 작업 순서를 지정하는 데 사용되는 논리적 시간입니다. 복제본 세트 및 샤딩된 클러스터에만 해당됩니다. 내부용으로만 사용하세요. 이 문서에는 다음 필드가 포함되어 있습니다:
버전 3.6에 새로 추가되었습니다. |
예시
killOp
다음 예시에서는 db.adminCommand()
메서드로 killOp
명령을 실행하여 opid 724
인 작업을 종료합니다. killOp
는 관리 명령이며 admin
데이터베이스에 대해 실행해야 합니다.
db.adminCommand( { "killOp": 1, "op": 724 } )
리네임 컬렉션
다음 예시에서는 db.adminCommand()
(을)를 사용해 renameCollection
관리 데이터베이스 명령을 실행하여 test
데이터베이스의 orders
컬렉션 이름을 orders-2016
(으)로 변경합니다.
db.adminCommand( { renameCollection: "test.orders", to: "test.orders-2016" } )
createUser
다음 예시에서는 db.adminCommand()
메서드를 사용해 admin
데이터베이스에서 dbOwner
역할을 가진 bruce
라는 이름의 사용자를 만듭니다.
팁
메서드/명령 호출에 비밀번호를 직접 지정하는 대신 passwordPrompt()
메서드를 다양한 사용자 인증/관리 메서드/명령과 함께 사용하여 비밀번호를 입력하라는 메시지를 표시할 수 있습니다. 그러나 이전 버전의 mongo
shell 에서와 마찬가지로 비밀번호를 직접 지정할 수 있습니다.
db.adminCommand( { createUser: "bruce", pwd: passwordPrompt(), // or <cleartext password> roles: [ { role: "dbOwner", db: "admin" } ] } )