db.adminCommand()
중요
Mongo쉬 방법
이 페이지에서는 mongosh
방법에 대해 설명합니다. 이는 Node.js와 같은 언어별 드라이버에 대한 문서가 아닙니다.
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 엔트리(예: 읽기 작업)를 생성하지 않는 경우 작업은 논리적 시계를 진행하지 않습니다. 이 경우
인과적으로 일관적인 세션과 관련된 작업의 경우 MongoDB 드라이버는 논리적 시간을 사용하여 읽기 작업 및 |
$clusterTime | 서명된 클러스터 시간을 반환하는 문서입니다. 클러스터 시간은 작업 순서를 지정하는 데 사용되는 논리적 시간입니다. 복제본 세트 및 샤드 클러스터에만 해당됩니다. 내부용으로만 사용하세요. 이 문서에는 다음 필드가 포함되어 있습니다:
|
예제
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" } ] } )