setUserWriteBlockMode (데이터베이스 명령)

정의

setUserWriteBlockMode

버전 6.0에 추가.

setUserWriteBlockMode 명령은 전체 클러스터에 대한 쓰기를 차단 및 차단 해제합니다.

Cluster-to-Cluster Sync 중에 cluster-to-cluster 동기화 도구인 mongosync는 setUserWriteBlockMode 명령을 사용하여 대상 클러스터에 대한 쓰기를 차단합니다. 자세한 내용은 HTTP API 시작 명령을 참조하세요.

복제본 세트 에 대한 쓰기를 이미 차단한 경우, 지정된 reason 가 처음 쓰기 차단을 활성화할 때 제공한 이유와 일치하지 않으면 global: true 을 사용한 setUserWriteBlockMode 에 대한 후속 호출이 실패하고 IllegalOperation 오류가 발생합니다. 오류 메시지에는 현재 이유와 실패한 명령에 지정된 이유가 모두 포함됩니다. 샤드 클러스터는 이 제약 조건을 시행하다 하지 않습니다.

참고

bypassWriteBlockingMode 권한 이 있는 사용자 및 애플리케이션은 차단 을 우회하고 쓰기를 계속 수행할 수 있습니다.

호환성

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

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

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

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

구문

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

db.adminCommand(
   {
     setUserWriteBlockMode: 1,
     global: <boolean>,
     reason: <string>  // Optional
   }
)

명령 필드

이 명령은 다음 필드를 사용합니다.

필요한 액세스 권한

setUserWriteBlockMode 명령을 실행하려면 사용자에게 setUserWriteBlockMode 권한이 있어야 합니다.

예시

1. 사용자 쓰기 차단 모드를 활성화합니다:

   db.adminCommand( {
      setUserWriteBlockMode: 1,
      global: true
   } )

2. collection에 기록을 추가합니다:

   db.names.insertOne( { name: "George Washington Cable" } )

   사용자 쓰기 차단이 활성화되어 있기 때문에 서버가 쓰기를 차단합니다.

   출력 예시:

   MongoServerError: User writes blocked

3. 사용자 쓰기 차단 모드를 비활성화합니다:

   db.adminCommand( {
      setUserWriteBlockMode: 1,
      global: false
   } )

4. collection에 기록을 추가합니다:

   db.names.insertOne( { name: "George Washington Cable" } )

   insertOne() 메서드는 컬렉션에 씁니다. 사용자 쓰기 차단이 비활성화되어 있으므로 서버에서 쓰기를 허용합니다.