Database Migration Service를 사용하여 데이터베이스를 PostgreSQL용 Cloud SQL로 마이그레이션

MySQL   |  PostgreSQL   |  PostgreSQL to AlloyDB

이 빠른 시작에서는 Database Migration Service를 사용하여 데이터를 PostgreSQL용 Cloud SQL로 마이그레이션하는 방법을 보여줍니다. 이 빠른 시작에서 만든 리소스는 정리 단계까지 모든 단계를 적시에 완료한다고 가정할 때 1달러 (USD) 미만의 비용이 소요됩니다.

시작하기 전에

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

4. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

5. Make sure that billing is enabled for your Google Cloud project.

6. Enable the Database Migration Service API.

   Enable the API

7. 사용자 계정에 데이터베이스 마이그레이션 관리자 역할이 할당되었는지 확인합니다.

   IAM 페이지로 이동

요구사항

Database Migration Service는 다양한 소스 데이터베이스 옵션과 연결 방법을 제공합니다. 소스마다 더 효과적인 연결 방법이 있습니다. 이 빠른 시작에서는 네트워크를 구성하여 인바운드 방화벽 규칙을 추가할 수 있는 환경에서 독립형 PostgreSQL 데이터베이스를 사용하고 있다고 가정합니다. 소스 데이터베이스는 온프레미스 또는 클라우드 제공업체에 있어야 합니다. Google에서는 사용자 환경의 세부사항을 알 수 없기 때문에 네트워킹 구성과 관련해서 세부 단계를 제공할 수 없습니다.

이 빠른 시작에서는 소스 데이터베이스 엔진으로 PostgreSQL을 선택하고 네트워킹 방법으로 IP 허용 목록을 선택합니다.

소스 연결 프로필 만들기

연결 프로필을 만들면 소스 데이터베이스에 관한 정보가 포함된 레코드가 생성됩니다. Database Migration Service는 연결 프로필의 정보를 사용하여 소스 데이터베이스의 데이터를 대상 Cloud SQL 데이터베이스 인스턴스로 마이그레이션합니다.

1. Google Cloud 콘솔에서 Database Migration Service 연결 프로필 페이지로 이동합니다.

   Database Migration Service 연결 프로필 페이지로 이동

2. 프로필 만들기를 클릭합니다.

3. 연결 프로필 만들기 페이지의 프로필 역할 목록에서 소스를 선택합니다.

4. 데이터베이스 엔진 목록에서 소스 데이터베이스의 다음 분류 유형 중 하나를 선택합니다.

   • 독립형 PostgreSQL 인스턴스 (PostgreSQL)
   • 기존 PostgreSQL용 Cloud SQL 인스턴스 (PostgreSQL용 Cloud SQL)
   • PostgreSQL용 Amazon RDS 인스턴스 (PostgreSQL용 Amazon RDS)

   이 빠른 시작에서는 PostgreSQL을 선택합니다.

4. 다음 정보를 제공합니다.
   • 연결 프로필 이름 필드에 소스 데이터베이스의 연결 프로필 이름을 입력합니다(예: My Connection Profile).
   • 자동 생성된 연결 프로필 ID를 그대로 둡니다.
   • 연결 정보를 입력합니다.
     • 자체 호스팅 데이터베이스에서 복제하는 경우 호스트 이름 또는 IP 주소 (도메인 또는 IP)와 포트를 입력하여 호스트에 액세스합니다. 기본 PostgreSQL 포트는 5432입니다.
     • Cloud SQL 데이터베이스에서 복제하는 경우 드롭다운 목록에서 Cloud SQL 인스턴스를 선택합니다.
   • 사용자 이름과 비밀번호를 입력하여 소스 인스턴스에 인증을 수행합니다.
   • (선택사항) 공개 네트워크 (IP 허용 목록 사용)를 통해 민감한 정보를 전송하려는 경우 소스 데이터베이스와 대상 데이터베이스 간의 연결에 SSL/TLS 암호화를 사용하는 것이 좋습니다. 그렇지 않으면 기본값인 None을 유지합니다.

5. 페이지의 연결 프로필 리전 섹션에서 연결 프로필을 저장할 리전을 선택합니다.

   모든 리소스와 마찬가지로 연결 프로필이 리전에 저장됩니다. 선택한 리전은 이 리전을 사용할 수 있는 마이그레이션 작업이나 데이터 위치 자체에 연결할 수 있는 리전에 영향을 주지 않지만 리전별 다운타임이 발생할 경우 가용성에는 영향을 줄 수 있습니다.

