MongoDB 8.2릴리스 노트

8.2.3 - 2025년 12월 19일

수정된 문제:

• 서버-115508: 압축되지 않은 메시지에 대해 최소 크기의 버퍼를 만듭니다.

• 8.2.3 변경 로그

8.2.2 - 2025년 11월 19일

수정된 문제:

• 서버-103774: 복합 와일드카드 인덱스를 샤드 키 인덱스로 사용을 허용하지 않습니다.

• 서버-105047: 샤딩된 컬렉션에서 $or 및 $ne 를 사용하는 쿼리에는 고아 문서가 포함될 수 있습니다.

• 서버-110423: $group 는 null 또는 missing 값이 있는 결과를 제외하는 희소 인덱스에 고유 스캔을 사용할 수 있습니다.

• 서버-110916: targetShardsAndAddMergeCursors()에서 이동 후 사용 문제를 해결합니다.

• 서버-112467: 보류 중인 프록시 연결 수를 추적하고 보고합니다.

• 서버-112520: 기존 timeseries 버킷에 문서 삽입할 때 지리적 인덱스 에 쓰기 (write) 실패

• 8.2.2에서 모든 JIRA 문제가 종료됨

• 8.2.2 변경 로그

8.2.1 - 2025년 10월 3일

수정된 문제:

• 서버-94681: 샘플링을 oplog cap 유지 관리자 스레드로 이동합니다.

• 서버-106469: 최신 빌드, Windows에서 mongocryptd 시작이 실패합니다.

• 서버-108565: Time Series 컬렉션에 대한 대규모 쓰기 (write) 처리를 개선합니다.

• 서버-109626: 변경 스트림에서 추가 필드를 내보내는 동작 조정

• 서버-110250: 유출 WT ID 삭제 시 기존 세션 사용

• WT-15225: 새로 생성된 테이블 및 제거하다() EBUSY 문제 수정

• 8.2.1에서 모든 JIRA 문제가 종료됨

• 8.2.1 변경 로그

endpointSecondaryReadsOnOrphanCleanup 매개변수

MongoDB 8.2 은 청크 마이그레이션 후 고아 문서 삭제되기 terminateSecondaryReadsOnOrphanCleanup 전에 세컨더리 노드에서 장기 실행 읽기 작업이 자동으로 종료되는지 여부를 제어하는 매개 변수를 추가합니다.

기본값 으로 이 매개변수는 true로 설정하다 됩니다. 청크 마이그레이션 커밋되기 전에 세컨더리 노드 에서 읽기 작업이 시작되면 MongoDB 고아 문서를 삭제하기 전에 작업을 자동으로 종료합니다. 8.2 이전의 MongoDB 버전에서는 이러한 작업이 고아 문서 삭제한 후에도 계속 실행되며 오류를 반환하지 않고 문서를 조용히 놓칠 수 있습니다.

이 새로운 동작을 지원 위해 orphanCleanupDelaySecs 의 기본값 은 이제 3600 (이전의 900)입니다.

초기 동기화 중 인덱스 빌드

MongoDB 8.2부터 초기 동기화 중 인덱스 빌드는 기본값으로 사용 가능한 RAM의 10%를 사용합니다. MongoDB initialSyncIndexBuildMemoryPercentage 매개변수와 함께 사용할 메모리의 다른 비율을 지정할 수 있습니다.

기본값 으로 사용 가능한 메모리 양은 200 MB에서 16 GB 사이여야 합니다. 다음 매개변수를 사용하여 메모리 사용량에 대한 다양한 최소 및 최대 임계값을 지정할 수 있습니다.

• initialSyncIndexBuildMemoryMinMB

• initialSyncIndexBuildMemoryMaxMB

쿼리 통계

MongoDB 8.2부터 $queryStats 출력에는 연체 티켓에 대한 다음 지표 포함됩니다.

• metrics.delinquentAcquisitions

• metrics.totalAcquisitionDelinquencyMillis

• metrics.maxAcquisitionDelinquencyMillis

MongoDB 획득 시간이 너무 오래 걸리면 실행 티켓 연체로 간주합니다.

WiredTiger 캐시 크기 구성(백분율)

MongoDB 8.2부터는 새로운 백분율 기반 옵션을 사용하여 WiredTiger 내부 캐시 크기를 구성할 수 있습니다. 기존 --wiredTigerCacheSizeGB 및 storage.wiredTiger.engineConfig.cacheSizeGB 기가바이트 기반 설정 외에도 이제 --wiredTigerCacheSizePct 및 storage.wiredTiger.engineConfig.cacheSizePct 옵션을 사용하여 캐시 크기를 사용 가능한 메모리의 백분율로 지정할 수 있습니다.

