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 버전과 호환되는 버전으로 클라이언트를 업그레이드하는 것이 중요합니다.
Warning
지금은 서버 버전 3.2를 사용하는 한정 계정만 버전 3.6 이상으로 업그레이드할 수 있습니다. 계정에 업그레이드 옵션이 표시되지 않으면 지원 티켓을 제출하십시오.
버전 업그레이드
Azure Portal에 로그인합니다.
Azure Cosmos DB for MongoDB 계정으로 이동합니다. 개요 창을 열고 현재 서버 버전이 3.2 또는 3.6인지 확인합니다.
왼쪽 메뉴에서
Features창을 엽니다. 이 창에는 데이터베이스 계정에 사용할 수 있는 계정 수준의 기능이 표시됩니다.Upgrade MongoDB server version행을 선택합니다. 이 옵션이 표시되지 않으면 계정이 업그레이드에 적합하지 않은 것일 수 있습니다. 이 경우 지원 티켓을 제출합니다.
업그레이드에 대해 표시된 정보를 검토합니다.
Set server version to 4.2(또는 현재 버전에 따라 4.0 또는 3.6)를 선택합니다.
업그레이드를 시작하면 기능 메뉴가 회색으로 표시되고 상태가 보류 중으로 설정됩니다. 업그레이드를 완료하는 데는 약 15분이 걸립니다. 이 프로세스는 데이터베이스 계정의 기존 기능 또는 작업에 영향을 주지 않습니다. 완료되면 MongoDB 서버 버전 업데이트 상태에 업그레이드된 버전이 표시됩니다. 요청을 처리하는 데 문제가 있는 경우 지원에 문의하세요.
계정을 업그레이드한 후에는 다음과 같은 몇 가지 사항을 고려해야 합니다.
3\.2에서 업그레이드한 경우 개요 창으로 돌아가서 애플리케이션에서 사용할 새 연결 문자열을 복사합니다. 3.2를 실행하는 이전 연결 문자열 중단되지 않습니다. 일관된 환경을 보장하기 위해 모든 애플리케이션은 새 엔드포인트를 사용해야 합니다.
3.6에서 업그레이드한 경우 기존 연결 문자열 지정된 버전으로 업그레이드되며 계속 사용해야 합니다.
Important
3.2에서 업그레이드할 때 데이터베이스 계정 엔드포인트 접미사는 다음 형식 <your_database_account_name>.mongo.cosmos.azure.com으로 업데이트됩니다. 계정이 소버린, 정부 또는 제한된 Azure 클라우드에서 만들어진 경우 이 엔드포인트에 약간의 차이가 있을 수 있습니다.
버전 3.2에서 업그레이드하는 경우 애플리케이션의 기존 엔드포인트와 이 데이터베이스 계정에 연결하는 드라이버를 바꿔야 합니다. 새 엔드포인트를 사용하는 연결에만 새 API 버전의 기능에 대한 액세스 권한이 있습니다. 이전의 3.2 엔드포인트에는 .documents.azure.com 접미사가 있어야 합니다.
3.2에서 최신 버전으로 업그레이드할 때 이러한 쿼리에 대한 안정적이고 높은 성능을 보장하기 위해 여러 필드에서 정렬 작업을 수행하려면 복합 인덱스가 필요합니다. 다중 필드 정렬이 성공하도록 이러한 복합 인덱스를 만들어야 합니다.
버전 다운그레이드
버전 업그레이드 섹션의 동일한 단계를 통해 계정을 4.0 또는 3.6으로 다운그레이드할 수도 있습니다.
3.2에서 3.2로 업그레이드하고 다시 3.2로 다운그레이드하려는 경우 이전(3.2) 연결 문자열 사용
accountname.documents.azure.com으로 다시 전환합니다. 이는 버전 3.2를 실행하는 활성 업그레이드 후 활성 상태로 유지됩니다.애플리케이션에서 연결 문자열 변경합니다.