마이그레이션 작업은 관계형 데이터베이스 에서 MongoDB 로 데이터와 스키마를 전송하는 작업을 담당하는 작업자 프로세스입니다. Data Migration 탭 에서 새 마이그레이션 작업 만듭니다.
이 작업 Apache Kafka 지원 연속 마이그레이션 작업에도 적용됩니다. Kafka 사용할 때 도입되는 절차상의 차이점은 없습니다. 자세한 내용은 Kafka 배포를 참조하세요.
이 작업에 대하여
마이그레이션 작업 만들 때 제공한 URI 자격 증명 프로젝트 만들 때 사용한 자격 증명 과 동일할 필요가 없습니다.
기존 관계형 데이터베이스 연결을 사용하거나 마이그레이션 작업 만들 때 연결할 수 있습니다.
Confluent Cloud Kafka 사용한 연속 마이그레이션 작업은 Confluent Cloud의 백엔드 리소스 프로비저닝 으로 인해 시간이 추가로 걸릴 수 있습니다. 이 프로세스 일반적으로 CDC 마이그레이션 작업 처음 실행할 때 2~5분 정도 추가로 소요됩니다.
지속적인 마이그레이션 작업은 완료 시 제거되는 임시 캐시 컬렉션을 생성할 수 있습니다.
연속 마이그레이션 작업 실패 후 24 시간 이내에 복구할 수 있습니다. 자세한 내용은 마이그레이션 작업 복구를 참조하세요.
시작하기 전에
Relational Migrator 프로젝트에서 매핑 규칙을 하나 이상 생성 합니다.
Atlas 배포와 온프레미스 배포 모두에서,MongoDB database 에 대한 액세스 있는 Relational Migrator 에 대해 별도의 MongoDB 사용자를 생성합니다.
readWrite
JDBC 운전자 사용하여 스냅샷 마이그레이션 수행하는 경우 MongoDB 담당자에게 구성 정보를 문의 .
단계
관계형 데이터베이스 연결 세부 정보 입력
Connect to your source database 양식에 연결 세부 정보를 입력하여 relational database에 대한 JDBC URI를 생성합니다.
저장된 관계형 데이터베이스 연결을 사용하려면 를 클릭하고 Use a saved connection 드롭다운에서 선택한 다음 필요한 경우 자격 증명 입력합니다.
새 연결을 만들려면 다음을 수행합니다.
Database type 드롭다운에서 데이터베이스 유형을 선택합니다.
연결 문자열 직접 입력하려면 Enter URI manually 토글을 활성화 하고 연결 문자열 JDBC URI에 붙여넣습니다.
데이터베이스 정보를 입력하여 연결 문자열 생성하려면 다음을 입력합니다.
필드값Host
호스팅하다 IP 또는 DNS 이름입니다.
Port
포트 번호입니다.
Database
데이터베이스 이름입니다. 필수입니다.
Identifier
Service Name 또는 SID 중 하나입니다.
Username 개인정보 정책에 Password
인증 에 사용할 자격 증명 입니다.
Save password 을 선택하면 비밀번호가 시스템에 안전하게 저장되므로 저장된 연결을 사용할 때 Username 및 Password 를 다시 입력할 필요가 없습니다.
필드값Host
호스팅하다 IP 또는 DNS 이름입니다.
Port
포트 번호입니다.
Database
데이터베이스 이름입니다. 이 항목을 비워두면 모든 데이터베이스의 기본값
dbo
스키마 에 있는 객체만 표시됩니다.Authentication
기본값 으로 SQL Server로 설정하다 됩니다. Relational Migrator 실행 파일을 시작한 사용자의 자격 Windows 증명 사용하여 Windows 통합 인증을 활성화 하려면 로 설정합니다. 이렇게 하면 Username 및 Password 필드가 비활성화됩니다.
Username 개인정보 정책에 Password
인증 에 사용할 자격 증명 입니다. Authentication 이(가) Windows(으)로 설정하다 경우 비활성화됩니다.
Save password 을 선택하면 비밀번호가 시스템에 안전하게 저장되므로 저장된 연결을 사용할 때 Username 및 Password 를 다시 입력할 필요가 없습니다.
General / SSL 토글
연결에 대한 SSL 설정을 확인합니다.
SSL을 사용하려면 먼저 파일
server.ssl
에서 구성 속성의 주석 처리를 제거하고 업데이트user.properties
해야 합니다.SSL: Use SSL
SSL을 활성화하거나 비활성화합니다.
SSL: Trust server certificate
SSL을 활성화한 상태에서 저장된 인증서를 신뢰하려면 이 확인란을 선택합니다. 신뢰할 수 있는 인증 기관에 대해 서버 인증서를 확인하려면 선택하지 않은 상태로 둡니다.
필드값Host
호스팅하다 IP 또는 DNS 이름입니다.
Port
포트 번호입니다.
Database
데이터베이스 이름입니다. 모든 데이터베이스를 로드하려면 비워 둡니다.
Username 개인정보 정책에 Password
인증 에 사용할 자격 증명 입니다.
Save password 을 선택하면 비밀번호가 시스템에 안전하게 저장되므로 저장된 연결을 사용할 때 Username 및 Password 를 다시 입력할 필요가 없습니다.
General / SSL 토글
연결에 대한 SSL 설정을 확인합니다.
SSL을 사용하려면 먼저 파일
server.ssl
에서 구성 속성의 주석 처리를 제거하고 업데이트user.properties
해야 합니다.SSL: Use SSL
SSL을 활성화하거나 비활성화합니다.
SSL: SSL mode
SSL을 활성화한 상태에서 다음 중에서 선택합니다.
Preferred (기본값): 가능하면 암호화됨 연결을 만들고, 그렇지 않으면 암호화되지 않은 연결로 돌아갑니다.
Required: 암호화됨 연결이 필요합니다.
Verify CA: 신뢰할 수 있는 인증 기관을 대상으로 서버 인증서를 확인합니다.
Verify identity: 인증서 내용과 비교하여 데이터베이스 연결 정보를 확인합니다.
필드값Host
호스팅하다 IP 또는 DNS 이름입니다.
Port
포트 번호입니다.
Database
데이터베이스 이름입니다. 기본값 데이터베이스 에 연결하려면 비워 둡니다.
Username 개인정보 정책에 Password
인증 에 사용할 자격 증명 입니다.
Save password 을 선택하면 비밀번호가 시스템에 안전하게 저장되므로 저장된 연결을 사용할 때 Username 및 Password 를 다시 입력할 필요가 없습니다.
General / SSL 토글
연결에 대한 SSL 설정을 확인합니다.
SSL을 사용하려면 먼저 파일
server.ssl
에서 구성 속성의 주석 처리를 제거하고 업데이트user.properties
해야 합니다.SSL: Use SSL
SSL을 활성화하거나 비활성화합니다.
SSL: SSL mode
SSL을 활성화한 상태에서 다음 중에서 선택합니다.
Prefer (기본값): 가능하면 암호화됨 연결을 만들고, 그렇지 않으면 암호화되지 않은 연결로 돌아갑니다.
Require: 암호화됨 연결이 필요합니다.
Verify CA: 신뢰할 수 있는 인증 기관을 대상으로 서버 인증서를 확인합니다.
Verify full: 인증서 내용과 비교하여 데이터베이스 연결 정보를 확인합니다.
Connection name 및 선택 사항인 Environment tag을(를) 입력합니다.
Connect를 클릭합니다.
저장된 연결은 모든 작업 및 프로젝트에서 사용할 수 있습니다.
MongoDB 연결 세부 정보 입력
저장된 MongoDB 연결을 사용하려면 를 클릭하고 드롭다운에서 Use a saved connection 선택한 다음 필요한 경우 자격 증명 입력합니다.
새 연결을 만들려면 다음을 수행합니다.
MongoDB 연결 문자열 입력합니다.
MongoDB connection string (URI) 에 MongoDB URI를 입력합니다.
X.509 인증 사용하는 경우 Relational Migrator 연결 문자열 구문과 인증서 파일 형식을 확인합니다.
연결 문자열 에 포함되어 있지 않은 경우 연결할 Database 를 입력합니다.
해당 항목이 연결 문자열 에 포함되어 있지 않고 X.509 인증 사용하지 않는 Username Password 경우 Relational Migrator MongoDB 사용자의 및 를 입력합니다.
Connection name 및 선택 사항인 Environment tag을(를) 입력합니다.
Connect를 클릭합니다.
저장된 연결은 모든 작업 및 프로젝트에서 사용할 수 있습니다.
Migration Options 양식에서 을 Migration Options 선택합니다.
마이그레이션 옵션 | 설명 |
---|---|
모드 | Snapshot 또는 Continuous 마이그레이션. JDBC 운전자를 통해 연결된 데이터베이스의 경우 Relational Migrator 스냅샷 마이그레이션 만 지원합니다. 이러한 데이터베이스에는 Continuous 옵션이 비활성화되어 있습니다. |
마이그레이션 전에 대상 collection 삭제 | 부울. Relational Migrator가 데이터를 전송하기 전에 대상 collection을 삭제하는지 여부를 나타냅니다. |
오류 후 중지 | 정수. Relational Migrator 마이그레이션 작업 중지한 후의 오류 수를 나타냅니다. |
마이그레이션된 데이터 확인 | 부울. true인 경우 동기화 엔진 소스 데이터베이스 기준으로 마이그레이션된 데이터를 확인합니다. 스냅샷 모드 에서만 지원됩니다. |
Mode을 설정하다 하면 Relational Migrator 데이터베이스 올바르게 구성되었는지 확인합니다. 문제가 발견되면 경고 배너와 SQL 스크립트 다운로드 할 수 있는 Generate Script 버튼을 표시합니다. 이 스크립트 필수 구성 설명과 추가 지침이 주석으로 포함되어 있습니다.
경고
마이그레이션 작업 시작하기 전에 다음을 수행합니다.
스크립트를 다운로드합니다.
내용을 주의 깊게 검토합니다.
명령문을 실행합니다.
주석이 달린 수동 단계를 따릅니다.
마이그레이션 작업 검토 및 시작
Review Summary 양식에서 마이그레이션 작업 에 대한 세부 정보를 볼 수 있습니다. 이러한 세부 정보에는 마이그레이션 작업 의 유형, 영향을 받는 테이블 및 행 수, 예상 데이터 크기가 포함됩니다. 마이그레이션 작업 시작하려면 Start을(를) 클릭합니다.
Kafka 마이그레이션 작업에 대한 배포서버 세부 정보를 보려면 Data Migration 화면의 History 창에서 작업 선택하고 Create Migration Job 버튼 옆에 있는 아이콘 위로 마우스를 가져갑니다.
중요
Atlas cluster 로의 대규모 마이그레이션 작업의 경우, 검토 요약에 더 높은 클러스터 계층을 권장하는 Atlas Performance Suggestions 가 포함될 수 있습니다. 업그레이드는 선택 사항이지만 마이그레이션 시간을 단축합니다.
Upgrade on Atlas 를 클릭하여 새 브라우저 탭 또는 창 에서 Atlas 엽니다. 업그레이드 하고 싶지만 필요한 권한이 없는 경우 관리자에게 문의 하세요.
다음 단계
자세히 알아보기
각 데이터베이스 의 구성 요구 사항에 대한 자세한 내용은 다음을 참조하세요.