이 가이드에서는 기존 컬렉션을 가져와서 서비스 및 Azure Portal에 기본 제공되는 도구를 사용하여 Azure Cosmos DB for MongoDB에서 Azure DocumentDB로 마이그레이션합니다.
필수 조건
Azure 구독
- Azure 구독이 없는 경우, 시작하기 전에 무료 계정을 만드십시오.
대상 Azure DocumentDB 클러스터
클러스터가 아직 없는 경우 새 Azure DocumentDB 클러스터를 만듭니다.
클러스터에 연결하는 데 필요한 네이티브 인증 자격 증명 이 있는지 확인합니다.
Azure Key Vault 계정
- 역할 기반 액세스 제어에 Key Vault 계정이 사용하도록 설정되어 있는지 확인합니다. 자세한 내용은 Azure Key Vault의 역할 기반 액세스 제어를 참조하세요.
Azure Key Vault 설정
먼저 대상 Azure DocumentDB 클러스터의 네이티브 인증 자격 증명을 기존 키 자격 증명 모음에 저장하도록 원본 Azure Cosmos DB for MongoDB 계정을 구성해야 합니다.
Azure Portal에 로그인합니다(https://portal.azure.com).
원본 Azure Cosmos DB for MongoDB 계정으로 이동합니다.
원본 계정에서 설정 > ID로 이동합니다.
계정의 시스템 할당된 관리 ID를 활성화하려면 상태 옵션을 켜기로 설정하세요. 나중에 이 가이드에서 사용하기 위해 개체(주체) ID의 값을 적어 두세요.
팁 (조언)
대신 사용자 할당 관리 ID를 사용하는 경우 하나 이상의 사용자 할당 관리 ID가 원본 계정에 할당되었는지 확인합니다.
기존 키 자격 증명 모음으로 이동하세요.
Key Vault에서 RBAC(Role-Based 액세스 제어) 권한 모델을 사용하는 경우 리소스 메뉴에서 IAM(액세스 제어) 옵션을 선택하고 Key Vault 비밀 사용자 역할을 원본 계정에 사용되는 관리 ID의 주 ID(개체 ID)에 할당합니다. 그렇지 않은 경우 리소스 메뉴의 액세스 정책 옵션을 사용하여 Get 및 List Secret 권한이 있는 액세스 정책을 만든 다음 보안 주체 ID(개체 ID)에 할당합니다.
기본 ID 메커니즘을 기본 ID로 사용하도록 원본 계정을 업데이트하는 명령을 실행합니다.
az cosmosdb update \ --resource-group "<resource-group-name>" \ --name "<source-account-name>" \ --default-identity "SystemAssignedIdentity"팁 (조언)
대신 사용자 할당 관리 ID를 사용하는 경우 다음 명령을 실행합니다.
az cosmosdb update \ --resource-group "<resource-group-name>" \ --name "<source-account-name>" \ --default-identity "UserAssignedIdentity=<fully-qualified-resource-id-of-user-assigned-managed-identity>"키 보관소로 돌아가 개체 > 비밀을 선택합니다.
그런 다음 생성/가져오기 를 선택하여 새 비밀을 만듭니다. 비밀에 다음 값을 사용합니다.
Description 이름 비밀 이름은 비밀을 식별하는 데 사용되며 영숫자 문자와 대시만 포함할 수 있습니다. 이 값은 결국 마이그레이션 작업의 비밀 이름 필드에 사용됩니다. 비밀 값 Azure Cosmos DB for MongoDB 대상 클러스터에 대한 네이티브 인증 자격 증명을 여기에 붙여넣습니다. 새로 만든 비밀에서 자격 증명 모음 URI의 값을 수집하세요. 이 값은 결국 마이그레이션 작업의 볼트 URI 필드에 사용됩니다.
마이그레이션 작업 만들기
먼저 대상 클러스터로 데이터 마이그레이션을 시작하는 데 필요한 구성을 사용하여 마이그레이션 작업을 만듭니다.
Azure Portal에 로그인합니다(https://portal.azure.com).
Azure Cosmos DB for MongoDB 계정으로 다시 이동합니다.
계정 페이지의 리소스 메뉴에서 DocumentDB로 마이그레이션 을 선택합니다.
새 마이그레이션 작업 시작을 선택합니다.
마이그레이션 모드 선택
마이그레이션 모드 선택 섹션은 마이그레이션 요구 사항에 가장 적합한 마이그레이션 모드를 제공하는 데 사용됩니다.
다음 옵션에서 적절한 모드를 선택합니다.
Description 오프라인 오프라인 마이그레이션은 처음에 컬렉션의 스냅샷을 캡처하여 더 간단하고 예측 가능한 접근 방식을 제공합니다. 컬렉션의 정적 복사본을 사용할 수 있는 경우 잘 작동하며 실시간 업데이트는 필수가 아닙니다. 비프로덕션 마이그레이션에는 이 옵션을 사용합니다. 온라인 온라인 마이그레이션은 컬렉션 데이터를 복사하여 프로세스 중에 업데이트도 복제되도록 합니다. 이 방법은 가동 중지 시간을 최소화하면서 비즈니스 연속성을 위한 지속적인 운영을 가능하게 하는 장점이 있습니다. 진행 중인 작업이 중요하고 가동 중지 시간을 줄이는 것이 우선 순위인 경우 이 옵션을 사용합니다. 
비고
연속 백업은 온라인 마이그레이션을 위한 필수 구성 요소입니다. 자세한 내용은 연속 백업을 참조하세요.
다음을 선택합니다.
대상 마이그레이션 자격 증명 구성
대상 계정 선택 섹션은 대상 Azure DocumentDB 클러스터에 대한 연결 세부 정보를 제공하는 데 사용됩니다. 보안 모범 사례로 Azure Key Vault에 네이티브 인증 자격 증명을 저장하는 것이 좋습니다.
비고
Microsoft Entra ID 인증을 사용하는 연결 문자열은 현재 지원되지 않습니다.
볼트 URI 및 비밀 이름 필드를 이 가이드의 앞부분에서 기록한 값으로 설정하십시오.
다음을 선택합니다.
대상 방화벽 업데이트
대상 방화벽 업데이트 섹션은 대상 Azure DocumentDB 클러스터의 방화벽이 마이그레이션 작업 요청을 차단하지 않도록 하는 데 사용됩니다.
이 단계에서 IP 주소를 관찰합니다.
다른 브라우저 창 또는 탭을 사용하여 대상 Azure DocumentDB 클러스터로 이동합니다.
리소스 메뉴의 설정 섹션에서 네트워킹을 선택합니다.
마이그레이션 작업의 IP 주소에 대한 액세스를 허용하는 규칙을 추가합니다. 자세한 내용은 클러스터 수준 방화벽 규칙 관리를 참조하세요.
마이그레이션 작업 구성 단계를 사용하여 브라우저 창 또는 탭으로 다시 이동합니다.
다음을 선택합니다.
비고
Azure Key Vault에서 네트워크 보안을 사용하도록 설정한 경우 동일한 IP가 Azure Key Vault 방화벽에도 추가 되었는지 확인합니다.
작업 구성 및 시작
컬렉션 선택 및 확인 및 제출 섹션을 사용하여 작업 구성을 완료합니다.
컬렉션 선택 섹션에서 마이그레이션하려는 컬렉션을 선택합니다 .
다음을 선택합니다.
작업 구성을 검토하고 고유한 작업 이름을 제공합니다.
중요합니다
- 마이그레이션 작업은 인덱스를 대상 컬렉션으로 전송하지 않습니다. 계속하기 전에 이 샘플 마이그레이션 스크립트 를 사용하여 대상 컬렉션에 인덱스를 만듭니다. 인덱스가 준비되면 확인란을 선택합니다.
- 마이그레이션 작업은 분할 키 변경을 지원하지 않습니다. 다른 분할된 데이터베이스 키가 필요한 경우 데이터를 분할되지 않은 컬렉션으로 마이그레이션합니다. 마이그레이션이 완료되면 원하는 분할 키를 사용하여 대상에 컬렉션을 분할합니다.
제출을 선택하여 작업을 만들고 시작합니다.
마이그레이션 작업 모니터링
작업이 제출되면 새로 만든 작업의 상태를 다른 보류 중 또는 완료된 작업과 함께 모니터링할 수 있습니다.
원본 Azure Cosmos DB for MongoDB 계정으로 이동합니다.
계정 페이지의 리소스 메뉴에서 DocumentDB로 마이그레이션 을 선택합니다.
기존 마이그레이션 작업 모니터링을 선택합니다.
현재 원본 계정에 대해 생성된 모든 마이그레이션 작업이 나열됩니다.
필요에 따라 작업의 상태를 변경하려면 특정 작업에 해당하는 상황에 맞는 메뉴(..)를 선택합니다. 옵션은 다음과 같습니다.
Option Description 일시 중지 현재 실행 중인 작업을 일시적으로 일시 중지 다시 시작 일시 중지된 작업 다시 시작 취소 현재 실행 중인 작업을 영구적으로 취소 컷오버 원본 및 대상이 동기화될 때 마이그레이션 완료 비고
전환 옵션은 온라인 마이그레이션에만 적용됩니다. 전환이 완료되면 원본 계정과 대상 클러스터 간의 동기화가 종료됩니다. 전환 작업을 수행한 후에는 클라이언트 애플리케이션의 자격 증명을 업데이트하여 새 Azure DocumentDB 클러스터를 대상으로 지정해야 합니다.