문서 메뉴

문서 홈 → 애플리케이션 개발 → MongoDB 매뉴얼

dropRole

이 페이지의 내용

  • 정의
  • 구문
  • 명령 필드
  • 행동
  • 필요한 액세스 권한
  • 예제

정의

dropRole

명령을 실행하는 데이터베이스에서 사용자 정의 역할을 삭제합니다.

팁

mongosh 에서 이 명령은 db.dropRole() 헬퍼 메서드를 통해서도 실행할 수 있습니다.

헬퍼 메서드는 mongosh 사용자에게 편리하지만 데이터베이스 명령과 동일한 수준의 정보를 반환하지 않을 수 있습니다. 편의가 필요하지 않거나 추가 반환 필드가 필요한 경우 database 명령을 사용합니다.

구문

명령은 다음과 같은 구문을 가집니다:

db.runCommand(
   {
     dropRole: "<role>",
     writeConcern: { <write concern> },
     comment: <any>
   }
)

명령 필드

명령에는 다음과 같은 필드가 있습니다.

필드
유형
설명
dropRole
문자열
데이터베이스에서 제거할 사용자 정의 역할 의 이름입니다.
writeConcern
문서

선택 사항입니다. 작업에 대한 쓰기 고려 수준입니다. 쓰기 고려 사양을 참조하세요.

comment
어떤

선택 사항. 이 명령에 첨부할 사용자 제공 코멘트입니다. 설정되면 이 설명은 다음 위치에서 이 명령의 레코드와 함께 표시됩니다.

댓글은 유효한 모든 BSON types (문자열, 정수, 객체, 배열 등)이 될 수 있습니다.

행동

인증

mongod 에서 역할이 삭제되면 이전에 인증된 사용자는 데이터베이스에 로그인된 상태로 유지되지만 즉시 역할의 권한을 잃게 됩니다.

mongos 에서 역할이 삭제되면 이전에 인증된 사용자는 데이터베이스에 로그인된 상태로 유지되지만 캐시가 새로 고쳐지면 역할의 권한을 잃게 됩니다. 캐시는 userCacheInvalidationIntervalSecs 매개변수로 지정된 시간이 지나면 자동으로 새로 고침되거나 invalidateUserCache 명령을 실행할 때 수동으로 새로 고침됩니다.

필요한 액세스 권한

해당 데이터베이스에서 역할을 삭제하려면 데이터베이스에 대한 dropRole 작업 이 있어야 합니다.

예제

다음 작업은 products 데이터베이스에서 readPrices 역할을 제거합니다.

use products
db.runCommand(
   {
     dropRole: "readPrices",
     writeConcern: { w: "majority" }
   }
)
← createRole
dropAllRolesFromDatabase →

이 페이지의 내용