MongoDB 5.0의 호환성 변경 사항

플랫폼 지원

특정 명령은 인식된 매개변수만 허용합니다.

MongoDB 5.0부터 명령에서 명시적으로 허용하지 않는 매개 변수를 전달하면 특정 데이터베이스 명령에서 오류가 발생합니다. MongoDB 4.4 이하에서는 인식할 수 없는 매개변수는 자동으로 무시됩니다.

영향을 받는 명령:

• abortTransaction

• aggregate

• authenticate

• collMod

• commitTransaction

• create

• createIndexes

• delete

• drop

• dropDatabase

• dropIndexes

• endSessions

• explain

• find

• findAndModify

• getMore

• hello

• insert

• killCursors

• listCollections

• listDatabases

• listIndexes

• ping

• refreshSessions

• update

제거된 명령

MongoDB 5.0부터는 다음 데이터베이스 명령과 mongo 셸 헬퍼 메서드가 제거되었습니다.

제거된 매개변수

MongoDB 5.0은 다음 서버 매개변수를 제거합니다.

제거된 인덱스 유형

MongoDB 5.0 은 더 이상 사용되지 않는 geoHaystack 인덱스를 제거합니다. 대신 2d 인덱스 를 사용하세요.

MongoDB 인스턴스를 5.0으로 업그레이드하고 featureCompatibilityVersion을 5.0 로 설정하면 기존의 모든 geoHaystack 인덱스가 삭제됩니다.

제거된 지표

MongoDB 5.0부터 명령은 serverStatus opReadConcernCounters 쿼리 조작에 의해 지정된 읽기 우려 레벨 이 포함된 출력하지 않습니다. 대신 새 readConcernCounters이 opReadConcernCounters을 대체하고 추가 정보를 포함합니다.

MongoDB 5.0부터 serverStatus 명령은 cache pressure percentage threshold 과 current cache pressure percentage 를 wiredTiger.snapshot-window-settings 아래에 출력하지 않습니다.

라즈베리 파이 지원 제거

MongoDB 5.0은 Raspberry Pi에 대한 지원을 제거합니다. Raspberry Pi에서 MongoDB를 실행하려면 버전 4.4를 설치하세요.

TTL expireAfterSeconds 이 로 설정되었을 때의 동작 NaN

MongoDB 5.0부터 expireAfterSeconds가 NaN으로 설정된 TTL 인덱스는 이전 버전에 비해 동작이 변경됩니다.

행동 변화가 영향을 미칩니다.

• 직접 업그레이드

• 이전 버전에서 초기 동기화

• mongorestore 이전 버전에서

이러한 작업을 수행하면 NaN 의 expireAfterSeconds 값이 0의 expireAfterSeconds 로 취급됩니다. 따라서 문서가 즉시 만료될 수 있습니다.

MongoDB 5.0.14 (및 6.0.2) 부터 서버는 expireAfterSeconds 가 NaN 로 설정된 TTL 인덱스를 사용하지 않습니다.

셸 변경

mongo shell은 MongoDB v5.0에서 더 이상 사용되지 않습니다. 대체 셸은 mongosh입니다.

MongoDB v5.0에서도 shell 패키징이 변경되었습니다. 자세한 내용은 설치 지침에서 확인하세요.

복제본 세트

