setDefaultRWConcern (데이터베이스 명령)

복제본 세트

Issue setDefaultRWConcern against the replica set primary. The primary replicates the new global default settings to the remaining members of the replica set. Secondaries which have not yet replicated the updated global default settings continue using their local 'stale' copy of the defaults.

Issue the setDefaultRWConcern command with a writeConcern of w : "majority" to ensure the command only returns after the changes have propagated to a majority of replica set members.

샤딩된 클러스터

Issue the setDefaultRWConcern against a mongos in the cluster. The mongos persists the updated settings to the config server replica set (CSRS). Each mongos periodically issues a getDefaultRWConcern against the CSRS to refresh their local copy of the global settings. A mongos uses its local 'stale' copy of the global defaults during the time period between refreshes.

Issue the setDefaultRWConcern command with a writeConcern of w : "majority" to ensure the command only returns after the changes have propagated to a majority of CSRS members.

애플리케이션이 읽기 또는 쓰기 고려 설정을 명시적으로 지정하지 않은 채 mongos을(를) 대상으로 연산을 실행하면 mongos이(가) 이에 해당하는 전역 기본 설정을 적용합니다.

The global default settings do not propagate to the individual shards. You cannot run setDefaultRWConcern against a shard.

액세스 제어

For replica sets or sharded clusters enforcing Authentication on Self-Managed Deployments, setDefaultRWConcern requires that the authenticated user have the setDefaultRWConcern privilege action.

The clusterManager built-in role provides the required privileges to run setDefaultRWConcern.

전역 기본 쓰기 고려 설정하기

아래 연산에서는 전역 쓰기 고려를 다음 값으로 설정합니다.

• w: 2

db.adminCommand({
  "setDefaultRWConcern" : 1,
  "defaultWriteConcern" : {
    "w" : 2
  }
})

이 작업은 다음과 유사한 문서를 반환합니다.

{
  "defaultWriteConcern" : {
   "w" : 2
  },
  "updateOpTime" : Timestamp(1586290895, 1),
  "updateWallClockTime" : ISODate("2020-04-07T20:21:41.849Z"),
  "localUpdateWallClockTime" : ISODate("2020-04-07T20:21:41.862Z"),
  "ok" : 1,
  "$clusterTime" : { ... }
  "operationTime" : Timestamp(1586290925, 1)
}

전역 기본 읽기 고려 설정하기

다음 연산에서는 전역 읽기 고려를 "majority"(으)로 설정합니다.

db.adminCommand({
  "setDefaultRWConcern" : 1,
  "defaultReadConcern" : { "level" : "majority" }
})

이 작업은 다음과 유사한 문서를 반환합니다.

{
  "defaultReadConcern" : {
    "level" : "majority"
  },
  "updateOpTime" : Timestamp(1586290895, 1),
  "updateWallClockTime" : ISODate("2020-04-07T20:21:41.849Z"),
  "localUpdateWallClockTime" : ISODate("2020-04-07T20:21:41.862Z"),
  "ok" : 1,
  "$clusterTime" : { ... }
  "operationTime" : Timestamp(1586290925, 1)
}

전역 기본 읽기/쓰기 고려 설정하기

아래 연산에서는 전역 기본 읽기/쓰기 고려를 다음 값으로 설정합니다.

• w: 2 쓰기 고려

• level: "majority" 읽기 고려

db.adminCommand({
  "setDefaultRWConcern" : 1,
  "defaultWriteConcern" : {
    "w" : 2
  },
  "defaultReadConcern" : { "level" : "majority" }
})

이 작업은 다음과 유사한 문서를 반환합니다.

"defaultWriteConcern" : {
  "w" : 2
},
"defaultReadConcern" : {
  "level" : "majority"
}

전역 기본 읽기/쓰기 고려 설정 해제하기

다음을 수행할 수 있습니다.

• 전역 기본 읽기 고려를 설정 해제하세요.

• 전역 기본 쓰기 고려는 아직 설정하지 않은 경우에만 설정 해제하세요.

그 예로 전역 기본 읽기 고려가 level: "majority"(으)로 설정되어 있다고 가정해 봅시다. 전역 기본 읽기 고려를 설정 해제하려면 빈 문서 {}을(를) 사용하세요.

db.adminCommand( {
   "setDefaultRWConcern" : 1,
   "defaultReadConcern" : {}
} )

이 연산은 연산이 성공했다는 것을 나타내는 문서를 다음과 같이 반환합니다.

{
   defaultReadConcern: { level: 'local' },
   defaultWriteConcern: { w: 2, wtimeout: 0 },
   updateOpTime: Timestamp({ t: 1656696934, i: 1 }),
   updateWallClockTime: ISODate("2022-07-01T17:35:40.578Z"),
   defaultWriteConcernSource: 'global',
   defaultReadConcernSource: 'implicit',
   localUpdateWallClockTime: ISODate("2022-07-01T17:35:40.578Z"),
   ok: 1,
   '$clusterTime': {
      ...
   },
   operationTime: Timestamp({ t: 1656632593, i: 1 })
}

전역 기본 쓰기 고려는 아직 설정하지 않은 경우에만 설정 해제할 수 있습니다.

전역 기본 쓰기 고려를 설정 해제하려면 빈 문서 {}을(를) 사용하세요.

db.adminCommand( {
   "setDefaultRWConcern" : 1,
   "defaultWriteConcern" : {}
} )

전역 기본 쓰기 고려가 다음과 같은 상태인 경우:

• 설정 해제됨, 연산이 성공합니다.

• 이미 설정되어 있음, 연산이 다음과 같은 오류를 반환합니다.

MongoServerError: The global default write concern cannot be unset
once it is set.