Azure Cosmos DB Migration for MongoDB 익스텐션은 MongoDB 워크로드를 Azure Cosmos DB로 마이그레이션하는 데 도움이 됩니다. 이 문서에서는 마이그레이션 익스텐션에 대한 일반적인 질문과 대답을 제공합니다.
"유효성 검사 실행" 단계가 실패하는 경우 평가를 실행하려면 어떻게 해야 하나요?
유효성 검사에 실패한 이유를 확인하려면 익스텐션에 표시되는 오류를 참조하세요. 일반적으로 이 문제는 MongoDB 엔드포인트에 연결할 수 없는 경우 발생합니다. 연결된 서버에 대한 충분한 권한이 없는 사용자가 평가를 실행하는 데 문제가 있을 수도 있습니다.
평가를 실행하려면 원본 인스턴스에서 MongoDB에 연결된 사용자에게 readAnyDatabase 및 clusterMonitor 역할이 할당되어 있어야 합니다.
grantRolesToUser을(를) 사용하여 현재 연결된 사용자에 대한 적절한 역할을 구성합니다.
"기능 호환성" 범주에서 평가에 대한 컬렉션 이름과 데이터베이스 이름은 어떻게 볼 수 있나요?
이 평가는 serverStatus 명령을 사용하여 기능 호환성 평가를 실시합니다. 이 명령은 데이터베이스 또는 컬렉션 이름에 대한 세부 정보를 제공하지 않으므로 익스텐션은 리소스 이름을 보고할 수 없습니다.
보다 세부적인 평가 세부 정보를 보려면 로그 폴더 경로 필드에 MongoDB 프로파일러 로그가 포함된 폴더 경로를 제공하여 평가를 다시 실행하세요.
로그 메시지를 수집하려면 어떻게 하나요?
/var/log/mongodb/mongodb.log 경로에서 로그 파일을 찾을 수 있습니다. 로그 파일을 찾을 수 없는 경우 MongoDB 구성 파일에서 위치를 확인합니다.
자세한 내용은 MongoDB 로그 메시지를 참조하세요.
마이그레이션이 시작되면 마이그레이션된 문서의 정확한 개수를 볼 수 없고 예상값만 제공되는 이유는 무엇인가요?
마이그레이션 중 원본에서 리소스 사용량을 줄이기 위해 익스텐션은 정확한 개수를 검색하는 대신 원본에서 대상으로 이동할 각 컬렉션의 문서 수를 예측합니다.
컬렉션 매핑 단계에서 일부 컬렉션이 누락되거나 비활성화된 이유는 무엇인가요?
vCore 기반 Azure Cosmos DB for MongoDB는 시계열 또는 클러스터형 컬렉션을 지원하지 않습니다. 따라서 이러한 유형의 컬렉션은 컬렉션 매핑 단계에서 누락되거나 비활성화됩니다.
vCore 기반 Azure Cosmos DB for MongoDB에서 보기를 지원하는 경우 컬렉션 매핑 단계에서 보기가 누락되거나 비활성화되는 이유는 무엇인가요?
vCore 기반 Azure Cosmos DB for MongoDB는 새 보기 만들기를 지원합니다. 그러나 마이그레이션 익스텐션은 기존 보기 마이그레이션을 지원하지 않습니다.
마이그레이션이 완료되면 항상 보기를 다시 만들 수 있습니다.
마이그레이션 후 대상 계정에서 얼마나 많은 스토리지를 사용해야 하나요?
vCore 기반 Azure Cosmos DB for MongoDB는 디스크의 데이터를 압축하지 않습니다. 일반적인 추정 근사값은 원본 MongoDB 인스턴스의 컬렉션에서 사용하는 스토리지 크기를 두 배로 늘려 대상 vCore 기반 Azure Cosmos DB for MongoDB 계정의 스토리지를 추정하는 것입니다.
MongoDB에서 vCore 기반 Azure Cosmos DB for MongoDB로 마이그레이션할 때 건너뛰는 컬렉션 및 데이터베이스는 무엇인가요?
MongoDB의 내부 데이터베이스로 간주되는 데이터베이스 및 컬렉션은 다음과 같습니다.
| 리소스 | |
|---|---|
| 데이터베이스 | |
| 컬렉션 | system 접두사가 포함된 모든 컬렉션. |
내부 데이터베이스 및 컬렉션은 vCore 기반 Azure Cosmos DB for MongoDB에서 필요하지 않으므로 익스텐션에서는 이러한 데이터베이스의 마이그레이션을 사용 설정하지 않습니다.
이름이 숫자로 시작하는 데이터베이스 및 컬렉션을 마이그레이션할 수 있나요?
이것은 알려진 문제입니다. 마이그레이션은 이름이 숫자로 시작하는 데이터베이스 및 컬렉션을 지원하지 않습니다.
마이그레이션할 컬렉션을 여러 개 선택하면 컬렉션이 병렬로 마이그레이션되나요?
Azure Database Migration Service의 각 마이그레이션 작업은 마이그레이션을 위한 두 가지 학습을 제공합니다. 각 학습은 언제든지 하나의 컬렉션을 마이그레이션합니다. 따라서 두 컬렉션은 일반적으로 병렬로 마이그레이션됩니다. 한 컬렉션의 마이그레이션이 완료되면 다음 컬렉션이 자동으로 선택됩니다. 마이그레이션할 컬렉션이 많은 경우 여러 마이그레이션 작업을 만듭니다. 각 작업에는 보다 효율적인 마이그레이션을 위해 범위가 지정된 컬렉션 수가 있어야 합니다.
단일 마이그레이션에서 마이그레이션할 수 있는 데이터베이스 및 컬렉션은 몇 개인가요?
단일 마이그레이션에 포함할 수 있는 데이터베이스 및 컬렉션 수에는 제한이 없습니다. 그러나 Azure Database Migration Service에서 마이그레이션 작업을 만들 때 선택한 컬렉션은 50개 배치로 분할됩니다. 대량의 컬렉션의 경우 마이그레이션 목록에 여러 마이그레이션 작업이 표시됩니다.
마이그레이션할 컬렉션의 순서 및 수량을 계획하려면 어떻게 해야 하나요?
마이그레이션할 컬렉션을 여러 개 선택하면 컬렉션이 마이그레이션되는 순서를 구성할 수 없습니다. 마이그레이션 순서를 제어하려면 원하는 시퀀스에 따라 컬렉션을 더 작은 배치로 마이그레이션합니다. 최상의 성능을 얻으려면 큰 컬렉션과 작은 컬렉션을 하나의 배치로 묶지 마세요.
연결 문제를 방지하기 위해 vCore 기반 Azure Cosmos DB for MongoDB 및 MongoDB 방화벽을 구성하려면 어떻게 해야 하나요?
글로벌 Azure 데이터 센터의 연결을 허용하도록 vCore 기반 Azure Cosmos DB for MongoDB 대상 계정에 방화벽 예외를 추가합니다. 자세한 내용은 Azure Cosmos DB 방화벽 구성을 참조하세요.
연결 문제를 방지하려면 원본 서버 방화벽을 어떻게 구성해야 하나요?
글로벌 Azure 데이터 센터의 연결을 허용하도록 원본 MongoDB 인스턴스를 구성합니다. 자세한 내용은 글로벌 Azure IP 주소 범위를 참조하세요.
Warning
익스텐션은 프라이빗 엔드포인트 사용 원본 또는 대상 MongoDB 인스턴스를 지원하지 않습니다. 익스텐션은 Azure Database Migration Service의 자체 호스팅 통합 런타임을 지원하지 않습니다.
마이그레이션 작업이 내 컴퓨터에서 로컬로 실행되나요?
데이터베이스, 컬렉션 및 인덱스는 로컬 Azure Data Studio 클라이언트의 명령을 사용하여 직접 만들어집니다. 이 기능을 사용하려면 원본 환경과 대상 환경 모두와 Azure Data Studio를 실행하는 클라이언트 간에 연결이 필요합니다.
데이터 마이그레이션 작업은 Azure Database Migration Service에서 실행됩니다. 마이그레이션 서비스는 데이터 이동 활동을 오케스트레이션하고 수행하는 Azure 서비스 인스턴스입니다. 데이터 마이그레이션 작업을 만든 후에는 원본 및 대상 환경에 연결할 필요가 없습니다.
동시에 몇 개의 마이그레이션을 실행할 수 있나요?
동시에 만들 수 있는 마이그레이션 수에는 제한이 없습니다.
마이그레이션 중에 데이터베이스 및 컬렉션의 이름을 바꿀 수 있나요?
익스텐션은 마이그레이션 중에 데이터베이스 및 컬렉션 이름 바꾸기를 지원하지 않습니다.
여러 마이그레이션 반복을 통해 컬렉션을 마이그레이션할 수 있나요?
컬렉션 수가 제한된 마이그레이션 작업을 여러 개 만들 수 있습니다. 이 접근 방식은 마이그레이션 속도를 최적화하는 모범 사례입니다.
평가 보고서에는 무엇이 포함되나요?
보고서의 초기 부분에는 원본 MongoDB 환경의 요약을 포함하여 평가 실행의 주요 세부 정보가 있습니다. 세부 정보에는 원본 MongoDB 버전, 라이선스 유형 및 인스턴스 유형이 포함됩니다. 이 부분에는 평가된 데이터베이스 및 컬렉션 목록과 해당 평가 요약 및 마이그레이션 준비 상태도 포함되어 있습니다.
조사 결과는 위험, 경고 및 정보 범주로 분류됩니다. 이러한 범주를 통해 중요도에 따라 검색 결과의 우선순위를 정할 수 있습니다.
평가 확인에는 다음이 포함됩니다.
| 설명 | |
|---|---|
| 컬렉션 옵션 | 지원되지 않는 컬렉션 설정과 관련된 결과입니다. 예를 들어 시계열 및 데이터 정렬이 있습니다. |
| 기능 | 집계 파이프라인 쿼리를 포함하여 지원되지 않는 데이터베이스 명령, 쿼리 구문 또는 연산자와 관련된 결과입니다. 추가 세부 정보 열에서는 원본 엔드포인트에서 특정 기능이 사용되는 빈도를 확인할 수 있습니다. |
| 한도 및 할당량 | vCore 기반 Azure Cosmos DB for MongoDB 관련 할당량 및 한도와 관련된 결과입니다. |
| 인덱스 | 지원되지 않는 MongoDB 인덱스 유형 또는 속성과 관련된 결과입니다. |
| 분할 키 | 지원되지 않는 분할 키 구성과 관련된 결과입니다. |
익스텐션은 어떤 유형의 로그를 생성하나요?
익스텐션은 오류, 경고 및 기타 진단 로그를 기본 로그 디렉터리에 저장합니다.
- Windows -
C:\Users\<username>\.dmamongo\logs\ - Linux -
~/.dmamongo/logs - macOS -
/Users/<username>/.dmamongo/logs
참고 항목
매일 별도의 로그 파일이 생성됩니다. 기본적으로 익스텐션은 마지막 7개의 로그 파일을 저장합니다.