6. 만들기를 클릭합니다.

마이그레이션 작업 만들기

Database Migration Service는 마이그레이션 작업을 사용하여 소스 데이터베이스 인스턴스에서 대상 Cloud SQL 데이터베이스 인스턴스로 데이터를 마이그레이션합니다.

마이그레이션 작업을 만들면 다음이 포함됩니다.

• 작업 설정 정의
• 소스 데이터베이스에 대해 만든 연결 프로필 (소스 연결 프로필) 선택
• 대상 Cloud SQL 데이터베이스 인스턴스의 설정 정의
• 소스 및 대상 데이터베이스 인스턴스 간의 연결 설정
• 마이그레이션 작업을 테스트하여 작업에 대해 제공한 연결 정보가 유효한지 확인합니다.

마이그레이션 작업의 설정 정의

1. Google Cloud 콘솔에서 Database Migration Service 마이그레이션 작업 페이지로 이동합니다.

   Database Migration Service 마이그레이션 작업 페이지로 이동

2. 이전 작업 만들기를 클릭합니다.

3. 마이그레이션 작업 이름 필드에 마이그레이션 작업의 이름(예: My Migration Job)을 입력합니다.

4. 자동 생성된 이전 작업 ID를 그대로 둡니다.

5. 소스 데이터베이스 엔진 드롭다운 목록을 열고 소스 데이터베이스의 분류 유형을 선택합니다.

6. 대상 인스턴스를 만들 대상 리전을 선택합니다.

7. 소스 데이터베이스에서 진행 중인 변경사항을 대상 Cloud SQL 데이터베이스 인스턴스로 마이그레이션하려면 마이그레이션 작업 유형을 '연속'으로 설정합니다.

8. 마이그레이션 작업에 맞게 환경을 준비해야 하는 방법이 자동으로 반영되도록 생성된 필수 기본 요건을 검토합니다. 이러한 기본 요건에는 소스 데이터베이스를 구성하는 방법과 대상 Cloud SQL 데이터베이스 인스턴스에 연결하는 방법이 포함될 수 있습니다. 이 단계에서 이러한 기본 요건을 완료하는 것이 가장 좋지만, 마이그레이션 작업을 테스트하거나 시작하기 전 언제라도 이를 완료할 수 있습니다. 이러한 기본 요건에 대한 자세한 내용은 소스 구성을 참고하세요.

9. 저장 후 계속을 클릭합니다.

소스 연결 프로필 정보 지정

1. 소스 연결 프로필 선택 드롭다운 목록을 열고 내가 만든 연결 프로필을 선택합니다.

2. 저장 후 계속을 클릭합니다.

대상 Cloud SQL 인스턴스의 설정 정의

1. Cloud SQL 인스턴스의 대상 인스턴스 ID를 입력합니다. 기본적으로 이전 작업 ID가 이 필드에 미리 입력됩니다. 이 이름을 유지하거나 다른 이름을 입력할 수 있습니다.

2. 대상 Cloud SQL 인스턴스의 영숫자 비밀번호를 입력합니다. 이는 인스턴스의 postgres 관리자 계정 비밀번호입니다.

   비밀번호를 직접 입력하거나 생성을 클릭하여 Database Migration Service에서 자동으로 비밀번호를 만들도록 할 수 있습니다.

   도움말: 비밀번호를 일반 텍스트로 보려면 표시 아이콘을 클릭합니다. 이 아이콘은 눈 모양입니다.

3. 지정된 데이터베이스 엔진에 지원되는 Cloud SQL 버전 목록에서 대상 인스턴스의 데이터베이스 버전을 선택합니다.

4. 새 Cloud SQL 인스턴스에 원하는 Google Cloud 영역을 선택하거나 'Any'로 둡니다.

5. 이 빠른 시작에서는 IP 허용 목록을 네트워킹 방법으로 사용하기 때문에 공개 IP 체크박스를 선택합니다. 이 방법은 Cloud SQL 인스턴스의 발신 IP 주소에서 들어오는 연결을 수락하도록 소스 데이터베이스 서버를 구성하는 방식으로 작동합니다.

   역방향 SSH 터널, VPC 피어링, VPN과 같은 다른 네트워킹 방법의 경우 비공개 IP 체크박스를 선택합니다.

