MongoDB 7.0의 호환성 변경 사항

Public Preview와 정식 출시 간의 서버 및 드라이버 호환성

동일성 쿼리와 함께 Queryable Encryption을 사용하려면 MongoDB 서버가 버전 7.0 이상이어야 하며 드라이버가 7.0과 호환되어야 합니다. MongoDB 6.x에 포함된 Queryable Encryption Public Preview를 계속 사용하는 경우 서버는 버전 6.x를 유지하고 드라이버는 6.x와 호환되어야 합니다. 7.0 서버에서는 MongoDB 6.x 호환 드라이버를 사용하거나 6.x 서버에서 7.0 호환 드라이버를 사용할 수 없습니다. 이 작업을 시도하면 오류가 발생합니다.

업그레이드를 더 쉽게 하기 위해 MongoDB 7.0 드라이버는 MongoDB 6.x 드라이버에서 생성된 데이터를 해독할 수 있습니다. 업그레이드 옵션은 다음 섹션을 참조하세요.

OIDC 액세스 토큰 인증 동작

MongoDB 7.0 부터 시작됩니다. OIDC 액세스 토큰에 대해 하나의 audience oidcIdentityProviders 필드 만 지정할 수 있습니다. 빈 배열이나 여러 문자열의 배열이 있는 audience 필드는 유효하지 않습니다.

자세한 내용은 oidcIdentityProviders 필드를 참조하세요.

세분성 설정

MongoDB 부터는 새로운 및 사용자 6.3 지정 버킷 매개변수를 사용하여 시계열 버킷 세분성을 구성할 수 bucketMaxSpanSeconds bucketRoundingSeconds 있습니다. 미만으로 다운그레이드하려면 6.3 이러한 매개변수가 있는 모든 컬렉션을 삭제하거나 해당 를 사용하도록 수정해야 granularity 합니다. 자세한 내용은 를 collMod 참조하세요.

모든 bucketMaxSpanSeconds 및 bucketRoundingSeconds 값이 granularity 값에 해당하는 것은 아닙니다. 이러한 경우 컬렉션 삭제해야 합니다.

Time Series 컬렉션을 위한 부분 TTL 인덱스

MongoDB 부터는 6.3 Time Series 컬렉션에 부분 TTL (Time To Live) 인덱스를 생성할 수 있습니다. 미만으로 6.3 다운그레이드하려면 time series 컬렉션에서 부분 TTL 인덱스를 모두 제거 해야 합니다.

config.settings 스키마 유효성 검사

MongoDB 부터는 컬렉션 에 필드 6.2 value 1 1024 있는 문서를 삽입하거나 업데이트할 때 와(과)(포함) _id: chunksize config.settings 사이에 를 설정하다 해야 합니다. 잘못된 value 를 지정하면 MongoDB 스키마 유효성 검사 오류를 반환합니다.

MongoDB 6.2 이전에 설정하다 1 ~ 1024 MB(포함) 범위 를 벗어나는 모든 value 필드는 변경되지 않습니다.

제거된 옵션

버전 6.2부터 MongoDB는 addShard 명령에서 maxSize 필드를 제거합니다. 그 결과는 다음과 같습니다.

• maxSize 필드와 함께 addShard를 실행하면 InvalidOptions 오류가 반환됩니다.

• shards 컬렉션의 새 문서들은 더 이상 maxSize 필드를 포함하지 않습니다.

• 기존의 maxSize 필드 항목은 모두 무시됩니다.

$add 부동 소수점 반올림 오류

MongoDB 부터 표현식 6.1 $add 여러 부동 점 값이 포함된 입력 목록을 수신하면 MongoDB 이전 버전과 약간 다른 결과를 반환할 수 있습니다.

$add 표현식 더 이상 부동 소수점 반올림 오류를 설명하지 않습니다. 따라서 $add 은 대부분의 프로그래밍 언어에서 더하기처럼 작동합니다.

예시 들어, 다음 $add 표현식 MongoDB 6.1 에서 실행 때 이전 버전과 다른 결과를 반환합니다.

db.test.aggregate(
   [
     {
        $project: {
           sumOfValues: {
              $add: [ 0.1, 0.2, 0.3 ]
           }
         }
      }
   ]
)

MongoDB 6.1 이상 출력:

[
  {
    _id: ObjectId("6390f8085425651d8d0ef0a7"),
    sumOfValues: 0.6000000000000001
  }
]

MongoDB 6.0 및 이전 출력:

[
  {
    _id: ObjectId("6390f8085425651d8d0ef0a7"),
    sumOfValues: 0.6
  }
]

자동 청크 분할 없음

MongoDB 6.0.3부터 자동 청크 분할이 수행되지 않습니다. 이는 밸런싱 정책 개선 때문입니다. 자동 분할 명령이 여전히 존재하지만 작업을 수행하지 않습니다.

MongoDB 6.1 부터 다음 자동 분할 명령은 작업을 수행하지 않습니다.

• sh.enableAutoSplit()

• sh.disableAutoSplit()

제거된 옵션

MongoDB 6.1부터는 저널링이 항상 활성화됩니다. 결과적으로 MongoDB는 storage.journal.enabled 옵션과 해당 --journal 및 --nojournal 명령줄 옵션을 제거합니다.

MongoDB 6.1 부터 SNMP가 제거됩니다. 모든 관련 명령줄 옵션으로 인해 mongod 가 시작되지 않습니다. 배포서버 모니터 하려면 MongoDB Ops Manager 사용합니다.

MongoDB 서버 매개변수

MongoDB 부터 6.1 의 기본값 coordinateCommitReturnImmediatelyAfterPersistingDecision 은 false 입니다.

샤딩 지표 변경 사항

currentOp.opStatus MongoDB 6.1의 리샤딩 지표 에서 제거되었습니다.

버킷 컬렉션 네임스페이스에서 허용되지 않는 보기

time series 버킷 컬렉션 네임스페이스 (즉, 접두사가 붙은 컬렉션 system.buckets)에서는 뷰를 만들 수 없습니다.

이전 버전에서 MongoDB 6.1 으로 업그레이드하는 경우 system.buckets 컬렉션에 생성된 모든 뷰를 삭제해야 합니다.