설정 기능 호환성 버전

백그라운드 작업과의 충돌

특정 백그라운드 작업으로 인해 setFeatureCompatibilityVersion이 실행되지 않을 수 있습니다. currentOp를 사용하여 진행 중인 작업을 식별하세요.

동기화 실패

초기 동기화 중에 setFeatureCompatibilityVersion 변경 사항을 트리거하면 oplog 애플리케이션 단계에서 항목을 재생할 때 OplogOperationUnsupported 오류 메시지와 함께 동기화가 실패할 수 있습니다. 이 시도 이후의 동기화는 작업 단계에서 더 이상 작업을 재생하지 않기 때문에 성공합니다.

Default Values

멱등성

이 명령은 내부 시스템 컬렉션에 대한 쓰기를 수행해야 합니다. 어떤 이유로든 명령이 성공적으로 완료되지 않는 경우 작업이 무력하므로 명령을 안전하게 다시 시도할 수 있습니다.

자세한 내용은 Cluster-to-Cluster Sync와 사용자 쓰기 차단

MongoDB 6.0부터는 기능 호환성 버전을 다운그레이드해야 하는 경우 cluster 간 복제 및 사용자 쓰기 차단을 비활성화해야 합니다.

1. 클러스터 간 복제를 활성화한 경우 비활성화합니다.

2. 사용자 쓰기 차단을 활성화한 경우 비활성화합니다:

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

3. 이전 명령이 완료될 때까지 기다립니다.

4. setFeatureCompatibilityVersion을 사용하여 기능 호환성 버전을 다운그레이드합니다.

MongoDB Cluster-to-Cluster Sync에 대한 자세한 내용은 문서를 참조하세요.

중재자의 기능 호환성

중재자는 admin.system.version 컬렉션을 복제하지 않습니다. 이로 인해 중재자는 복제본 세트의 FCV 값에 관계없이 바이너리의 다운그레이드 버전과 동일한 기능 호환성 버전을 항상 갖게 됩니다.

그 예로 MongoDB 5.0 클러스터에 속한 중재자의 FCV 값은 4.4입니다.

FeatureCompatibilityVersion 가져오기

mongod 인스턴스에 대한 featureCompatibilityVersion을 보려면 mongod 인스턴스에서 getParameter 명령을 실행합니다.

db.adminCommand( {
                    getParameter: 1,
                    featureCompatibilityVersion: 1
                 }
               )

출력은 다음과 같습니다.

{
  featureCompatibilityVersion: { version: '5.0' },
  ok: 1,
  '$clusterTime': {
    clusterTime: Timestamp({ t: 1660318752, i: 5 }),
    signature: {
      hash: Binary(Buffer.from("ce0cff3621e9b089fa6d8e9a1e1efc1a1ff15dab", "hex"), 0),
      keyId: Long("7129893797260951557")
    }
  },
  operationTime: Timestamp({ t: 1660318752, i: 5 })
}

MongoDB 6.0 배포에서 기능 호환성 버전 설정하기

db.adminCommand( { setFeatureCompatibilityVersion: "6.0" } )

db.adminCommand( { setFeatureCompatibilityVersion: "5.0" } )

MongoDB 5.0 배포에서 기능 호환성 버전 설정

db.adminCommand( { setFeatureCompatibilityVersion: "5.0" } )

db.adminCommand( { setFeatureCompatibilityVersion: "4.4" } )

MongoDB 4.2 배포에서 기능 호환성 버전 설정

db.adminCommand( { setFeatureCompatibilityVersion: "4.2" } )

쓰기 고려 시간 초과 설정

다음 예시에서는 선택적 쓰기 고려 wtimeout 필드를 5000(5초)으로 설정합니다.

db.adminCommand( {
   setFeatureCompatibilityVersion: "5.0",
   writeConcern: { wtimeout: 5000 }
} )