새로운 불일치 유형: 범위 삭제 누락된 샤드 키 인덱스

MonogDB 8.2부터 새로운 불일치 유형 RangeDeletionMissingShardKeyIndex 가 구현되었습니다. 불일치 유형은 컬렉션 샤드 키 와 호환되는 인덱스 없는 샤딩된 컬렉션 존재하며 완료해야 할 범위 삭제 작업 하나 이상 남아 있음을 나타냅니다.

새 애그리게이션 표현식

MongoDB 8.2부터는 $currentDate 를 aggregate() 와 함께 사용하여 서버의 현재 시간을 반환할 수 있습니다.

새 $currentOp 필드

$currentOp 집계 단계에는 이제 작업의 versionContext 기능 호환성 버전(FCV) 에 대한 정보를 제공하는 필드 포함됩니다.

serverStatus 출력 변경

serverStatus 출력에 다음과 같은 새로운 필드가 포함됩니다.

• metrics.operation.killedDueToRangeDeletion

• metrics.query.bucketAuto.spilledBytes

• metrics.query.bucketAuto.spilledDataStorageSize

• metrics.query.bucketAuto.spilledRecords

• metrics.query.bucketAuto.spills

• planCache.classic.replanned_plan_is_cached_plan

• planCache.sbe.replanned_plan_is_cached_plan

• spillWiredTiger

• connections.queuedForEstablishment

• connections.establishmentRateLimit

• connections.establishmentRateLimit.rejected

• connections.establishmentRateLimit.exempted

• connections.establishmentRateLimit.interruptedDueToClientDisconnect

• metrics.network.averageTimeToCompletedTLSHandshakeMicros

• metrics.network.averageTimeToCompletedHelloMicros

• metrics.network.averageTimeToCompletedAuthMicros

• queues.ingressSessionEstablishment

• queues.ingressSessionEstablishment.addedToQueue

• queues.ingressSessionEstablishment.removedFromQueue

• queues.ingressSessionEstablishment.interruptedInQueue

• queues.ingressSessionEstablishment.rejectedAdmissions

• queues.ingressSessionEstablishment.exemptedAdmissions

• queues.ingressSessionEstablishment.successfulAdmissions

• queues.ingressSessionEstablishment.attemptedAdmissions

• queues.ingressSessionEstablishment.averageTimeQueuedMicros

• queues.ingressSessionEstablishment.totalAvailableTokens

디스크 유출 단계에 대한 출력 설명

MongoDB 부터 디스크로 8.2 유출되는 단계에 대한 결과 설명에 이제 일관적인 필드 이름 아래에 표준화된 지표 포함됩니다. 이 업데이트 메모리 집약적인 작업에 대한 디스크 사용량을 추적 보다 통합된 방법을 제공합니다.

새로운 필드는 다음과 같습니다.

• 유출

• spilledBytes

• spilledRecords

• spilledDataStorageSize

유효성 검사 출력의 복구 모드 필드

MongoDB 8.2 부터 validate 명령과 db.collection.validate() 헬퍼 repairMode 메서드는 validate 명령이 복구하려고 시도한 데이터 불일치 유형을 나타내는 새로운 필드 반환합니다.

zstd 빠른 압축 지원

MongoDB 8.2부터는 storage.wiredTiger.engineConfig.zstdCompressionLevel 설정은 빠른 zstd 압축을 위해 음수 값을 지원합니다. 음수 값은 압축률을 비용 하여 더 빠른 압축 및 압축 해제 속도를 제공합니다. 새로 지원되는 범위 는 -7 ~ 22입니다.

타깃 미러링된 읽기

MongoDB 8.2부터는 읽기 미러링을 위해 노드에 태그를 지정하여 캐시 워밍업이 필요한 특정 서버에 읽기 작업을 선택적으로 미러링할 수 있습니다. 일반 미러링된 읽기와 달리 타겟팅된 읽기 미러링을 사용하면 숨겨진 노드를 타겟팅하고 프라이머리 노드와 세컨더리 노드 모두에서 미러링할 수 있습니다.

mirrorReads매개변수의 targetedMirroring 필드 사용하여 타겟팅된 미러링 읽기를 구성할 수 있습니다.

속도 제한 수신 연결 설정

MongoDB 8.2부터는 과부하 시 CPU 리소스를 보존하기 위해 수신 연결에 대한 속도 제한을 활성화 할 수 있습니다. 활성화하면 수신 연결 속도가 지정된 연결 설정 속도를 초과하는 시점을 확인하고 MongoDB deployment 초과 연결을 처리하는 방법을 지정하는 매개 변수를 구성할 수 있습니다.

다음과 같은 새로운 필드를 사용하여 속도 제한을 구성할 수 있습니다.

• ingressConnectionEstablishmentRateLimiterEnabled

