중요
MongoDB 8.3 은 최신 마이너 출시하다 입니다. MongoDB 8.2부터 특정 사용 사례에 대해 온프레미스 배포(커뮤니티 및 EA)에 마이너 릴리스를 사용할 수 있습니다. 자세한 내용은 MongoDB 버전 관리를 참조하세요.
온프레미스 사용이 지원되는 최신 MongoDB 버전을 설치하려면 설치 지침을 참조하세요.
이 페이지에서는 이전 버전의 MongoDB 와의 호환성에 영향을 줄 수 있는 MongoDB 8.3 에 도입된 변경 사항에 대해 설명합니다.
Indexes
더 엄격한 와일드카드 인덱스 유효성 검사
MongoDB 8.3 (및 8.2.4, 8.0.18, 7.0.29)부터 복합 와일드카드 인덱스의 wildcardProjection 사양에 더 엄격한 유효성 검사 규칙이 적용 . 새로운 유효성 검사 요구 사항을 충족하지 않는 기존 인덱스는 계속 작동하지만 이러한 요구 사항을 충족하지 않는 새 인덱스를 만들 수는 없습니다.
유효성 검사 규칙에 대한 자세한 내용은 와일드카드 인덱스 제한을 참조하세요.
일반 변경 사항
$map, $ 필터하다, $reduce에서 배열 요소 인덱스에 액세스하기
MongoDB 8.3 은, $filter 및 $reduce 집계 $map 표현식에서 배열 요소 인덱스에 대한 액세스 개선합니다. 새 arrayIndexAs 필드 사용하여 배열 요소의 인덱스 를 저장 변수를 설정하다 수 있습니다. 를 생략한 경우 새로운 $$IDX 집계 시스템 변수를 사용하여 현재 배열 요소의 인덱스 에 액세스 할 수도 arrayIndexAs 있습니다.
새로운 배열 요소 인덱스 기능 사용하는 뷰 또는 컬렉션 유효성 검사 규칙을 만드는 8.3 경우 MongoDB 에서 이전 버전으로 다운그레이드하기 전에 뷰 또는 규칙을 업데이트 하거나 제거 해야 합니다.
2dsphereIndexVersion
MongoDB 부터 8.3 2dsphereIndexVersion은 기본값 으로 버전 로 설정하다 4 됩니다.
FCV 미만으로 다운그레이드해야 하는 8.3 경우, 먼저 2dsphere 버전 4 인덱스를 삭제해야 합니다.
이전 버전과 호환되지 않는 기능
다음 섹션에서는 배포서버 에서 이전 버전과 호환되지 않는 기능을 제거하기 위한 정보를 제공합니다. MongoDB 8.3 에서 이전 버전으로 다운그레이드하는 경우 다음 섹션을 검토 다운그레이드 후 배포서버 성공적으로 실행되는지 확인합니다.
뷰의 표현식
MongoDB 8.3에 도입된 표현식을 사용하는 뷰를 만든 경우, 해당 표현식을 지원 하지 않는 버전으로 다운그레이드한 후 해당 뷰가 작동하지 않을 수 있습니다.
8.3에서 다운그레이드해야 하는 경우 먼저 대상 버전에서 지원되지 않는 표현식을 사용하는 모든 뷰를 업데이트 하거나 삭제해야 합니다.
뷰와 유효성 검사기의 매개변수 및 변수
MongoDB 8.3에 도입된 매개변수 또는 변수를 사용하는 뷰 또는 컬렉션 유효성 검사기를 만든 경우, 다운그레이드 후 해당 객체가 유효성 검사 또는 평가에 실패할 수 있습니다.
8.3에서 다운그레이드해야 하는 경우, 먼저 대상 버전에서 지원되지 않는 매개변수 또는 변수를 참조하는 모든 뷰 또는 유효성 검사기를 업데이트 하거나 제거 해야 합니다.
검증된 컬렉션
MongoDB 8.3 은 8.3 이전 버전과 호환되지 않는 새로운 유효성 검사 시맨틱을 사용하여 컬렉션을 유효성이 검사된 것으로 표시할 수 있습니다. 검증된 컬렉션이 있는 동안 다운그레이드하려고 하면 다운그레이드가 실패합니다.
8.3에서 다운그레이드해야 하는 경우, 먼저 유효성이 검사된 컬렉션을 대상 버전에서 지원되는 유효성 검사 수준으로 변경하거나 해당 컬렉션을 삭제해야 합니다.
$ 패싯 메모리 제한 오류 코드
MongoDB 부터 단계에서 메가바이트 8.3 $facet 제한보다 큰 문서 100 구성하면 MongoDB ExceededMemoryLimit 오류를 반환합니다.
이전 버전에서는 메모리 제한을 초과하는 단계에서 오류 4031700 코드 을(를) 반환합니다. 을 명시적으로 확인하는 애플리케이션, 드라이버 또는 도구가 4031700 있는 경우 대신 를 인식하도록 코드를 조정할 수 있습니다.ExceededMemoryLimit
$convert 파이프라인의 비정규 숫자
MongoDB 8.3 부터 서버 표현 가능한 모든 배정밀도 부동 점 숫자의 전체 범위 구문 분석할 수 있습니다. 여기에는 최상위 숫자 앞에 0이 있고 지수가 가능한 가장 작은 값을 갖는 비정규 숫자가 포함됩니다. 이전 버전의 MongoDB 에서는 이러한 숫자를 구문 분석하려고 하면 서버 오류를 반환합니다.
밸런서 창 설정
MongoDB 8.3 에서 이전 버전으로 다운그레이드하는 경우 activeBalancerWindowDOW 구성을 사용할 수 없습니다. 다운그레이드 시 밸런서 기본적으로 activeWindow 설정을 사용합니다.
수동 다운그레이드 단계는 필요하지 않지만 8.3 에서 수행한 사용자 지정 요일(DOW) 구성은 다운그레이드 후에는 적용 되지 않습니다.