Azure Cosmos DB for MongoDB 계정의 API 버전 업그레이드

적용 대상: MongoDB

이 문서에서는 Azure Cosmos DB의 API for MongoDB 계정의 API 버전을 업그레이드하는 방법을 설명합니다. 업그레이드 후에는 Azure Cosmos DB의 API for MongoDB에서 최신 기능을 사용할 수 있습니다. 업그레이드 프로세스는 계정의 가용성을 중단하지 않으며 언제든지 RU/s를 사용하거나 데이터베이스의 용량을 줄이지 않습니다. 이 프로세스는 기존 데이터 또는 인덱스에 영향을 주지 않습니다.

새 API 버전으로 업그레이드하는 경우 프로덕션 워크로드를 업그레이드하기 전에 개발/테스트 워크로드로 시작합니다. Azure Cosmos DB for MongoDB 계정을 업그레이드하기 전에 업그레이드하려는 API 버전과 호환되는 버전으로 클라이언트를 업그레이드하는 것이 중요합니다.

버전 업그레이드

1. Azure Portal에 로그인합니다.

2. Azure Cosmos DB for MongoDB 계정으로 이동합니다. 개요 창을 열고 현재 서버 버전이 3.2 또는 3.6인지 확인합니다.

   

3. 왼쪽 메뉴에서 Features 창을 엽니다. 이 창에는 데이터베이스 계정에 사용할 수 있는 계정 수준의 기능이 표시됩니다.

4. Upgrade MongoDB server version 행을 선택합니다. 이 옵션이 표시되지 않으면 계정이 업그레이드에 적합하지 않은 것일 수 있습니다. 이 경우 지원 티켓을 제출합니다.

   

5. 업그레이드에 대해 표시된 정보를 검토합니다. Set server version to 4.2(또는 현재 버전에 따라 4.0 또는 3.6)를 선택합니다.

   

6. 업그레이드를 시작하면 기능 메뉴가 회색으로 표시되고 상태가 보류 중으로 설정됩니다. 업그레이드를 완료하는 데는 약 15분이 걸립니다. 이 프로세스는 데이터베이스 계정의 기존 기능 또는 작업에 영향을 주지 않습니다. 완료되면 MongoDB 서버 버전 업데이트 상태에 업그레이드된 버전이 표시됩니다. 요청을 처리하는 데 문제가 있는 경우 지원에 문의하세요.

7. 계정을 업그레이드한 후에는 다음과 같은 몇 가지 사항을 고려해야 합니다.

   1. 3\.2에서 업그레이드한 경우 개요 창으로 돌아가서 애플리케이션에서 사용할 새 연결 문자열을 복사합니다. 3.2를 실행하는 이전 연결 문자열 중단되지 않습니다. 일관된 환경을 보장하기 위해 모든 애플리케이션은 새 엔드포인트를 사용해야 합니다.

   2. 3.6에서 업그레이드한 경우 기존 연결 문자열 지정된 버전으로 업그레이드되며 계속 사용해야 합니다.

버전 다운그레이드

버전 업그레이드 섹션의 동일한 단계를 통해 계정을 4.0 또는 3.6으로 다운그레이드할 수도 있습니다.

1. 3.2에서 3.2로 업그레이드하고 다시 3.2로 다운그레이드하려는 경우 이전(3.2) 연결 문자열 사용accountname.documents.azure.com으로 다시 전환합니다. 이는 버전 3.2를 실행하는 활성 업그레이드 후 활성 상태로 유지됩니다.

2. 애플리케이션에서 연결 문자열 변경합니다.

관련 콘텐츠

• MongoDB 버전 6.0 기능
• MongoDB 버전 5.0 기능
• MongoDB 버전 4.2 기능
• MongoDB 버전 4.0 기능
• MongoDB 버전 3.6 기능
• MongoDB 버전 기록