다음을 통해 공유

Azure Data Studio용 Azure Cosmos DB for MongoDB 마이그레이션 익스텐션(프리뷰)

  • 아티클

Azure Cosmos DB Migration for MongoDB 익스텐션은 MongoDB 워크로드를 Azure Cosmos DB로 마이그레이션하는 데 도움이 됩니다. 이 확장을 사용하여 다음을 수행할 수 있습니다.

  • 워크로드에 대한 엔드투엔드 평가를 실행하고 워크로드를 vCore 기반 Azure Cosmos DB for MongoDB로 마이그레이션하는 데 필요한 작업을 알아봅니다.
  • 선택한 데이터베이스 및 컬렉션을 사용하여 vCore 기반 Azure Cosmos DB for MongoDB로 마이그레이션 작업을 수행합니다.

Important

현재 이 익스텐션은 다음 시나리오를 지원하지 않습니다.

  • 원본 또는 대상 계정이 프라이빗 엔드포인트를 사용하도록 설정된 마이그레이션.
  • RU 기반 Azure Cosmos DB for MongoDB에 대한 온라인/오프라인 마이그레이션.

MongoDB vCore용 API에 대한 대체 솔루션에 대한 자세한 내용은 마이그레이션 옵션을 참조하세요.

필수 조건

  • 기존 vCore 기반 Azure Cosmos DB for MongoDB 계정.
  • Azure Data Studio 최신 버전.
  • 버전 3.2 이상을 실행하는 MongoDB.
  • 글로벌 Azure 데이터 센터의 연결을 허용하도록 원본 MongoDB 및 vCore 기반 Azure Cosmos DB for MongoDB 대상 계정에 방화벽 예외를 추가합니다.
  • Database Migration Service를 처음 사용하는 경우 Microsoft.DataMigration 리소스 공급자가 구독에 등록되어 있는지 확인하세요.

준비

마이그레이션을 시작하기 전에 실제로 데이터를 이동하기 전에 마이그레이션에 대한 사전 계획 및 의사 결정을 수행하는 것이 중요합니다.

구독에 Microsoft.DataMigration 리소스 공급자 등록

Microsoft.DataMigration 리소스 공급자가 구독에 등록되었는지 확인하려면 다음 단계를 수행합니다.

Azure 포털:

  1. Azure Portal로 이동하여 구독으로 이동합니다.
  2. 왼쪽 메뉴의 설정에서 리소스 공급자를 선택합니다.
  3. 위쪽의 검색 상자에서 Microsoft.DataMigration을 검색합니다.
  4. 등록되지 않은 경우 이를 선택하고 등록 버튼을 클릭합니다.

Azure CLI:

  1. Azure Cloud Shell 또는 로컬 터미널을 엽니다.
  2. 리소스 공급자를 등록하는 다음 명령을 실행합니다.
az provider register --namespace Microsoft.DataMigration

PowerShell:

  1. Azure Cloud Shell 또는 로컬 PowerShell을 엽니다.
  2. 리소스 공급자를 등록하는 다음 명령을 실행합니다.
Register-AzResourceProvider -ProviderNamespace "Microsoft.DataMigration"

익스텐션 설치

마이그레이션을 시작하기 전에 Azure Data Studio에서 Azure Cosmos DB for MongoDB 마이그레이션 익스텐션을 설치합니다.

  1. Azure Data Studio에서 익스텐션 관리자를 엽니다. 익스텐션 아이콘을 선택하거나 보기 메뉴에서 확장을 선택합니다.

  2. 검색 창에 Cosmos를 입력합니다.

  3. MongoDB용 Azure Cosmos DB 마이그레이션 확장을 선택하고 세부 정보를 확인합니다.

    Azure Cosmos DB for MongoDB 마이그레이션 익스텐션 설치 단추의 스크린샷.

  4. 설치를 선택합니다.

확장 설정 구성

확장 프로그램을 설치한 후 일부 확장 프로그램 설정을 구성할 수 있습니다. 이 단계는 선택 사항입니다. 명시적으로 구성된 설정이 없으면 확장에서 기본 설정을 사용합니다.

  1. 확장 기능으로 이동하여 MongoDB용 Azure Cosmos DB 마이그레이션을 선택하고 설정 관리 아이콘을 선택한 다음 확장 기능 설정을 선택합니다.

    익스텐션 설정 선택 스크린샷.

  2. 이 확장의 확장 설정에서 평가 메타데이터가 저장되는 위치를 변경하려면 Assessment path를 입력합니다. 비워두면 기본 위치가 사용됩니다.

