MongoDB 8.3릴리스 노트

8.3.3 - 출시 예정

수정된 문제:

• 서버-115250 정지 시간 동안 JWKSetRefreshJob을 일시 중지합니다.

• 서버-121822 클러스터형 컬렉션이 $lt 에서 을(를) 사용하여 결과를 올바르게 필터하다 하지 못합니다._id

• 서버-125887 gRPC 송신을 위한 암호화됨 PEM 풀에 대한 지원 추가

• 서버-126049 MozJS 범위별 힙 제한 검사에서 프로세스 전역 GC 카운터 사용

• WT- 의16780 WT_PANIC 체크포인트 실패에서 오류 컨텍스트가 충분하지 않습니다.__wt_block_checkpoint_resolve

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

• 8.3.3 변경 로그

8.3.2 - 2026년 5월 12일

수정된 문제:

• 서버-126021 시계열 컬렉션에 필드 이름이 중복된 데이터를 삽입할 때 정의되지 않은 동작입니다.

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

• 8.3.2 변경 로그

8.3.1 - 2026년 5월 4일

수정된 문제:

• 서버-121610 캐시된 emit() 호출이 작동하지 않는지 확인합니다.

• 서버-121895 유효성 검사 오류 편집 개선

• 서버-124974 $match 푸시다운 분석 중 메모리 수명 보장

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

• 8.3.1 변경 로그

8.3.0 - 2026년 5월 4일

$map, $ 필터하다, $reduce에서 배열 요소 인덱스에 액세스하기

MongoDB 8.3 은 $map, $filter 및 $reduce 집계 표현식에서 배열 요소 인덱스에 대한 액세스 개선합니다. 새 arrayIndexAs 필드 사용하여 배열 요소의 인덱스 를 저장 변수를 설정하다 수 있습니다. arrayIndexAs를 생략한 경우 새로운 $$IDX 집계 시스템 변수를 사용하여 현재 배열 요소의 인덱스에 액세스 할 수도 있습니다.

FTDC 통계

MongoDB 8.3부터는 FTDC(FullTime Diagnostic connPoolStats Data Capture)는 프로세스에 mongod 대한 지표 수집합니다.

serverStatus 출력

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

• aggregate.withExtension metrics.commands.aggregate의 하위 필드, 성공 및 실패 횟수 추적

• shardingStatistics.databaseCriticalSectionStatistics

• shardingStatistics.collectionCriticalSectionStatistics

• shardingStatistics.databaseVersionUpdateCounters

• metrics.ttl.deletedKeys

• metrics.ttl.durationMicros

• metrics.ttl.examinedDocuments

• metrics.ttl.examinedKeys

• metrics.extension

• metrics.extension.totalAggStageExecMicros

• metrics.extension.apiCallSuccesses

• metrics.extension.apiCallFailures

• metrics.extension.vectorSearch

• metrics.extension.vectorSearch.legacyVectorSearchUsed

• metrics.extension.vectorSearch.extensionVectorSearchUsed

• metrics.extension.vectorSearch.onViewKickbackRetries

• metrics.extension.vectorSearch.inSubpipelineKickbackRetries

• metrics.repl.network.oplogFetcherLagSeconds

• metrics.repl.network.oplogGetMoresProcessed

• queues.execution.admissions

• queues.execution.backgroundTasksDeprioritization

• queues.execution.deprioritizationGate

• queues.execution.heuristicDeprioritization

• queues.execution.heuristicDeprioritizationThreshold

• queues.execution.totalDeprioritizations

• queues.execution.usesPrioritization

• queues.execution.usesThroughputProbing

• queues.execution.nonDeprioritizable

• queues.execution.deprioritizable

• queues.execution.read.normalPriority.totalDelinquentAcquisitions

• queues.execution.read.normalPriority.totalAcquisitionDelinquencyMillis

• queues.execution.read.normalPriority.maxAcquisitionDelinquencyMillis

• queues.execution.read.lowPriority

MongoDB 8.3 이 serverStatus 출력에서 service 필드 제거합니다.