6. Cloud SQL 인스턴스의 머신 유형을 선택합니다. 디스크 크기는 소스 데이터베이스 크기 이상이어야 합니다.

7. Cloud SQL 인스턴스의 스토리지 유형과 스토리지 용량을 정의합니다.

8. 만들기 및 계속을 클릭하여 새 인스턴스를 만듭니다.

9. 후속 대화상자에서 대상 만들기 및 계속을 클릭합니다. 인스턴스 생성을 완료하는 데 몇 분 정도 걸릴 수 있습니다.

   중요: 이 절차에서는 Cloud SQL 인스턴스를 만듭니다. 선택한 구성에 따라 요금이 청구됩니다.
   참고: 대상 인스턴스가 생성된 후에는 이전 작업의 일부 설정을 더 이상 수정할 수 없습니다. 데이터베이스 엔진이나 이전 유형은 변경할 수 없습니다.

연결 설정

1. 소스 데이터베이스와 대상 데이터베이스 간에 연결을 설정하는 데 사용할 네트워킹 방법을 선택합니다. 이 빠른 시작에서는 연결 방법 목록을 사용하여 IP 허용 목록을 네트워킹 방법으로 선택합니다.

   IP 허용 목록은 소스 및 대상 데이터베이스의 데이터에 대한 액세스를 신뢰할 수 있는 사용자로만 제한하고 제어하는 데 자주 사용되는 보안 기능입니다. IP 허용 목록을 사용하면 사용자가 이 데이터에 액세스할 수 있는 신뢰할 수 있는 IP 주소 또는 IP 범위의 목록을 만들 수 있습니다. 또한 IP 허용 목록을 사용하려면 대상 Cloud SQL 인스턴스에서 수신되는 연결에 대해 소스 데이터베이스나 방화벽을 열어야 합니다.

   IP 주소가 대상 발신 IP 주소 필드에 표시되는 데 몇 분 정도 걸릴 수 있습니다.

2. 소스 IP 주소가 이 필드에 자동으로 입력되지 않은 경우 콘솔에서 Cloud SQL 인스턴스의 발신 IP 주소를 복사하여 이 IP 주소의 연결을 수락하도록 소스 데이터베이스 서버의 네트워크 방화벽을 구성합니다.
   
   1. 이 IP 주소의 연결을 수락하도록 pg_hba.conf 파일 또는 Amazon RDS 보안 그룹을 업데이트합니다.
   2. 방화벽 규칙에서 대상 Cloud SQL 인스턴스의 연결 IP 주소에서 포트 5432에 연결할 수 있도록 인바운드 (또는 인그레스) 규칙을 만듭니다.
3. 구성 및 계속을 클릭하여 연결 프로필 구성을 완료합니다.

마이그레이션 데이터베이스 구성

마이그레이션할 데이터베이스를 선택할 수 있습니다.

1. 이전할 데이터베이스 목록에서 모든 데이터베이스를 선택합니다.

   소스에 있는 모든 데이터베이스가 마이그레이션을 위해 선택됩니다.

2. 저장 후 계속을 클릭합니다.

마이그레이션 작업 테스트 및 만들기

1. 마이그레이션 작업에 선택한 설정을 검토합니다.

2. 테스트 작업을 클릭하여 소스가 올바르게 구성되었고 소스 및 대상 인스턴스가 서로 통신할 수 있으며 마이그레이션 작업이 유효한지 확인합니다.

3. '테스트 통과' 상태가 표시되는지 확인합니다.

   테스트에 실패하면 흐름의 적절한 부분에서 문제를 해결한 후 다시 테스트할 수 있습니다.

4. 작업 만들기 및 시작을 클릭하여 마이그레이션 작업을 만들고 즉시 시작합니다.

5. 후속 대화상자에서 시작을 클릭합니다.

6. 마이그레이션 작업 페이지에서 마이그레이션 작업의 상태가 '시작 중'인지 확인합니다. 몇 분 후 상태가 '실행 중'으로 변경되는지 확인합니다.

마이그레이션 작업 확인

