샘플 스키마와 함께 Relational Migrator 사용

이 작업에 대하여

샘플 스키마를 사용하여 프로젝트를 만드는 것은 Relational Migrator를 테스트하는 가장 빠르고 쉬운 방법입니다.

프로젝트 생성을 마무리하기 전에 초기 매핑을 선택할 수 있습니다. 이러한 옵션에는 relational database를 기반으로 Relational Migrator가 자동으로 제안하는 권장 MongoDB 스키마로 시작하는 것이 포함됩니다.

시작하기 전에

샘플 스키마 에서 마이그레이션 작업을 실행 하려면 먼저 다음 중 하나를 수행해야 합니다.

1. Docker 를 다운로드하여 제공된 PostgreSQL 데이터베이스 컨테이너 가져오고 호스팅하다 . 이 컨테이너 에는 Relational Migrator 에 제시된 샘플 스키마 미리 로드되어 제공됩니다.

2. 기존 PostgreSQL 인스턴스에서 Northwind.sql 데이터베이스 설정 스크립트를 다운로드하여 실행합니다. 이 스크립트 샘플 스키마 를 로드합니다.

단계

다음 단계는 마이그레이션 작업을 통해 데이터를 마이그레이션하기 위해 Docker 컨테이너 에 연결하는 프로세스 가이드 . 이는 필수 사항이 아니므로 마이그레이션 작업을 실행 하지 않고도 프로젝트 만들 수 있습니다. 마이그레이션 작업을 실행 계획이 없다면 1단계를 건너뛰세요.

1. (선택 사항) 터미널 창에서 다음 Docker 명령을 실행하여 PostgreSQL relational database 인스턴스를 시작합니다.

   docker run -p 5432:5432 public.ecr.aws/v4d7k6c9/relational-migrator-sample-database

   이 데이터베이스 인스턴스에 대한 연결 자격 증명은 다음과 같습니다.

   • 사용자 이름: postgres

   • 비밀번호: postgres

   • 포트: 5432

   경고

   PostgreSQL 데이터베이스는 데모용으로만 사용되며 프로덕션 목적으로 사용해서는 안 됩니다.

2. Relational Migrator에서 Relational Migrator 홈 화면의 오른쪽 상단에 있는 New Project 을(를) 클릭합니다.

3. Create sample 버튼을 클릭합니다.

4. Select tables 화면에서 마이그레이션하려는 테이블을 표시하고 Next 을 클릭합니다.

   아래 탭에서는 마이그레이션 할 테이블을 선택할 수 있는 다양한 방법에 대해 설명합니다.

   수동 선택

   대량 선택

   1. 데이터베이스, 스키마 및 테이블을 보려면 트리를 확장합니다.

   2. 확인 표시를 사용하여 항목을 선택합니다.

      • 데이터베이스 내의 모든 테이블: 데이터베이스의 확인 표시를 클릭합니다.

      • 스키마 내의 모든 테이블: 데이터베이스 확장하고 스키마에 대한 확인 표시를 클릭합니다.

      • 스키마 내의 특정 테이블: 데이터베이스 와 스키마 확장한 다음 테이블을 개별적으로 선택합니다.

      • 특정 테이블 이름: Relational Schema 목록 위의 Filter 표시줄을 사용합니다.

   1. Bulk Selection(으)로 전환합니다.

   2. 정규화된 테이블 이름의 쉼표로 구분된 목록( 예시: database.schema.table)을 붙여넣거나 입력합니다.

      Relational Migrator 입력 시 목록을 필터링하고 일치하는 테이블을 클릭하여 포함하거나 제외할 수 있습니다.

5. 컬렉션 이름에 Global casing 옵션을 선택합니다.

   이 옵션은 relational database의 테이블에서 생성된 collection의 이름에 영향을 줍니다.

   • Keep Original: relational database 테이블 이름에 사용된 원래의 대소문자를 유지합니다.

   • Override with Global Casing: 원래 테이블 이름을 글로벌 대소문자 규칙으로 재정의합니다.

     • camelCase

     • TitleCase

     • kebab-case

     • snake_case

     • UPPER_SNAKE_CASE

6. MongoDB 스키마에 대한 Initial mappings 옵션을 선택합니다.

   • Start with a MongoDB schema that matches your relational schema

     각 테이블에 대한 새 문서 매핑 규칙을 사용하여 초기 프로젝트 생성합니다. 이 옵션은 가져온 관계형 테이블의 테이블을 데이터베이스 및 스키마 별로 그룹화하고 알파벳순으로 나열하여 표시합니다. 각 컬렉션 top-level 컬렉션 으로 표시됩니다. 각 표에서 해당 컬렉션 이름을 볼 수 있습니다. 컬렉션 이름의 경우 Relational Migrator 원래 테이블 이름에 글로벌 대/소문자를 적용합니다.

   • Start with a recommended MongoDB schema

     Relational Migrator는 제안된 MongoDB 스키마에 대한 매핑 규칙을 생성합니다. 이 옵션을 선택하면 가져온 관계형 테이블을 보여주는 테이블이 나타납니다. Relational Migrator는 어떤 테이블이 top-level 또는 embedded collection으로 표시되어야 하는지 제안합니다. 확인란을 사용하여 collection에 매핑되거나 포함된 테이블을 수정할 수 있습니다.

   • Start with an empty MongoDB schema

     매핑 규칙 없이 초기 프로젝트를 생성합니다.

   참고

   프로젝트를 시작할 때 선택한 옵션에 관계없이 언제든지 매핑 규칙을 수동으로 추가, 제거 또는 수정할 수 있습니다. 이를 통해 워크로드의 특정 요구 사항에 따라 MongoDB 스키마를 사용자 지정할 수 있습니다.

7. 프로젝트의 이름을 입력합니다.

8. Done를 클릭합니다.

다음 단계

• Relational에서 매핑 규칙 만들기

• MongoDB에 대한 매핑 규칙 만들기