Docs Menu
Docs Home
/
MongoDB 매뉴얼
/
참조
/
데이터베이스 명령
/
역할 관리

dropRole

이 페이지의 내용

  • 정의
  • 호환성
  • 구문
  • 명령 필드
  • 행동
  • 필요한 액세스 권한
  • 예시

정의

dropRole

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

팁

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

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

호환성

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

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

중요

이 명령은 M0, M2, M5 및 M10클러스터 이상에서 지원되지 않습니다. 자세한 내용은 지원되지 않는 명령을 참조하세요.

구문

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

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

명령 필드

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

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

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

comment
any

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

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

행동

인증

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

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

필요한 액세스 권한

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

예시

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

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

돌아가기

createRole

다음

dropAllRolesFromDatabase