MongoDB 원본에 연결

확장 프로그램을 처음 사용하여 기존 MongoDB 소스 인스턴스에 연결합니다. 이 섹션을 시작하기 전에 소스에 대한 연결 자격 증명이 준비되었는지 확인합니다.

  1. 메뉴 모음에서 연결 아이콘을 찾고 새 연결을 선택합니다.

    익스텐션의 연결 메뉴 모음 스크린샷.

  2. 연결 창에서 다음 필드를 채워 넣습니다.

    값
    연결 형식 Azure Cosmos DB for MongoDB
    연결 문자열 매개 변수 기존 원본 MongoDB 인스턴스에 대한 연결 문자열 또는 매개 변수를 사용합니다.
    서버 그룹 Default
    이름(선택 사항) 이 연결에 대한 고유 이름을 제공합니다.

  3. 연결을 선택합니다.

  4. 연결 창에서 새 연결에 대한 컨텍스트 메뉴를 엽니다. 그런 다음 관리를 선택합니다.

    데이터베이스 관리 화면의 스크린샷.

  5. Azure Cosmos DB 마이그레이션을 선택합니다.

    마이그레이션 평가 데이터베이스 화면의 스크린샷.

평가 실행

평가는 현재 MongoDB 데이터 자산 및 사용률을 검사합니다. 그런 다음 평가 기능은 워크로드를 Azure Cosmos DB for MongoDB로 마이그레이션하기 전에 수행해야 하는 작업을 식별하는 데 도움이 되는 포괄적인 보고서를 생성합니다.

  1. 대시보드 탭을 찾아서 이동한 다음 데이터베이스 평가 및 마이그레이션을 선택합니다.

    익스텐션의 마이그레이션 기능 내 대시보드 탭 스크린샷.

  2. 평가를 수행할 수 있도록 마법사를 완료하여 익스텐션에 세부 정보를 제공합니다.

    자격 증명의 유효성을 검사하기 전 평가 세부 정보의 스크린샷.

    1. 평가 이름 필드에 제목을 입력합니다.

    2. 제품 드롭다운 목록에서 대상 Azure Cosmos DB for MongoDB 계정을 선택합니다.

    3. MongoDB 로그에 대한 경로를 제공합니다.

      팁

      선택적 필드이지만 로그 경로를 지정하면 컬렉션 수준에서 더 세분화된 결과를 가져옵니다. 로그 폴더를 지정하지 않으면 도구는 serverStatus 명령의 세부 정보를 사용하여 평가를 수행합니다.

      serverStatus 명령은 마지막으로 다시 시작한 후에만 기능 사용량을 반환하므로 실제 워크로드를 정확하게 반영하는 평가를 얻으려면 마지막 서버를 다시 시작한 후 충분한 시간이 경과했는지 확인해야 합니다.

    4. 데이터 평가 로그에 대한 경로를 제공합니다.

      팁

      이 필드는 선택 사항이지만 데이터 평가 로그를 제공하면 워크로드에 대한 자세한 인사이트를 얻을 수 있습니다. 이러한 로그는 데이터를 스캔하고 자세한 로그를 읽어 가져옵니다. 데이터 평가는 마이그레이션 평가를 시작하기 전에 CLI로 독립적으로 실행되며 결과 JSON이 여기에 제공됩니다. 여기에서 데이터 평가 CLI를 다운로드합니다.

    5. 유효성 검사 실행을 선택하여 평가 입력의 유효성을 검사합니다.

  3. 유효성 검사에 성공하면 평가 시작을 선택하여 평가를 실행합니다.

    자격 증명의 유효성을 검사한 후 평가 세부 정보의 스크린샷.

  4. 원본 서버의 크기에 따라 평가는 몇 분 정도 걸립니다. 계속하기 전에 평가가 완료될 때까지 기다립니다.

    진행 중인 새 평가의 스크린샷.

  5. 평가가 완료되면 이제 평가 보고서를 받아야 합니다.

    원본 MongoDB 인스턴스에 대한 새 평가 보고서의 스크린샷.

  6. 평가 보고서에서 인스턴스 이름을 선택하여 서버 전체 문제 목록을 검토합니다. 특정 데이터베이스를 선택하여 선택한 데이터베이스에만 적용할 수 있는 문제를 확인합니다.

    원본 MongoDB 인스턴스 내에서 선택한 데이터베이스에 대한 새 평가 보고서의 스크린샷.

  7. 보고서 다운로드를 선택하여 통합 다운로드 가능한 보고서를 가져옵니다.

  8. 평가 보고서를 연구하여 Azure Cosmos DB for MongoDB에서 워크로드를 원활하게 마이그레이션하기 위해 수행해야 하는 작업을 식별합니다. 다음 단계로 이동하기 전에 평가에 보고된 모든 차단 문제가 처리되는지 확인합니다. 해결되지 않은 문제가 있는 경우 프로세스를 종료하고 나중에 처리할 수 있습니다. 문제가 해결되면 다시 돌아와서 평가 및 마이그레이션 프로세스를 다시 시작할 수 있습니다.