MongoDB 8.3부터는 none: 1를 지정하여 serverStatus 출력에서 모든 선택적 필드를 제외할 수 있습니다. 선택적 필드를 모두 제외한 후 포함할 필드를 지정할 수 있습니다.

자세한 내용은 모든 선택 사항 필드 제외를 참조하세요.

선택적으로 serverStatus 명령에 lockContentionMetrics: 1 를 지정하여 출력에 lockContentionMetrics 를 포함할 수도 있습니다.

string 변환 개선 사항

MongoDB 8.3부터 $toString 는 객체, 배열, 정규 표현식, MaxKeys, MinKeys 및 타임스탬프를 포함한 추가 BSON types를 문자열로 변환할 수 있습니다. 자세한 내용은 $toString를 참조하세요.

MongoDB 8.3 은 $convert 에 대한 선택적 base 인수를 도입하여 2, 8, 10 및 16 진수를 사용하여 문자열과 숫자 값을 변환합니다. 자세한 내용은 $convert를 참조하세요.

배열 변환 개선 사항

MongoDB 8.3부터는 $convert 또는 약식 표현식 $toArray을 사용하여 배열을 나타내는 문자열을 변환할 수 있습니다.

binData 와(과) 숫자 값 배열 간에 변환할 수도 있습니다. 자세한 내용은 binData를 배열로 변환 및 숫자 값 배열을 binData로 변환을 참조하세요.

객체 변환 개선 사항

MongoDB 8.3부터는 $convert 또는 약식 표현식 $toObject을 사용하여 객체를 나타내는 문자열을 변환할 수 있습니다.

지리 공간적 인덱스 생성

MongoDB 8.3부터 문서 에 GeoJSON 과 레거시 숫자 좌표 필드가 모두 포함된 경우 지리 공간적 인덱스 생성은 GeoJSON 좌표를 우선시합니다.

문서에 GeoJSON 좌표 앞에 오는 레거시 숫자 좌표 값이 포함되어 있고 기존 인덱스가 해당 동작을 사용하는 경우, 지리 공간적 인덱스를 다시 작성해야 할 수 있습니다.

문서에 GeoJSON 좌표 앞에 오는 레거시 숫자 좌표 값이 포함되어 있고 기존 인덱스가 해당 동작을 사용하는 경우, 이 변경으로 인해 지리 공간적 인덱스를 다시 작성해야 할 수 있습니다. 지리 공간적 쿼리를 검토하여 예상 결과를 반환하는지 확인합니다.

샤드 변경 사항 제거

MongoDB 8.3부터 removeShard 명령은 더 이상 사용되지 않습니다. 이 출시하다 에서는 4개의 새로운 명령이 도입되어 removeShard 를 대체하고 샤드 배출 및 제거 프로세스 세부적으로 제어할 수 있습니다.

• startShardDraining

• stopShardDraining

• shardDrainingStatus

• commitShardRemoval

MongoDB 내장된 config 서버 에서 전용 config 서버 로 전환하기 위한 네 가지 추가 명령을 제공합니다.

• startTransitionToDedicatedConfigServer

• stopTransitionToDedicatedConfigServer

• getTransitionToDedicatedConfigServerStatus

• commitTransitionToDedicatedConfigServer

사전 인증 연결 제한 매개변수

MongoDB 8.3 은 사전 인증 연결의 리소스 소비를 제한하는 세 가지 새로운 서버 매개 변수를 추가합니다.

• capMemoryConsumptionForPreAuthBuffers

• messageSizeErrorRateSec

• preAuthMaximumMessageSizeBytes

cachePressureQueryPeriodMilliseconds 매개변수