이 섹션에서는 Database Migration Service가 마이그레이션 작업을 사용하여 소스 데이터베이스 인스턴스에서 대상 Cloud SQL 데이터베이스 인스턴스로 데이터를 마이그레이션했는지 확인합니다.

1. Google Cloud 콘솔에서 SQL 인스턴스 페이지로 이동합니다.
2. 마이그레이션 작업의 읽기 복제 항목을 클릭합니다.
3. 페이지 오른쪽 상단에 표시되는 Cloud Shell 활성화 아이콘을 클릭합니다.
4. Google Cloud Shell 프롬프트에서 Enter 키를 누릅니다.
5. 선택사항: Cloud Shell 승인 대화상자가 표시되면 승인을 클릭합니다.
6. 대상 Cloud SQL 데이터베이스 인스턴스에 연결합니다.
7. 비밀번호 입력 프롬프트에서 대상 Cloud SQL 인스턴스 설정 정의에서 제공했거나 Database Migration Service에서 생성한 비밀번호를 입력합니다.

8. postgres 프롬프트에서 \list를 입력하여 데이터베이스를 나열하고 소스 데이터베이스 인스턴스가 표시되는지 확인합니다.
9. 이 데이터베이스 인스턴스와 연결된 테이블을 보려면 postgres 프롬프트에서 \connect SOURCE_DB_NAME를 입력합니다. 프롬프트 이름이 postgres에서 SOURCE_DB_NAME으로 변경됩니다.
10. SOURCE_DB_NAME 프롬프트에서 \dt를 입력하여 이 인스턴스의 테이블을 확인합니다.
11. SOURCE_DB_NAME 프롬프트에서 이 사용자에게 인스턴스의 테이블에 있는 데이터에 액세스할 수 있는 권한을 부여하려면 GRANT cloudsqlexternalsync to USER;를 입력합니다.

    USER를 대상 데이터베이스 인스턴스에 연결하는 데 사용한 사용자 이름으로 바꿉니다.

12. SOURCE_DB_NAME 프롬프트에서 SELECT * from TABLE_NAME;을 입력하여 소스 데이터베이스 인스턴스의 테이블에서 복제된 정보를 확인합니다.
13. 테이블에 올바른 정보가 표시되는지 확인합니다.

그러면 Database Migration Service에서 데이터를 이전했음을 확인할 수 있습니다.

마이그레이션 작업 승격

이제 마이그레이션 작업을 승격할 수 있습니다. 따라서 대상 Cloud SQL 데이터베이스 인스턴스가 소스 데이터베이스 인스턴스를 기본 데이터베이스로 대체합니다.

1. 마이그레이션 작업 페이지로 돌아갑니다.

2. 승격할 마이그레이션 작업을 클릭합니다. 마이그레이션 작업 세부정보 페이지가 표시됩니다.

3. 복제 지연이 0에 가까워질 때까지 기다립니다.

4. 소스 데이터베이스에 대한 모든 쓰기를 중지합니다.

   마이그레이션 작업을 승격하면 대상 Cloud SQL 데이터베이스가 기본 데이터베이스가 되므로 소스 데이터베이스에 대한 모든 쓰기를 중지해야 합니다.

5. 복제 지연 시간이 0이 될 때까지 기다립니다.

6. 승격할 마이그레이션 작업을 클릭합니다. 이 작업의 상태는 '실행 중'이어야 합니다.

7. 승격을 클릭하여 마이그레이션 작업을 승격합니다.

8. 후속 대화상자에서 승격을 다시 클릭합니다.

9. 마이그레이션 작업의 상태가 '승격 진행 중'인지 확인합니다. 몇 분 후에 상태가 '완료됨'으로 변경되는지 확인합니다.

새 Cloud SQL 데이터베이스 인스턴스를 사용할 준비가 되었습니다.

삭제

이 페이지에서 사용한 리소스 비용이 Google Cloud 계정에 청구되지 않도록 하려면 다음 단계를 수행합니다.

1. 마이그레이션 작업, 연결 프로필, Cloud SQL 인스턴스, 프로젝트가 필요하지 않은 경우 Google Cloud 콘솔을 사용하여 삭제합니다.

다음 단계

• 연결 프로필을 관리하는 방법을 자세히 알아보세요.
• 이전 작업 상태에 대해 자세히 알아보세요.
• 이전 작업 측정항목에 대해 자세히 알아보세요.