if [ (#arbiters > 0) AND (#non-arbiters <= majority(#voting-nodes)) ]
    defaultWriteConcern = { w: 1 }
else
    defaultWriteConcern = { w: "majority" }

제한 컬렉션에 대한 읽기 snapshot 우려 사항

MongoDB 5.0부터는 제한 컬렉션에서 읽을 때 읽기 "snapshot" 우려를 사용할 수 없습니다.

local 는 기본 읽기 우려

MongoDB 5.0부터 "local"는 기본 및 보조에 대한 읽기 작업에 대한 기본 읽기 우려 수준입니다.

이로 인해 필터를 사용하는 카운트 쿼리 및 적용 대상 쿼리의지연 시간이 크게 증가할 수 있습니다.

클러스터 전체 읽기 우려를 setDefaultRWConcern로 설정하여 이 동작을 선택 해제할 수 있습니다.

새 cursor.map() 반환 유형

cursor.map() 이(가) 레거시 mongo shell 에서 Array 을(를) 반환했습니다. 반환 유형은 Cursor { } 에서 mongosh 입니다. .toArray() 를 사용하여 결과를 변환할 수 있습니다.

운영자 변경 사항 업데이트

MongoDB 5.0부터 빈 피연산자 표현식( { } )과 함께 다음 업데이트 연산자를 사용할 때 mongod 에서 더 이상 오류가 발생하지 않습니다.

• $addToSet

• $bit

• $currentDate

• $inc

• $max

• $min

• $mul

• $pop

• $pull

• $pullAll

• $push

• $rename

• $set

• $setOnInsert

• $unset

빈 업데이트는 변경 사항이 없으며 Oplog 항목이 생성되지 않습니다(즉, 작업이 작동하지 않음을 의미합니다).

$setWindowFields 트랜잭션 및 스냅샷 읽기 문제가 있는 스테이지

5.3 이전 버전에서는 $setWindowFields 집계 파이프라인 단계를 트랜잭션 또는 "snapshot" 읽기 문제와 함께 사용할 수 없습니다.

집계 파이프라인 연산자 매개변수 제한

다음 집계 파이프라인 연산자에는 이제 64비트 정수 값 최대 제한이 있습니다.

• $sort

• $limit

이 제한을 초과하는 값을 전달하면 파이프라인이 잘못된 인수 오류를 반환합니다.

listDatabases 출력 변경 사항

MongoDB 5.0부터는 에 대해 실행되는 listDatabases 명령의 출력이 에 대해 실행되는 mongod 의 출력과 더 일관성이 listDatabases mongos있습니다.

다음 표는 MongoDB 5.0과 이전 버전 간의 listDatabases 출력 필드에 대한 데이터 유형의 차이점을 보여 줍니다. 5.0과 이전 버전 간에 다른 필드만 나열됩니다.

2}의 출력은 이제 또는 에 대해 실행할 때 listDatabases totalSizeMb mongos mongod필드를 포함합니다. MongoDB 4.4 이하에서는 totalSizeMb 이 mongos에 대해 실행될 때만 나타납니다. totalSizeMb 는 sizeOnDisk 필드의 합계로, 메가바이트로 표시됩니다.

2}에 대해 mongos shards listDatabases 실행하면 출력의 필드에 특정 샤드의 각 컬렉션에 대한 필드-값 쌍이 포함됩니다. 7} 필드의 크기 shards 값은 정수로 표시됩니다.

보안

맵 축소

버전 5.0부터 MongoDB는 맵 축소 작업을 더 이상 지원하지 않습니다.

맵 리듀스 작업에 대한 집계 파이프라인 대안의 예는 집계 파이프라인으로 맵 리듀스 및 맵 리듀스 예시를 참조하세요.

Auditing

MongoDB 5.0은 런타임에 구성할 수 있는 감사 기능을 추가했습니다.

0}이 로 auditLog.runtimeConfiguration true설정된 mongod mongos 경우 및 구성 setParameter.auditAuthorizationSuccess 파일은 더 이상 를 설정하거나 감사 필터를 구성할 수 없습니다. 서버 구성 파일에 이러한 설정이 포함되어 있으면 서버가 시작되지 않고 오류가 기록됩니다.

auditLog.runtimeConfiguration false 로 설정되고 감사 필터 구성 문서가 있는 경우 시작 경고가 발생하지만 서버는 중단되지 않습니다.

샤딩된 트랜잭션에서 부실 청크의 위험 감소

MongoDB 5.0부터는 transactionLifetimeLimitSeconds 매개 변수를 변경하는 경우 모든 구성 서버 복제본 세트 멤버에서 transactionLifetimeLimitSeconds도 동일한 값으로 변경해야 합니다. 이 값을 일관되게 유지합니다.

