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 버전과 호환되는 버전으로 클라이언트를 업그레이드하는 것이 중요합니다.

참고 항목

지금은 서버 버전 3.2를 사용하는 한정 계정만 버전 3.6 이상으로 업그레이드할 수 있습니다. 계정에 업그레이드 옵션이 표시되지 않으면 지원 티켓을 제출하십시오.

4.2, 4.0 또는 3.6으로 업그레이드

버전 4.2로 업그레이드 시 이점:

  • $merge, 삼각법, 산술 식 등에 대한 지원과 같은 집계 파이프라인에 대한 몇 가지 주요 개선 사항입니다.
  • 개별 필드를 선택적으로 암호화하고 데이터베이스 사용자 및 호스팅 공급자로부터 암호화된 데이터의 개인 정보를 유지함으로써 데이터베이스를 더욱 안전하게 보호하는 클라이언트 쪽 필드 암호화를 지원합니다.

버전 4.0으로 업그레이드 시 이점

다음은 버전 4.0에 포함된 새로운 기능입니다.

  • Unsharded 컬렉션 내의 다중 문서 트랜잭션 지원
  • 새 집계 연산자
  • 향상된 검사 성능
  • 더 빠르고 효율적인 스토리지

버전 3.6으로 업그레이드 시 이점

다음은 버전 3.6에 포함된 새로운 기능입니다.

  • 성능 및 안정성 향상
  • 새 데이터베이스 명령에 대한 지원
  • 집계 파이프라인에 대한 기본 지원 및 새 집계 단계 지원
  • 변경 스트림 지원
  • 복합 인덱스 지원
  • update, delete, count 및 sort 작업에 대한 파티션 간 지원
  • $count, $skip, $limit 및 $group 집계 작업의 성능이 향상되었습니다.
  • 이제 와일드카드 인덱싱이 지원됩니다.

버전 3.2 이후의 변경 내용

  • 기본적으로 클라이언트 애플리케이션의 요청에서 16500 오류를 반환하지 않도록 SSR(서버 쪽 다시 시도) 기능을 사용하도록 설정되어 있습니다. 대신 요청이 완료되거나 60초 시간 초과될 때까지 다시 시작합니다.
  • 요청당 시간 제한은 60초로 설정됩니다.
  • 새 유선 프로토콜 버전에 만들어진 MongoDB 컬렉션에는 기본적으로 인덱싱된 _id 속성만 있습니다.

3\.2에서 업그레이드하는 경우 필요한 작업

3.2에서 업그레이드하는 경우 데이터베이스 계정 엔드포인트 접미사가 다음 형식으로 업데이트됩니다.

<your_database_account_name>.mongo.cosmos.azure.com

버전 3.2에서 업그레이드하는 경우 애플리케이션의 기존 엔드포인트와 이 데이터베이스 계정에 연결하는 드라이버를 바꿔야 합니다. 새 엔드포인트를 사용하는 연결에만 새 API 버전의 기능에 대한 액세스 권한이 있습니다. 이전의 3.2 엔드포인트에는 .documents.azure.com 접미사가 있어야 합니다.

3.2에서 최신 버전으로 업그레이드할 때 이러한 쿼리에 대한 안정적이고 높은 성능을 보장하기 위해 여러 필드에서 정렬 작업을 수행하려면 복합 인덱스가 필요합니다. 다중 필드 정렬이 성공하도록 이러한 복합 인덱스를 만들어야 합니다.

참고 항목

엔드포인트는 계정이 소버린, 정부 또는 제한된 Azure Cloud에 있는 경우 약간 다를 수 있습니다.

업그레이드 방법

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

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

    Check the current version of your MongoDB account from the Azure portal.

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

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

    Open the Features blade and upgrade your account.

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

    Review upgrade guidance and select upgrade.

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

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

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

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

다운그레이드 방법

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

3.2에서 업그레이드한 상태에서 다시 3.2로 다운그레이드하려는 경우 이전 3.2 연결 문자열을 호스트 accountname.documents.azure.com으로 사용하기만 하면 다시 전환됩니다. 이렇게 하면 활성 업그레이드 후 버전 3.2이 계속 실행됩니다.

다음 단계