• ingressConnectionEstablishmentRatePerSec

• ingressConnectionEstablishmentBurstCapacitySecs

• ingressConnectionEstablishmentMaxQueueDepth

Queryable Encryption 접두사, 접미사 및 하위 문자열 쿼리 공개 미리 보기

MongoDB 8.2 을 사용하면 Queryable Encryption 활성화된 컬렉션의 암호화됨 문자열 필드에 접두사, 접미사 및 하위 문자열 쿼리를 활성화 할 수 있습니다. 자세한 내용은 하위 문자열 쿼리 활성화 및 지원되는 애그리게이션 표현식을 참조하세요.

mongosh와 함께 공개 미리 보기 접두사, 접미사 또는 하위 문자열 쿼리를 사용하려면 자동 암호화 공유 라이브러리 8.2 이상을 별도로 다운로드 다음 --cryptSharedLibPath 옵션을 사용하여 라이브러리 경로를 mongosh 로 지정해야 합니다.

쿼리 설정에 주석 추가

MongoDB 8.1 (및 8.0.4)부터 setQuerySettings 를 사용하여 쿼리 설정에 주석을 추가할 수 있습니다. 예시 쿼리 설정을 추가한 이유를 나타내는 댓글을 추가합니다.

집계 누산기

MongoDB 8.1부터 다음과 같은 집계 축적자를 사용할 수 있습니다.

• $concatArrays

• $setUnion

집계 단계

MongoDB 8.1부터는 다음과 같은 집계 단계를 사용할 수 있습니다.

• $listClusterCatalog

감사 로그 개선 사항

MongoDB 8.1부터 클라이언트 애플리케이션 로드 밸런서 통해 mongod 또는 mongos 인스턴스 에 연결하는 경우 원본 클라이언트 컴퓨터와 로드 밸런서 IP 주소 및 포트가 감사 로그 에 포함됩니다. 로그 사용하여 감사 이벤트 원본 클라이언트 컴퓨터와 일치시킬 수 있습니다.

자세한 내용은 OCSF 스키마 감사 메시지 및 Mongo 스키마 감사 메시지를 참조하세요.

connectionStatus 연결 UUID

MongoDB 8.1부터는 connectionStatus.authInfo.UUID를 통해 현재 연결된 클라이언트의 UUID에 액세스 할 수 있습니다.

디스크 공간

MongoDB 8.1 (및 8.0.5)부터 디스크 공간이 실행 하면 디스크로 유출되는 MongoDB 가 실패합니다.

$geoNear 개선 사항

MongoDB 8.1부터 숨겨진 2d 또는 2dsphere 인덱스를 사용하여 이전에 실패했던 일부 $geoNear 쿼리가 이제 성공합니다. 이전 릴리스에서는 일부 $geoNear 쿼리에 숨겨진 인덱스 포함할 때 사용할 인덱스 에 대한 혼동으로 인해 IndexNotFound 오류가 발생하면서 불필요하게 실패하는 경우가 있었습니다.

작업 기간 지표의 정확도 개선

MongoDB 부터 8.1 durationMillis 느린 쿼리 로그에 보고된 지표는 권한 부여 처리 하고 명령을 구문 분석하는 데 소요된 시간을 설명합니다. 결과적으로 durationMillis 는 전체 명령 지속 시간을 더 가깝게 반영합니다.

불일치 유형

MongoDB 8.1부터 다음과 같은 불일치 유형을 사용할 수 있습니다.

• CollectionAuxiliaryMetadataMismatch

$lookup 암호화된 컬렉션 지원

MongoDB 8.1부터는 $lookup 단계에서 여러 개의 암호화됨 컬렉션을 참조할 수 있습니다.

자세한 내용은 다음을 참조하세요.

• 암호화된 컬렉션을 사용한 $lookup

• 자동 암호화를 위해 지원되는 작업

• Queryable Encryption에 지원되는 작업

$merge 누락된 필드

MongoDB 8.1부터 $merge 집계 단계의 지원 인덱스 희소(sparse)하지 않은 경우, on 옵션에 지정된 필드가 누락되거나 null 값을 포함할 수 있습니다.

쿼리 통계

MongoDB 8.1부터 count 및 distinct 명령에 대한 쿼리 통계가 수집되고 보고됩니다. 자세한 내용은 카운트 명령 쿼리 형태 및 고유한 명령 쿼리 형태를 참조하세요.

MongoDB 서버 매개변수

MongoDB 8.1부터는 다음과 같은 서버 매개 변수를 사용할 수 있습니다.

• enableAutoCompaction

• upsertMaxRetryAttemptsOnDuplicateKeyError

• AbortExpiredTransactionsSessionCheckoutTimeout (8.0.13에서도 사용 가능합니다)