마이그레이션 수행

이제 평가 보고서를 사용하여 원본 MongoDB 인스턴스에서 대상 vCore 기반 Azure Cosmos DB for MongoDB 계정으로 데이터를 마이그레이션합니다.

  1. 평가 보고서 화면에서 마이그레이션하려는 데이터베이스를 선택합니다. 그런 후에 다음을 선택합니다.

    마이그레이션을 위해 선택한 데이터베이스의 스크린샷.

  2. 구독별로 필터링한 다음 리소스 그룹을 필터링하여 목록 범위를 좁혀 대상 Azure Cosmos DB for MongoDB 계정을 선택합니다. 그런 다음 계정에 연결하는 데 필요한 연결 자격 증명을 제공합니다.

    대상 Azure Cosmos DB for MongoDB 계정 선택 스크린샷.

  3. 연결 테스트를 선택하여 Azure Cosmos DB for MongoDB 계정에 대한 자격 증명의 유효성을 검사합니다. 다음을 선택하여 원본에서 대상으로 컬렉션의 매핑으로 이동합니다.

  4. 매핑 목록에서 각 컬렉션에 대해 건너뛰기 또는 마이그레이션을 선택합니다. 대상에 이미 있는 컬렉션은 아이콘으로 자동으로 표시되고 기본적으로 건너뛰기로 설정됩니다. 다음을 선택하여 Azure Database Migration Service(DMS)를 구성합니다.

    원본에서 대상으로 컬렉션 매핑의 스크린샷.

    Warning

    기존 컬렉션을 마이그레이션하도록 선택하면 전체 컬렉션이 덮어쓰여 복구할 수 없는 데이터가 손실됩니다. 이 옵션을 선택할 때는 주의하세요.

  5. 드롭다운에서 기존 Azure Database Migration Service 인스턴스를 선택하거나 새로 만들기를 선택하여 새 마이그레이션 서비스를 만듭니다. Azure Database Migration Service는 로컬 리소스를 사용하는 대신 데이터 전송을 위해 클라우드 인프라를 사용하여 Azure 데이터 플랫폼 간에 데이터를 마이그레이션하는 서비스입니다.

    마이그레이션 서비스를 선택하는 옵션의 스크린샷.

  6. 사용 사례에 가장 적합한 마이그레이션 모드를 선택합니다.

    • 온라인 마이그레이션은 컬렉션 데이터를 복사하여 프로세스 중에 업데이트도 복제되도록 합니다. 이 방법은 가동 중지 시간을 최소화하면서 비즈니스 연속성을 위한 지속적인 운영을 가능하게 하는 장점이 있습니다. 진행 중인 작업이 중요하고 가동 중지 시간을 줄이는 것이 우선 순위인 경우 이 옵션을 사용합니다.
    • 오프라인 마이그레이션은 처음에 데이터베이스의 스냅샷을 캡처하여 더 간단하고 예측 가능한 접근 방식을 제공합니다. 데이터베이스의 정적 복사본을 사용할 수 있고 실시간 업데이트가 필수가 아닌 경우 잘 작동합니다.

  7. 다음을 선택하여 마이그레이션 요약을 봅니다. 세부 정보를 검토하고 확인한 후 스키마 만들기를 선택하여 대상 계정에 리소스를 만듭니다.

    마이그레이션 요약을 보는 옵션의 스크린샷.

  8. 마이그레이션 시작을 선택하여 선택한 마이그레이션 서비스를 사용하여 데이터 전송을 시작합니다.

    마이그레이션 서비스를 사용하여 마이그레이션을 시작하는 옵션의 스크린샷.

  9. 설정 확인 팝업에서 방화벽 설정이 요구 사항을 충족하는지 확인합니다. 확인을 선택하여 확인합니다.

    방화벽 설정을 확인하는 설정 확인 팝업의 스크린샷.