• 적어도 샤드 복제본 세트 멤버의 트랜잭션 수명 제한만큼 라우팅 테이블 기록이 유지되도록 합니다.

• 트랜잭션 재시도 빈도를 줄여 성능을 향상시킵니다.

일반 변경 사항

MongoDB 5.0부터 도입됨:

• featureCompatibilityVersion이 "5.0" 이상으로 설정된 경우 사용자는 더 이상 <database>.system.views 컬렉션에 직접 쓸 수 없습니다.

• reIndex 2} 명령과 셸 메서드는 독립 db.collection.reIndex() 실행형 인스턴스에서만 실행할 수 있습니다.

• 단일 파이프라인에 허용되는 집계 파이프라인 단계의 수는 1,000개로 제한됩니다.

• 2} 또는 가 활성화되어 있을 directoryPerDB --directoryperdb 때 데이터베이스의 최종 컬렉션을 제거하거나 데이터베이스 자체를 제거하면 해당 데이터베이스의 새로 비워진 하위 디렉터리가 삭제됩니다.

• $subtract 집계 연산자는 필요한 경우 결과 값을 정확하게 나타내기 위해 결과의 데이터 유형을 변환합니다. 구체적인 전환은 $subtract를 참조하세요.

• MongoDB는 --serviceExecutor 명령줄 옵션과 해당 net.serviceExecutor 구성 옵션을 제거합니다.

• --apiStrict 옵션이 설정된 경우 동일한 클라이언트 세션에서 여러 동시 사용자로 인증할 수 없습니다. --apiStrict 옵션이 설정된 상태에서 기존 사용자로 로그인한 상태에서 새 사용자로 인증하려고 하면 인증 시도당 한 번씩 오류 메시지가 생성됩니다. --apiStrict 옵션을 사용하지 않는 경우, 기존 사용자로 로그인한 상태에서 새 사용자로 인증하면 인증 시도당 한 번씩 로그에 경고가 기록됩니다.

• weights 옵션은 $text 인덱스에만 사용할 수 있습니다.

• 암시적 기본 쓰기 문제를 변경하는 구성으로 분할되지 않은 복제본 세트를 재구성하기 전에 전역 기본 쓰기 문제를 명시적으로 설정해야 합니다. 전역 기본 쓰기 문제를 설정하려면 setDefaultRWConcern 명령을 사용합니다.

• mongosh에서 replSetOplog 크기를 설정하려면 replSetResizeOplog 명령과 함께 Double() 생성자를 사용하세요.

• 와일드카드 인덱스 는 생성 후 정규화됩니다. 인덱스를 정의하는 wildcardProjection 문서에는 원래 인덱스 생성 문과 다른 정규화된 구문 이 포함될 수 있습니다.

• "*" 을(를) dropIndexes 또는 db.collection.dropIndexes() (으)로 전달하면 _id 인덱스 와 마지막 남은 샤드 키 인덱스(있는 경우)를 제외한 모든 인덱스가 삭제됩니다. 마지막 남은 샤드 키 인덱스 를 명시적으로 삭제하려고 하면 오류가 발생합니다.

MongoDB 5.0.4 부터 시작 (및 4.4.10), $mod 연산자 는 divisor 또는 remainder 값이 특정 값으로 평가되면 오류를 반환합니다. $mod 동작을 참조하세요.

5.0 기능 호환성

5.0의 일부 기능을 사용하려면 5.0 바이너리뿐만 아니라 기능 호환성 버전 (fCV)을 5.0으로 설정해야 합니다. 이러한 기능에는 다음이 포함됩니다.

• 시계열 컬렉션을 만들려면 fCV를 5.0 이상으로 설정해야 합니다.

• 런타임 감사 필터 관리를 구성하려면 fCV를 5.0 이상으로 설정해야 합니다.

• 필드 이름에 . 및 $ 을 사용하려면 fCV를 5.0 이상으로 설정해야 합니다.

• 컬렉션을 리샤딩하려면 fCV를 5.0+로 설정해야 합니다.

MongoDB 서버 매개변수

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