• JWKSMinimumQuiescePeriodSecs

• catalogCacheCollectionMaxEntries

• catalogCacheDatabaseMaxEntries

• catalogCacheIndexMaxEntries

• wiredTigerSessionMax

serverStatus 지표

MongoDB 8.1 (및 8.0.4, 7.0.14, 6.0.20)부터serverStatus명령 출력의indexStats섹션은 prepareUnique 상태 의 인덱스를 추적합니다.

MongoDB 8.1 은 다음과 같은 서버 상태 지표 을 추가합니다.

• maxTimestampEligibleForTruncate 인 changeStreamPreImages.purgingJob

• metrics.ttl.invalidTTLIndexSkips

• metrics.repl.timestamps

• metrics.repl.timestamps.oldestTimestamp

• query.planning.fastPath.express

• query.planning.fastPath.idHack

• metrics.abortExpiredTransactions.successfulKills (8.0.13에서도 사용 가능합니다)

• metrics.abortExpiredTransactions.timedOutKills (8.0.13에서도 사용 가능합니다)

• wiredTiger.version

디스크 유출에 대한 느린 쿼리 지표

MongoDB 8.1부터 쿼리 실행이 임시 파일을 디스크에 쓰는 경우 느린 쿼리에 대한 로그 메시지 에 새로운 지표 포함됩니다. 이러한 지표 앞에는 쿼리 메모리 제한을 초과하게 만든 쿼리 실행 단계가 붙습니다. 예시 를 들어 sortSpills 는 쿼리 실행의 정렬 단계에서 임시 파일을 디스크에 쓴 횟수를 나타냅니다.

디스크에 임시 파일 쓰기에 대한 자세한 내용은 allowDiskUse()를 참조하세요.

Stable API

MongoDB 8.1부터 renameCollection 명령과 해당 셸 메서드인 db.collection.renameCollection()이(가) Stable API V1에 포함되었습니다.

Explain 결과에서 검색 단계 지원

MongoDB 8.1부터 설명 결과 에는 $search, $searchMeta 및 $vectorSearch 단계에 대한 실행 통계가 포함됩니다.

자세한 내용은 다음을 참조하세요.

• 검색 쿼리에 대한 실행 계획 통계

• 검색 결과 설명

• MongoDB Vector Search 결과 설명

뷰에서 검색 인덱스 명령 지원

MongoDB 부터는,,8.1 및dropSearchIndex 를 실행updateSearchIndex 다음 $listSearchIndexes 항목만 포함하는 호환되는 표준 뷰에서 Atlas Search 인덱스 createSearchIndexes 및 Atlas Vector Search 인덱스를 생성, 수정, 삭제 및 나열할 수 있습니다. 다음 단계:

• $addFields

• $set

• $match 가 $expr 연산을 래핑하는 중입니다.

검색 인덱스 사용하는 뷰에서 $search 및 $searchMeta 단계가 포함된 집계 파이프라인을 실행 수 있습니다. 벡터 검색 인덱스 포함된 뷰에서 $vectorSearch 단계가 포함된 집계 파이프라인을 실행 수도 있습니다.

명령 인덱스 사양 출력 유효성 검사

MongoDB 8.1부터 validate 명령은 validate.indexDetails 출력 필드에 인덱스 사양을 포함합니다.

유효하지 않은 문서 처리를 위한 유효성 검사 작업

MongoDB 8.1부터는 스키마의 validationAction 옵션을 errorAndLog로 설정하다 수 있으며, 이 경우 MongoDB 유효성 검사 기준을 위반하는 모든 삽입 또는 업데이트 거부하고 mongod 로그 파일 에 오류를 기록합니다.

자세한 내용은 유효하지 않은 문서 처리 방법 선택을 참조하세요.

단일 버전 다운그레이드만 지원됩니다.

MongoDB는 단일 버전 다운그레이드만 지원합니다. 현재 릴리스보다 이전 버전인 릴리스로 다운그레이드할 수 없습니다.

예시 들어 8.2시리즈를 8.0시리즈 배포서버 로 다운그레이드할 수 있습니다. 그러나 해당 8.0시리즈 배포서버 7.0시리즈 배포서버 로 한 단계 더 다운그레이드하는 것은 지원되지 않습니다.

다운그레이드 정책

• 바이너리 다운그레이드는 MongoDB Community Edition 에서 지원되지 않습니다.

• 배포서버의 FCV MongoDB 의 마이너 출시하다 버전으로 또는 그 반대로 다운그레이드할 수 없습니다.

• 배포의 fCV를 업그레이드하거나 다운그레이드하는 경우 지원팀의 지원 없이는 Enterprise 배포의 2진법 버전을 다운그레이드할 수 없습니다.