데이터 마이그레이션 작업은 Azure Database Migration Service에서 실행되므로 데이터 마이그레이션 중에 원본 및 대상 환경에 연결할 필요가 없습니다. 상태는 대시보드에서 자주 업데이트됩니다.

참고 항목

마이그레이션할 컬렉션을 50개 이상 선택한 경우 마이그레이션 작업은 마이그레이션 서비스에서 각각 최대 50개의 컬렉션을 포함하는 여러 작업으로 일괄 처리됩니다.

  1. 작업이 초기화되면 대시보드 페이지에서 마이그레이션 상태를 모니터링합니다.

    마이그레이션 상태가 있는 대시보드의 스크린샷.

  2. 자세한 내용을 보려면 마이그레이션 목록에서 특정 마이그레이션을 선택합니다.

오프라인 마이그레이션 모니터링

모든 데이터 마이그레이션 작업이 완료되면 상태가 자동으로 업데이트됩니다.

마이그레이션 상태가 있는 컬렉션의 스크린샷.

데이터가 원본에서 대상으로 성공적으로 복사되면 오프라인 마이그레이션 상태는 성공으로 표시됩니다.

마이그레이션 상태의 성공에 대한 스크린샷.

  • 대상 계정을 가리키도록 애플리케이션의 연결 문자열을 변경합니다.

온라인 마이그레이션 모니터링

온라인 마이그레이션은 오프라인 마이그레이션과 달리 자동으로 완료되지 않습니다. 대신 컷오버를 선택하여 수동으로 완료될 때까지 계속 실행됩니다.

온라인 마이그레이션 상태의 스크린샷.

온라인 마이그레이션을 완료하려면 지정된 순서대로 다음 단계를 수행합니다.

  1. 모든 컬렉션에 대해 초기 데이터 로드가 완료되면 컷오버 버튼을 사용할 수 있습니다. 마이그레이션은 현재 복제 단계에 있으며, 원본 인스턴스에서 대상 인스턴스로 업데이트를 지속적으로 복사하여 최신 변경 사항을 최신 상태로 유지합니다.

  2. 마이그레이션 중단을 수행할 준비가 되면 마이그레이션 중인 원본 컬렉션에 들어오는 모든 트랜잭션을 중지합니다.

  3. 테이블의 복제 변경 내용을 모니터링하고 '재생된 복제 변경 내용' 메트릭이 안정화될 때까지 기다립니다. 안정적인 '재생된 복제 변경 내용' 메트릭은 원본의 모든 업데이트가 대상에 성공적으로 복사되었음을 나타냅니다.

  4. 모든 컬렉션에 대해 복제 간격이 최소화되고 '재생된 복제 변경 내용' 메트릭이 안정적이면 컷오버를 선택합니다.

  5. 행 수가 원본 컬렉션과 대상 컬렉션 간에 동일한지 수동으로 확인합니다.

  6. 팝업 대화 상자에서. 전체 컷오버를 선택합니다.
    온라인 마이그레이션 중단 팝업의 스크린샷.

    참고 항목

    원본과 대상이 동기화되는지 확인하지 않고 컷오버 작업을 수행하면 데이터가 손실될 수 있습니다.

  7. 상태가 성공으로 변경될 때까지 기다립니다.

  8. 대상 계정을 가리키도록 애플리케이션의 연결 문자열을 업데이트합니다.

과거 마이그레이션 및 평가 보기

과거 평가 및 마이그레이션을 검토하는 것이 유용한 경우가 많습니다. 익스텐션은 과거 평가 및 마이그레이션에 대한 요약을 검토하는 인터페이스를 제공합니다. 또한 익스텐션은 자세한 과거 평가 보고서를 검토할 수 있는 기능을 제공합니다.

  1. 이전 마이그레이션을 보려면 도구 모음에서 마이그레이션 탭을 선택합니다. 마이그레이션 목록에는 현재 컴퓨터에서 시작된 모든 마이그레이션이 포함됩니다. 목록에서 특정 마이그레이션을 선택하여 자세한 내용을 확인할 수 있습니다.

    익스텐션을 사용하여 만든 모든 마이그레이션 목록의 스크린샷.

  2. 과거 평가를 보려면 도구 모음에서 평가 탭을 선택합니다. 평가 목록에는 현재 컴퓨터에서 시작된 모든 평가가 포함됩니다.

    익스텐션을 사용하여 수행된 모든 평가 목록의 스크린샷.

다음 단계

Azure Cosmos DB for MongoDB 마이그레이션 익스텐션 관련 FAQ 검토