중요
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 은 $map, $filter 및 $reduce 집계 표현식에서 배열 요소 인덱스에 대한 액세스 개선합니다. 새 arrayIndexAs 필드 사용하여 배열 요소의 인덱스 를 저장 변수를 설정하다 수 있습니다. arrayIndexAs를 생략한 경우 새로운 $$IDX 집계 시스템 변수를 사용하여 현재 배열 요소의 인덱스에 액세스 할 수도 있습니다.
새로운 배열 요소 인덱스 기능을 사용하는 뷰 또는 컬렉션 유효성 검사 규칙 을 만드는 경우 MongoDB 8.3 에서 이전 버전으로 다운그레이드하기 전에 뷰 또는 규칙을 업데이트하거나 제거해야 합니다.
2dsphereIndexVersion
MongoDB 8.3부터 2dsphereIndexVersion 은 기본값 으로 버전 4 로 설정하다 됩니다.
기능 호환성 버전 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 메가바이트 제한보다 큰 document 구성하면 MongoDB ExceededMemoryLimit 오류를 반환합니다.
이전 버전에서는 메모리 제한을 초과하는 단계에서 오류 코드 4031700을(를) 반환합니다. 4031700을 명시적으로 확인하는 애플리케이션, 드라이버 또는 도구가 있는 경우 대신 ExceededMemoryLimit 를 인식하도록 코드를 조정할 수 있습니다.
$convert 파이프라인의 비정규 숫자
MongoDB 8.3부터 서버 표현 가능한 모든 double 정밀도 부동 점 숫자의 전체 범위 구문 분석할 수 있습니다. 여기에는 최상위 숫자 앞에 0이 있고 지수가 가능한 가장 작은 값을 갖는 비정규 숫자 가 포함됩니다. 이전 버전의 MongoDB 에서는 이러한 숫자를 구문 분석하려고 하면 서버 오류를 반환합니다.
자세한 내용은 비정규 숫자를 참조하세요.
밸런서 창 설정
MongoDB 8.3 에서 이전 버전으로 다운그레이드하는 경우 activeBalancerWindowDOW 구성을 사용할 수 없습니다. 다운그레이드 시 밸런서 기본적으로 activeWindow 설정을 사용합니다.
수동 다운그레이드 단계는 필요하지 않지만 8.3 에서 수행한 사용자 지정 요일(DOW) 구성은 다운그레이드 후에는 적용 되지 않습니다.