MongoDB 8.3 은( 스토리지 엔진 캐시 압력 확인 사이에 MongoDB 대기하는 시간 간격을 설정하는 cachePressureQueryPeriodMilliseconds 매개 변수를 추가합니다. 스토리지 엔진 캐시 압박을 받으면 MongoDB 가장 오래된 트랜잭션 중단합니다. 자세한 내용은 cachePressureQueryPeriodMilliseconds를 참조하세요.

진단DataCollectionDirectorySizeMB 매개변수

MongoDB 8.3 은 diagnosticDataCollectionDirectorySizeMB 의 기본값을 200 에서 500 MiB로 늘립니다.

과부하AwareServerSelectionEnabled 매개변수

MongoDB 8.3 은 클러스터 의 다른 서버를 대상으로 하는 재시도가 최근에 SystemOverloadedError 레이블이 지정된 오류를 반환한 멤버를 피하는지 여부를 제어하는 overloadAwareServerSelectionEnabled 매개 변수를 추가합니다. 이 매개변수를 활성화 과부하 인식 리타게팅을 옵트인할 수 있습니다.

ingressRequestRateLimiterApplicationExemptions Parameter

MongoDB 8.3부터 ingressRequestRateLimiterApplicationExemptions 매개 변수를 사용하면 수신 요청 속도 제한에서 면제할 애플리케이션을 지정할 수 있습니다. 자세한 내용은 ingressRequestRateLimiterApplicationExemptions를 참조하세요.

데이터베이스 프로파일러 매개변수 및 지표

MongoDB 8.3 에는 데이터베이스 프로파일러 가 쿼리 성능에 미치는 영향 제어할 수 있는 두 개의 매개 변수가 추가되었습니다.

• internalQueryGlobalProfilingLockDeadlineMs

• internalProfilingMaxAbandonedWritesPerSecondPerDb

MongoDB 8.3 은 또한 두 가지 관련 serverStatus 지표 추가합니다.

• profiler.totalAbandonedWrites

• profiler.dbsPastThreshold

재시도 매개변수

MongoDB 8.3 은(는) 과부하로 인해 실패한 작업을 다시 시도할 때 내부 서버 측 클라이언트(mongos ~ mongod)가 어떻게 백오프하는지 구성하는 매개 변수를 추가했습니다.

• defaultClientBaseBackoffMillis

• defaultClientMaxBackoffMillis

• defaultClientRetryAttempts

• shardRetryTokenBucketCapacity

• shardRetryTokenReturnRate

업서트 오류에 대한 BSONObjectTooLarge 코드

8.3부터, 너무 큰 BSON 객체 생성하는 업서트 작업은 10334 BSONObjectTooLarge 오류 코드를 반환합니다. 이전 버전에서는 너무 큰 BSON 객체 생성하는 업서트 작업이 17419 또는 17420 오류 코드를 반환했습니다.

명령 업데이트 유효성 검사

8.3부터 시작, full 이 true인 경우 MongoDB 더 이상 db.collection.validate() 메서드의 checkBSONConformance 필드 자동으로 활성화하지 않습니다. 또한 db.collection.validate() 메서드는 이제 컬렉션 에 16 MB를 초과하는 문서가 없는지 확인합니다.

새 표현식 $subtype

MongoDB 8.3 은 binary 데이터 객체의 하위 유형을 추출하는 새로운 $subtype 표현식 도입합니다.

확장 JSON 변환을 위한 새로운 표현식

MongoDB 8.3 은 BSON 과 확장 JSON (EJSON) 형식 간 변환을 위한 새로운 집계 표현식을 도입합니다.

• $serializeEJSON - 유형 래퍼를 사용하여 BSON 값을 확장 JSON 형식으로 변환합니다. Canonical 및 Relaxed Extended JSON 형식을 모두 지원합니다.

• $deserializeEJSON - 확장 JSON 형식을 네이티브 BSON 값으로 다시 변환합니다.

이러한 표현식을 $convert 와 결합하여 JSON 문자열을 구문 분석하고, 확장 JSON 값을 네이티브 BSON 값으로 변환하고, JSON 형식으로 다시 변환할 수 있습니다.

새 표현식 $createObjectId

MongoDB 8.3부터는 $createObjectId 를 사용하여 파이프라인 및 표현식 기반 업데이트에서 새로운 임의의 ObjectId() 값을 생성할 수 있습니다.

새로운 해싱 표현식

MongoDB 8.3 은 UTF-8 문자열 또는 binary 데이터에서 해시를 생성하기 위한 두 가지 새로운 집계 표현식을 도입했습니다.

• $hash - MD5, SHA-256 또는 XXH64를 사용하여 UTF-8 string 또는 binary 데이터에서 BinData 해시 값을 생성합니다.

• $hexHash - MD5, SHA-256 또는 XXH64를 사용하여 UTF-8 string 또는 binary 데이터에서 대문자 16진수 문자열 해시를 생성합니다.

New $meta Keyword

MongoDB 8.3 은 표현식 에 새로운 "searchRootDocumentId" 키워드를 $meta 도입합니다. 이 키워드를 사용하여 결과 설정하다 _id 에 내장된 문서에 대한 루트 문서 의 값을 반환할 $search 수 있습니다. 자세히 학습 searchRootDocumentId를 참조하세요.

유닉스 시간 이전 날짜

MongoDB 8.3부터 $dateAdd 또는 $dateSubtract 에서 unit 이(가) "millisecond" 이(가) 아니고 input 날짜가 ISODate("1970-01-01T00:00:00Z") 이전인 경우 결과는 이전 버전의 MongoDB 보다 1초 더 커집니다. 이는 $setWindowFields 및 $densify와 같은 시간 기반 계산을 수행하는 집계 결과에도 영향을 미칩니다.

지리 공간적 인덱스 생성

MongoDB 8.3은 MongoDB 8.2에 도입된 동작을 계속합니다. document 에 GeoJSON 및 레거시 숫자 좌표 필드가 모두 포함된 경우 지리 공간적 인덱스 생성은 GeoJSON 좌표를 우선시합니다.

문서에 GeoJSON 좌표 앞에 오는 레거시 숫자 좌표 값이 포함되어 있고 기존 인덱스가 해당 동작을 사용하는 경우, 지리 공간적 인덱스를 다시 작성해야 할 수 있습니다.

문서에 GeoJSON 좌표 앞에 오는 레거시 숫자 좌표 값이 포함되어 있고 기존 인덱스가 해당 동작을 사용하는 경우, 이 변경으로 인해 지리 공간적 인덱스를 다시 작성해야 할 수 있습니다. 지리 공간적 쿼리를 검토하여 예상 결과를 반환하는지 확인합니다.

$convert 파이프라인의 비정규 숫자

MongoDB 8.3부터 서버 표현 가능한 모든 double 정밀도 부동 점 숫자의 전체 범위 구문 분석할 수 있습니다. 여기에는 최상위 숫자 앞에 0이 있고 지수가 가능한 가장 작은 값을 갖는 비정규 숫자 가 포함됩니다.

자세한 내용은 비정규 숫자를 참조하세요.

chars $trim, $ltrim 및 $rtrim의 길이 제한

MongoDB 8.3부터 chars 에 제공하는 문자열의 길이는 4096 자로 제한됩니다. 자세한 내용은 $trim 제한 사항을 참조하세요.

기간 기능

Starting in MongoDB 8.3, you can use $mergeObjects in $setWindowFields 작업.

.sp. 프로세스() limit 옵션

Starting in MongoDB 8.3, sp.process() supports the options.limit input parameter. sp.process() 가 limit 문서를 터미널에 반환하면 세션이 종료됩니다.

쿼리 엔진의 텍스트 검색 유출

MongoDB 8.3부터 쿼리 엔진 TextOr 단계 메모리 사용량을 100 메가바이트로 제한합니다. TextOr 단계는 텍스트 점수 메타데이터 읽는 $text 쿼리를 처리합니다. 예시 를 들어 TextOr 는 텍스트 점수를 기준으로 결과를 정렬하는 쿼리를 처리합니다. TextOr 단계가 이 제한을 초과하는 경우:

• allowDiskUse 가 true인 경우 단계에서 중간 결과를 디스크로 유출합니다.

• allowDiskUse 가 false인 경우 메모리 제한 초과 오류와 함께 쿼리 실패합니다.

이전 버전에서는 TextOr 단계에 메모리 제한이 없었고 제한 없이 RAM 사용하여 메모리 부족(OOM) 오류가 발생할 위험이 있었습니다.

chars $trim, $ltrim 및 $rtrim의 길이 제한

MongoDB 8.3부터 chars 에 제공하는 문자열의 길이는 4096 자로 제한됩니다. 자세한 내용은 $trim 제한 사항을 참조하세요.

샤드 클러스터에 대한 DDL 작업은 mongos 에서만 실행할 수 있습니다.

MongoDB 8.3부터는 모든 샤딩된 클러스터에 대해 mongos 에서 DDL 작업 과 applyOps 만 실행 수 있습니다. 이러한 작업은 복제본 세트 에서 샤딩된 클러스터 로 전환하는 동안 일시적으로 사용하지 못할 수 있습니다.

findShardsOnConfigTimeoutMS Parameter

MongoDB 8.3 은 config.shards 네임스페이스 에 대한 find 작업의 시간 제한을 밀리초 단위로 설정하는 findShardsOnConfigTimeoutMS 매개 변수를 추가합니다. 자세한 내용은 findShardsOnConfigTimeoutMS를 참조하세요.

config.csrs.인덱스 제거됨

MongoDB 8.3 은 config.csrs.indexes 네임스페이스 를 제거합니다.

2dsphereIndexVersion

MongoDB 8.3부터 2dsphereIndexVersion 은 기본값 으로 버전 4 로 설정하다 됩니다.

기능 호환성 버전 8.3 미만으로 다운그레이드해야 하는 경우, 먼저 2dsphere 버전 4 인덱스를 삭제해야 합니다.

mongos 기반 쿼리에 대한 샤드 쿼리 통계

MongoDB 8.3부터 샤드 서버는 queryStats 가 활성화된 경우 쿼리 통계에 mongos 에서 시작된 쿼리를 포함합니다. 이전에는 mongos 에서 샤드로 전달된 대부분의 쿼리가 샤드 수준 쿼리 통계에 나타나지 않아 샤드 수준 진단의 완전성이 저하되었습니다.

샤드 클러스터로 변환

MongoDB 8.3부터는 이전에 클러스터를 샤딩된 복제본 세트를 복제본 세트로 다시 변환할 수 없습니다.

샤딩된 클러스터 를 복제본 세트 로 변환하면 샤드 ID document 포함하여 이전 배포서버 의 샤딩 메타데이터 보존되어 다시 샤딩된 클러스터 되는 것을 차단합니다. 샤딩된 클러스터 로 자체 관리형 변환을 다시 시도하면 MongoDB 오류를 반환합니다.

이러한 복제본 세트를 샤딩된 클러스터로 변환하려면 기술 지원팀에문의 .

임베디드 구성 샤드로 변환

MongoDB 8.3 에는 mongod --replicaSetConfigShardMaintenanceMode 옵션이 도입되었습니다.

이전 릴리스에서는 복제본 세트 내장된 구성 샤드 가 있는 샤딩된 클러스터 로 변환하려면 먼저 전용 구성 config 서버 복제본 세트 가 있는 샤딩된 클러스터 로 마이그레이션 해야 했습니다.

--replicaSetConfigShardMaintenanceMode 및 --configsvr 옵션을 사용하여 복제본 세트 다시 시작하면 프라이머리 노드 내장된 구성 샤드 로 직접 변환할 수 있습니다.

자세한 내용은 복제본 세트를 임베디드 구성 샤드로 변환을 참조하세요.

RefineCollectionShardKey 서식 지정

MongoDB 8.3부터 time-series 컬렉션의 refineCollectionShardKey 는 컬렉션의 논리적 메타 및 시간 필드를 사용하여 지정된 샤드 키만 허용합니다. MongoDB 더 이상 기본 버킷 형식을 사용한 키 지정을 지원하지 않습니다.

인덱스 이름 지정 제한

MongoDB 8.3부터 이름이 "_id_" 인 인덱스 만들거나 time series 컬렉션에 "_id_" 힌트를 지정하면 오류가 반환됩니다.

timeField 이름 지정 제한

MongoDB 8.3부터는 $ 문자로 시작하는 timeField 를 생성할 수 없습니다.

쿼리별 메모리 사용을 추적하는 필드

MongoDB 8.3부터는 다음과 같은 새로운 필드를 사용하여 쿼리 메모리 사용을 추적 할 수 있습니다.

두 필드 모두 다음 위치에 표시됩니다.

• $currentOp(집계 단계) 출력

• db.currentOp() 출력

• Database profiler output

• 로그 메시지

• 느린 쿼리 로그 메시지

peakTrackedMemBytes 필드 다음 위치에도 나타납니다.

• 결과 설명

• PlanCache.list() 출력

• $planCacheStats 출력

8.3부터는 $queryStats 에서 다음과 같은 새로운 지표 사용하여 checkForInterrupt의 동작을 측정합니다.

• metrics.numInterruptChecksPerSec

• metrics.overdueInterruptApproxMaxMillis

Mongos 쿼리 형태 필드

MongoDB 8.3부터 느린 쿼리 로그 항목에는 mongos에서 시작되는 다음 작업의 쿼리 형태 포함하는 선택적 originalQueryShapeHash 필드 있습니다.

• find

• aggregate

• count

• distinct

느린 진행 중인 쿼리 로그

MongoDB 8.3 에는 느린 진행 중인 쿼리 로그 항목이 도입되었습니다. 진행 중인 느린 쿼리에 대한 로그 메시지에는 표준 느린 쿼리 로그보다 적은 정보가 포함됩니다. MongoDB 쿼리 기간이 slowOpInProgressThreshold를 초과하는 경우 쿼리를 최대 한 번만 기록합니다. db.setProfilingLevel() 또는 새로운 mongod --defaultSlowInProgMS 명령줄 옵션을 사용하여 임계값을 설정할 수 있습니다.

샤딩된 클러스터

MongoDB 8.3부터 샤딩된 클러스터 에 존재하지 않는 데이터베이스 에 대해 explain() 를 실행 실행 단계가 스트림 끝에 도달하고 작업으로 데이터베이스 생성되지 않습니다. 스트림 종료 실행 통계에 대한 자세한 내용은 explain.executionStats.executionStages.isEOF를 참조하세요.

SCRAM-SHA-1 및 FIPS 모드

MongoDB 8.3부터는 authenticationMechanisms 에 대해 SCRAM-SHA-1 를 지정하는 동시에 mongod --tlsFIPSMode 또는 mongos --tlsFIPSMode를 지정할 수 없습니다.

authenticationMechanisms 에 SCRAM-SHA-1 를 지정하면서 --tlsFIPSMode도 지정하려고 하면 서버 오류가 발생하고 다음과 유사한 메시지가 기록됩니다.

SCRAM-SHA-1 is not allowed in FIPS mode.

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

MongoDB 인접한 버전에 대한 단일 버전 다운그레이드만 지원합니다. 현재 출시하다 보다 이전 버전인 출시하다 로 다운그레이드할 수 없습니다.

• 메이저 버전이든 마이너 버전이든, 인접한 이웃 버전으로 업그레이드 하거나 다운그레이드할 수 있습니다. 예시 를 들어 8.3 에서 8.2 으로 다운그레이드하거나 7.0 에서 8.0으로 업그레이드 할 수 있습니다.

• 메이저 버전이든 마이너 버전이든 모든 버전에 대해 바로 이전의 메이저 버전으로 다운그레이드할 수 있습니다. 예시 들어 8.3 에서 8.0까지입니다.

• 모든 마이너 버전의 경우 바로 다음 버전으로 업그레이드 할 수 있습니다. 예시 들어 8.2 에서 8.3까지입니다.

이전 버전과 호환되지 않는 기능

MongoDB 8.3 에는 이전 릴리스와 호환되지 않는 기능이 포함되어 있습니다. 8.3 에서 이전 출시하다 로 다운그레이드하려면 이러한 기능을 사용하는 데이터를 제거 해야 합니다.

자세한 내용은 이전 버전과 호환되지 않는 기능을 참조하세요.