기존 대상 인스턴스로의 마이그레이션 작업 만들기

MySQL   |  PostgreSQL   |  PostgreSQL to AlloyDB

개요

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

기존 대상 인스턴스의 마이그레이션 작업을 만들면 다음이 포함됩니다.

• 마이그레이션 작업의 설정 정의
• 소스 데이터베이스 연결 프로필 선택
• 기존 대상 데이터베이스 인스턴스 선택
• 기존 인스턴스의 순위를 내리고 읽기 복제본으로 변환
• 소스 및 대상 데이터베이스 인스턴스 간의 연결 설정
• 마이그레이션 작업을 테스트하여 작업에 대해 제공한 연결 정보가 유효한지 확인합니다.

Database Migration Service 외부에서 만든 대상 인스턴스로 마이그레이션하려면 고려해야 할 몇 가지 제한사항이 있습니다. 예를 들어 Cloud SQL 대상 인스턴스는 비어 있거나 시스템 구성 데이터만 포함해야 합니다. 자세한 내용은 알려진 제한사항을 참고하세요.

Database Migration Service 마법사를 사용하면 마이그레이션 작업을 만들 수 있습니다. 이 마법사는 시작하기, 소스 정의, 대상 만들기, 연결 방법 정의, 이전 데이터베이스 구성, 이전 작업 테스트 및 만들기의 6개 창으로 구성됩니다. 각 창을 채우는 방법에 관한 정보는 이 페이지의 다음 섹션을 참고하세요.

Google Cloud 콘솔을 사용하여 이전 작업 만들기

저장 및 종료를 클릭하여 이전 작업 만들기를 일시중지할 수 있습니다. 그때까지 채워진 모든 데이터는 초안 마이그레이션 작업에 저장되며 초안 탭에서 이 작업에 액세스할 수 있습니다.

마이그레이션 작업 만들기를 완료하려면 탭으로 이동한 다음 작업을 클릭합니다. 만들기 흐름이 중단된 지점부터 다시 시작됩니다. 만들기 또는 만들기 및 시작을 클릭할 때까지 작업은 초안으로 유지됩니다.

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

1. Google Cloud 콘솔에서 이전 작업으로 이동합니다.

2. 페이지 상단에서 마이그레이션 작업 만들기를 클릭합니다.

3. 마이그레이션 작업의 이름을 입력합니다. 이전 작업을 식별하는 데 도움이 되는 친근한 이름을 선택합니다. 작업 이름에 민감한 정보나 개인 식별 정보를 포함하지 마세요.

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

5. 소스 데이터베이스 엔진을 선택합니다.

6. 대상 데이터베이스 엔진을 선택합니다.

7. 이전할 대상 리전을 선택합니다. 이 리전은 대상 데이터베이스가 있는 리전과 동일해야 합니다. 대상 지역을 선택한 후에는 이 선택사항을 변경할 수 없습니다.

   중요: PostgreSQL용 Cloud SQL Enterprise Plus 버전을 사용하려면 해당 버전이 지원되는 지역에 있는지 확인하세요. PostgreSQL용 Cloud SQL Enterprise Plus 버전 리전 지원을 참고하세요.

8. 마이그레이션 작업 유형(일회성(스냅샷만 해당) 또는 연속(스냅샷 + 진행 중인 변경사항))을 지정합니다.

9. 계속하기 전에 기본 요건 검토 섹션에서 열기를 클릭하여 이전을 위해 소스 데이터베이스를 준비하는 데 도움이 되는 자동 생성된 안내를 확인합니다. 이 단계에서 이러한 기본 요건을 완료하는 것이 가장 좋지만, 마이그레이션 작업을 테스트하거나 시작하기 전 언제라도 이를 완료할 수 있습니다. 자세한 내용은 소스 구성을 참고하세요.

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

소스 연결 프로필 정보 지정

1. 연결 프로필을 만들었다면 기존 연결 프로필 목록에서 선택합니다.

   연결 프로필을 만들지 않았다면 드롭다운 목록 하단에서 연결 프로필 만들기를 클릭하여 프로필을 하나 만들고 소스 연결 프로필 만들기와 동일한 단계를 수행합니다.

2. 데이터 덤프 구성 맞춤설정 섹션에서 데이터 덤프 구성 표시를 클릭합니다.

   데이터 덤프 병렬 처리 속도는 소스 데이터베이스의 부하량과 관련이 있습니다. 다음 설정을 사용할 수 있습니다.

   • 최적 (권장): 소스 데이터베이스의 최적 부하로 균형 잡힌 성능을 제공합니다.
   • 최대: 가장 빠른 덤프 속도를 제공하지만 소스 데이터베이스의 부하가 증가할 수 있습니다.
   • 최소: 소스 데이터베이스에서 가장 적은 양의 컴퓨팅 리소스를 사용하지만 덤프 처리량이 느릴 수 있습니다.

   조정된 데이터 덤프 동시 로드 설정을 사용하려면 소스 데이터베이스에서 max_replication_slots, max_wal_senders, max_worker_processes 매개변수를 늘려야 합니다. 마이그레이션 작업 생성 완료 시 마이그레이션 작업 테스트를 실행하여 구성을 확인할 수 있습니다.

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

대상 인스턴스 선택

Cloud SQL 소스: 비공개 IP 연결을 사용하는 Cloud SQL 인스턴스에서 RFC 1918 이외의 주소 IP 범위를 사용하는 Cloud SQL 인스턴스로 이전하는 경우 소스 Cloud SQL 인스턴스의 네트워크 구성에 RFC 1918 이외의 범위를 추가합니다. Cloud SQL 문서의 인증 네트워크 구성을 참고하세요.

1. 대상 인스턴스 유형 메뉴에서 기존 인스턴스를 선택합니다.
2. 대상 인스턴스 선택 섹션에서 대상 인스턴스를 선택합니다.
3. 인스턴스 세부정보 섹션의 정보를 검토하고 선택 및 계속을 클릭합니다.
4. 기존 대상 데이터베이스로 마이그레이션하기 위해 Database Migration Service는 대상 인스턴스의 순위를 내리고 복제본으로 변환합니다. 감속을 안전하게 실행할 수 있음을 나타내려면 확인 창에 대상 인스턴스 식별자를 입력합니다.
5. 확인하고 계속하기를 클릭합니다.

소스 및 대상 데이터베이스 인스턴스 간의 연결 설정

이전의 이질적 마이그레이션 (예: Oracle에서 Cloud SQL로, Cloud SQL에서 PostgreSQL로)에 사용된 소스 연결 프로필을 재사용하는 경우 이 단계에서 연결 방법을 선택해야 합니다. 이 메서드는 한 PostgreSQL용 Cloud SQL 데이터베이스 인스턴스에서 다른 인스턴스로의 동종 마이그레이션에 사용됩니다. 이종 연결 방법은 이 마이그레이션 작업과 관련이 없으므로 연결 방법을 선택해야 합니다.

1. 연결 방법 메뉴에서 네트워크 연결 방법을 선택합니다. 이 메서드는 새로 생성된 Cloud SQL 인스턴스가 소스 데이터베이스에 연결되는 방식을 정의합니다. 현재 네트워크 연결 방법에는 IP 허용 목록, 역방향 SSH 터널, VPC 피어링이 있습니다.

   • IP 허용 목록 네트워크 연결 방법을 선택하는 경우 대상 인스턴스의 발신 IP 주소를 지정해야 합니다. 만든 Cloud SQL 인스턴스가 고가용성 인스턴스인 경우 기본 인스턴스와 보조 인스턴스의 발신 IP 주소를 모두 포함합니다.

   • 역방향 SSH 터널 네트워크 연결 방법을 선택한 경우 터널을 호스팅할 Compute Engine VM 인스턴스를 선택합니다.

     인스턴스를 지정하면 소스 데이터베이스와 대상 데이터베이스 간의 터널을 설정하는 단계를 실행하는 스크립트가 제공됩니다. Google Cloud CLI에서 스크립트를 실행해야 합니다.

     소스 데이터베이스와 Google Cloud에 모두 연결된 머신에서 명령어를 실행합니다.

   • VPC 피어링 네트워크 연결 방법을 선택하는 경우 소스 데이터베이스가 있는 VPC 네트워크를 선택합니다. Cloud SQL 인스턴스가 이 네트워크에 연결되도록 업데이트됩니다.
   • 연결을 구성하는 방법을 자세히 알아보세요.

2. 네트워크 연결 방법을 선택하고 방법에 관한 추가 정보를 제공한 후 구성하고 계속하기를 클릭합니다.

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

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

1. 이전할 데이터베이스 목록에서 다음 옵션 중 하나를 선택합니다.
   • 모든 데이터베이스: 소스에 있는 모든 데이터베이스를 선택합니다.
   • 특정 데이터베이스: 소스에 있는 모든 데이터베이스 중에서 특정 데이터베이스를 선택할 수 있습니다.

2. 특정 데이터베이스를 마이그레이션하려면 표시되는 목록을 필터링하고 Database Migration Service가 대상에 마이그레이션할 데이터베이스를 선택하면 됩니다.

   목록이 표시되지 않고 데이터베이스 검색 오류가 표시되면 새로고침을 클릭합니다. 데이터베이스 검색에 실패하면 작업에서 모든 데이터베이스를 마이그레이션합니다. 마이그레이션 작업을 계속 만들고 나중에 연결 오류를 수정할 수 있습니다.

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

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

이 마지막 단계에서는 마이그레이션 작업 설정, 소스, 대상, 연결 방법의 요약을 검토한 다음 마이그레이션 작업 설정의 유효성을 테스트합니다. 문제가 발생하면 이전 작업의 설정을 수정할 수 있습니다. 일부 설정은 수정할 수 없습니다.

1. TEST JOB을 클릭하여 다음을 확인합니다.

   • 기본 요건에 따라 소스 데이터베이스가 올바르게 구성되었습니다.
   • 소스 인스턴스와 대상 인스턴스는 서로 통신할 수 있습니다.
   • 대상에서 필요한 비공개 또는 공개 IP 주소 업데이트가 완료됩니다.
   • 마이그레이션 작업이 유효하고 소스 및 대상 버전이 호환됩니다.

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

   테스트 실패의 원인과 테스트 실패와 관련된 문제를 해결하는 방법에 관한 자세한 내용은 PostgreSQL 문제 진단을 참고하세요.

   테스트에 실패하더라도 마이그레이션 작업을 만들 수 있지만 작업이 시작된 후 실행 중 특정 시점에 실패할 수 있습니다.

2. 작업 만들기 및 시작을 클릭하여 마이그레이션 작업을 만들고 즉시 시작하거나 작업 만들기를 클릭하여 마이그레이션 작업을 만들고 즉시 시작하지 않습니다.

   주의: Terraform을 사용하여 대상 데이터베이스를 프로비저닝한 경우 마이그레이션 작업 실행 중에 구성이 변경될 수 있습니다. 이전이 완료되기 전에 Terraform 설정을 다시 적용하지 마세요. 자세한 내용은 Terraform 구성 드리프트를 참고하세요.

   작업이 생성 시점에 시작되지 않은 경우 시작을 클릭하여 마이그레이션 작업 페이지에서 시작할 수 있습니다.

   마이그레이션 작업이 시작된 시점에 관계없이 조직은 대상 인스턴스의 존재에 대해 요금이 청구됩니다.

   마이그레이션 작업을 시작하면 Database Migration Service가 전체 덤프를 시작하여 소스 데이터베이스를 잠급니다. 소스가 Amazon RDS 또는 Amazon Aurora에 있는 경우 데이터베이스 마이그레이션 서비스는 마이그레이션 시작 시 추가로 짧은 (약 1분 미만) 쓰기 다운타임이 필요합니다. 자세한 내용은 데이터 덤프 동시 처리 고려사항을 참고하세요.

3. 마이그레이션 작업이 마이그레이션 작업 목록에 추가되며 직접 볼 수 있습니다.

4. 마이그레이션 작업 검토로 진행합니다.

Google Cloud CLI를 사용하여 이전 작업 만들기

Google Cloud CLI를 사용하여 기존 인스턴스로 이전하는 경우 대상 인스턴스의 연결 프로필을 수동으로 만들어야 합니다. Google Cloud 콘솔을 사용하는 경우에는 필요하지 않습니다. Database Migration Service에서 대상 연결 프로필을 만들고 삭제해 주기 때문입니다.

시작하기 전에

gcloud CLI를 사용하여 기존 대상 데이터베이스 인스턴스로의 마이그레이션 작업을 만들기 전에 다음을 실행해야 합니다.

• 대상 데이터베이스 인스턴스를 만듭니다.
• 소스 데이터베이스 인스턴스를 준비합니다. 다음을 참조하세요.
  • 소스 구성
  • 소스 연결 프로필 만들기 (마이그레이션 작업을 만들려면 소스 연결 프로필 식별자가 필요합니다.)
  • 연결 구성

대상 연결 프로필 만들기

gcloud database-migration connection-profiles create 명령어를 실행하여 기존 대상 인스턴스의 대상 연결 프로필을 만듭니다.

이 샘플에서는 모든 작업이 동기식으로 실행되도록 선택적 --no-async 플래그를 사용합니다. 따라서 일부 명령어는 완료하는 데 다소 시간이 걸릴 수 있습니다. --no-async 플래그를 건너뛰어 명령어를 비동기식으로 실행할 수 있습니다. 이 경우 gcloud database-migration operations describe 명령어를 사용하여 작업이 성공했는지 확인해야 합니다.

아래의 명령어 데이터를 사용하기 전에 다음을 바꿉니다.

• CONNECTION_PROFILE_ID: 연결 프로필의 기계가 읽을 수 있는 식별자
• REGION을 연결 프로필을 저장하려는 리전의 식별자로 바꿉니다.
• DESTINATION_INSTANCE_ID를 대상 인스턴스의 인스턴스 식별자로 바꿉니다.
• (선택사항) CONNECTION_PROFILE_NAME: 연결 프로필의 사람이 읽을 수 있는 이름입니다. 이 값은 Google Cloud 콘솔에 표시됩니다.

다음 명령어를 실행합니다.

Linux, macOS 또는 Cloud Shell

참고: gcloud init 또는 gcloud auth login 및 gcloud config set project를 실행하여 Google Cloud CLI를 인증 및 프로젝트와 함께 초기화했는지 확인합니다.

gcloud database-migration connection-profiles \
create postgresql CONNECTION_PROFILE_ID \
  --no-async \
  --cloudsql-instance=DESTINATION_INSTANCE_ID \
  --region=REGION \
  --display-name=CONNECTION_PROFILE_NAME

Windows(PowerShell)

참고: gcloud init 또는 gcloud auth login 및 gcloud config set project를 실행하여 Google Cloud CLI를 인증 및 프로젝트와 함께 초기화했는지 확인합니다.

gcloud database-migration connection-profiles `
create postgresql CONNECTION_PROFILE_ID `
  --no-async `
  --cloudsql-instance=DESTINATION_INSTANCE_ID `
  --region=REGION `
  --display-name=CONNECTION_PROFILE_NAME

Windows(cmd.exe)

참고: gcloud init 또는 gcloud auth login 및 gcloud config set project를 실행하여 Google Cloud CLI를 인증 및 프로젝트와 함께 초기화했는지 확인합니다.

gcloud database-migration connection-profiles ^
create postgresql CONNECTION_PROFILE_ID ^
  --no-async ^
  --cloudsql-instance=DESTINATION_INSTANCE_ID ^
  --region=REGION ^
  --display-name=CONNECTION_PROFILE_NAME

다음과 비슷한 응답이 표시됩니다.

Waiting for connection profile [CONNECTION_PROFILE_ID]
to be created with [OPERATION_ID]

Waiting for operation [OPERATION_ID] to complete...done.

Created connection profile CONNECTION_PROFILE_ID [OPERATION_ID]

마이그레이션 작업 만들기

참고: 다음 예는 소스 데이터베이스와 대상 데이터베이스 간에 비공개 IP 연결을 사용하는 이전 시나리오를 나타냅니다. 다른 연결 유형 (예: VPC 피어링 또는 역방향 SSH 터널)을 사용하는 경우 --peer-vpc 또는 --vm, --vm-ip, --vm-port, --vpc와 같은 필수 플래그를 추가해야 합니다. 자세한 내용은 연결 구성 및 Google Cloud CLI 예시를 참고하세요.

참고: PostgreSQL용 Database Migration Service로의 마이그레이션에는 연속 마이그레이션 유형만 지원됩니다.

이 샘플에서는 모든 작업이 동기식으로 실행되도록 선택적 --no-async 플래그를 사용합니다. 따라서 일부 명령어는 완료하는 데 다소 시간이 걸릴 수 있습니다. --no-async 플래그를 건너뛰어 명령어를 비동기식으로 실행할 수 있습니다. 이 경우 gcloud database-migration operations describe 명령어를 사용하여 작업이 성공했는지 확인해야 합니다.

아래의 명령어 데이터를 사용하기 전에 다음을 바꿉니다.

• MIGRATION_JOB_ID을 마이그레이션 작업의 머신 판독 식별자로 바꿉니다. 이 값은 Database Migration Service Google Cloud CLI 명령어 또는 API를 사용하여 마이그레이션 작업을 처리하는 데 사용됩니다.
• REGION를 이전 작업을 저장할 리전 식별자로 바꿉니다.
• MIGRATION_JOB_NAME을 인간이 읽을 수 있는 이전 작업 이름으로 바꿉니다. 이 값은 Google Cloud 콘솔의 Database Migration Service에 표시됩니다.
• SOURCE_CONNECTION_PROFILE_ID를 소스 연결 프로필의 기계 판독식 식별자로 바꿉니다.
• DESTINATION_CONNECTION_PROFILE_ID을 대상 연결 프로필의 기계 판독식 식별자로 바꿉니다.

• 선택사항: Database Migration Service는 기본적으로 소스의 모든 데이터베이스를 마이그레이션합니다. 특정 데이터베이스만 이전하려면 --databases-filter 플래그를 사용하고 식별자를 쉼표로 구분된 목록으로 지정합니다.

  예: --databases-filter=my-business-database,my-other-database

  나중에 gcloud database-migration migration-jobs update 명령어를 사용하여 --database-filter flag로 만든 이전 작업을 수정할 수 있습니다.

다음 명령어를 실행합니다.

Linux, macOS 또는 Cloud Shell

참고: gcloud init 또는 gcloud auth login 및 gcloud config set project를 실행하여 Google Cloud CLI를 인증 및 프로젝트와 함께 초기화했는지 확인합니다.

gcloud database-migration migration-jobs \
create MIGRATION_JOB_ID \
  --no-async \
  --region=REGION \
  --display-name=MIGRATION_JOB_NAME \
  --source=SOURCE_CONNECTION_PROFILE_ID \
  --destination=DESTINATION_CONNECTION_PROFILE_ID \
  --type=CONTINUOUS \

Windows(PowerShell)

참고: gcloud init 또는 gcloud auth login 및 gcloud config set project를 실행하여 Google Cloud CLI를 인증 및 프로젝트와 함께 초기화했는지 확인합니다.

gcloud database-migration migration-jobs `
create MIGRATION_JOB_ID `
  --no-async `
  --region=REGION `
  --display-name=MIGRATION_JOB_NAME `
  --source=SOURCE_CONNECTION_PROFILE_ID `
  --destination=DESTINATION_CONNECTION_PROFILE_ID `
  --type=CONTINUOUS `

Windows(cmd.exe)

참고: gcloud init 또는 gcloud auth login 및 gcloud config set project를 실행하여 Google Cloud CLI를 인증 및 프로젝트와 함께 초기화했는지 확인합니다.

gcloud database-migration migration-jobs ^
create MIGRATION_JOB_ID ^
  --no-async ^
  --region=REGION ^
  --display-name=MIGRATION_JOB_NAME ^
  --source=SOURCE_CONNECTION_PROFILE_ID ^
  --destination=DESTINATION_CONNECTION_PROFILE_ID ^
  --type=CONTINUOUS ^

다음과 비슷한 응답이 표시됩니다.

Waiting for migration job [MIGRATION_JOB_ID]
to be created with [OPERATION_ID]

Waiting for operation [OPERATION_ID] to complete...done.

Created migration job MIGRATION_JOB_ID [OPERATION_ID]

대상 데이터베이스 순위 내리기

Database Migration Service를 사용하려면 대상 데이터베이스 인스턴스가 마이그레이션하는 동안 읽기 복제본으로 작동해야 합니다. 이전 작업을 시작하기 전에 gcloud database-migration migration-jobs demote-destination 명령어를 실행하여 대상 데이터베이스 인스턴스의 계층을 낮춥니다.

아래의 명령어 데이터를 사용하기 전에 다음을 바꿉니다.

• MIGRATION_JOB_ID를 이전 작업 식별자로 바꿉니다.

  식별자를 모르는 경우 gcloud database-migration migration-jobs list 명령어를 사용하여 지정된 리전의 모든 이전 작업을 나열하고 식별자를 확인할 수 있습니다.

• REGION을 연결 프로필이 저장된 리전의 식별자로 바꿉니다.

다음 명령어를 실행합니다.

Linux, macOS 또는 Cloud Shell

참고: gcloud init 또는 gcloud auth login 및 gcloud config set project를 실행하여 Google Cloud CLI를 인증 및 프로젝트와 함께 초기화했는지 확인합니다.

gcloud database-migration migration-jobs \
demote-destination MIGRATION_JOB_ID \
  --region=REGION

Windows(PowerShell)

참고: gcloud init 또는 gcloud auth login 및 gcloud config set project를 실행하여 Google Cloud CLI를 인증 및 프로젝트와 함께 초기화했는지 확인합니다.

gcloud database-migration migration-jobs `
demote-destination MIGRATION_JOB_ID `
  --region=REGION

Windows(cmd.exe)

참고: gcloud init 또는 gcloud auth login 및 gcloud config set project를 실행하여 Google Cloud CLI를 인증 및 프로젝트와 함께 초기화했는지 확인합니다.

gcloud database-migration migration-jobs ^
demote-destination MIGRATION_JOB_ID ^
  --region=REGION

결과

작업은 비동기식으로 실행됩니다. 따라서 이 명령어는 장기 실행 작업을 나타내는 작업 항목을 반환합니다.

done: false
metadata:
  '@type': type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata
  apiVersion: v1
  createTime: '2024-02-20T12:20:24.493106418Z'
  requestedCancellation: false
  target: MIGRATION_JOB_ID
  verb: demote-destination
name: OPERATION_ID

작업이 성공했는지 확인하려면 반환된 작업 객체를 쿼리하거나 이전 작업의 상태를 확인하면 됩니다.

• gcloud database-migration migration-jobs describe 명령어를 사용하여 이전 작업의 상태를 확인합니다.
• OPERATION_ID와 함께 gcloud database-migration operations describe를 사용하여 작업 자체의 상태를 확인합니다.

마이그레이션 작업 관리

이 시점에서 마이그레이션 작업이 구성되고 대상 데이터베이스 인스턴스에 연결됩니다. 다음 작업을 사용하여 관리할 수 있습니다.

1. 선택사항: 이전 작업을 확인합니다.
   먼저 gcloud database-migration migration-jobs verify 명령어를 실행하여 이전 작업을 확인하는 것이 좋습니다.

   자세한 내용은 다음 섹션을 펼치세요.

   gcloud database-migration migration-jobs verify

   아래의 명령어 데이터를 사용하기 전에 다음을 바꿉니다.

   • MIGRATION_JOB_ID를 이전 작업 식별자로 바꿉니다.

     식별자를 모르는 경우 gcloud database-migration migration-jobs list 명령어를 사용하여 지정된 리전의 모든 이전 작업을 나열하고 식별자를 확인할 수 있습니다.

   • REGION을 연결 프로필이 저장된 리전의 식별자로 바꿉니다.

   다음 명령어를 실행합니다.

   Linux, macOS 또는 Cloud Shell

   참고: gcloud init 또는 gcloud auth login 및 gcloud config set project를 실행하여 Google Cloud CLI를 인증 및 프로젝트와 함께 초기화했는지 확인합니다.

   gcloud database-migration migration-jobs \
   verify MIGRATION_JOB_ID \
     --region=REGION

   Windows(PowerShell)

   참고: gcloud init 또는 gcloud auth login 및 gcloud config set project를 실행하여 Google Cloud CLI를 인증 및 프로젝트와 함께 초기화했는지 확인합니다.

   gcloud database-migration migration-jobs `
   verify MIGRATION_JOB_ID `
     --region=REGION

   Windows(cmd.exe)

   참고: gcloud init 또는 gcloud auth login 및 gcloud config set project를 실행하여 Google Cloud CLI를 인증 및 프로젝트와 함께 초기화했는지 확인합니다.

   gcloud database-migration migration-jobs ^
   verify MIGRATION_JOB_ID ^
     --region=REGION

   결과

   작업은 비동기식으로 실행됩니다. 따라서 이 명령어는 장기 실행 작업을 나타내는 작업 항목을 반환합니다.

   done: false
   metadata:
     '@type': type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata
     apiVersion: v1
     createTime: '2024-02-20T12:20:24.493106418Z'
     requestedCancellation: false
     target: MIGRATION_JOB_ID
     verb: verify
   name: OPERATION_ID
   

   작업이 성공했는지 확인하려면 반환된 작업 객체를 쿼리하거나 이전 작업의 상태를 확인하면 됩니다.

   • gcloud database-migration migration-jobs describe 명령어와 MIGRATION_JOB_ID를 사용하여 이전 작업의 상태를 확인합니다.
   • OPERATION_ID와 함께 gcloud database-migration operations describe 명령어를 사용하여 작업 자체의 상태를 확인합니다.

2. 선택사항: 이전하도록 선택된 데이터베이스에 관한 정보를 검색합니다.
   특정 데이터베이스를 마이그레이션할 때 Database Migration Service는 --database-filter 플래그를 사용하여 마이그레이션 작업에 선택한 데이터베이스에 관한 세부정보를 가져와야 합니다.

   이전 작업을 시작하기 전에 gcloud database-migration migration-jobs fetch-source-objects 명령어를 실행합니다.

   자세한 내용은 다음 섹션을 펼치세요.

   gcloud database-migration migration-jobs fetch-source-objects

   아래의 명령어 데이터를 사용하기 전에 다음을 바꿉니다.

   • MIGRATION_JOB_ID를 이전 작업 식별자로 바꿉니다.

     식별자를 모르는 경우 gcloud database-migration migration-jobs list 명령어를 사용하여 지정된 리전의 모든 이전 작업을 나열하고 식별자를 확인할 수 있습니다.

   • REGION을 연결 프로필이 저장된 리전의 식별자로 바꿉니다.

   다음 명령어를 실행합니다.

   Linux, macOS 또는 Cloud Shell

   참고: gcloud init 또는 gcloud auth login 및 gcloud config set project를 실행하여 Google Cloud CLI를 인증 및 프로젝트와 함께 초기화했는지 확인합니다.

   gcloud database-migration migration-jobs \
   fetch-source-objects MIGRATION_JOB_ID \
     --region=REGION

   Windows(PowerShell)

   참고: gcloud init 또는 gcloud auth login 및 gcloud config set project를 실행하여 Google Cloud CLI를 인증 및 프로젝트와 함께 초기화했는지 확인합니다.

   gcloud database-migration migration-jobs `
   fetch-source-objects MIGRATION_JOB_ID `
     --region=REGION

   Windows(cmd.exe)

   참고: gcloud init 또는 gcloud auth login 및 gcloud config set project를 실행하여 Google Cloud CLI를 인증 및 프로젝트와 함께 초기화했는지 확인합니다.

   gcloud database-migration migration-jobs ^
   fetch-source-objects MIGRATION_JOB_ID ^
     --region=REGION

   결과

   출력은 다음과 비슷합니다.

   Waiting for migration job MIGRATION_JOB_ID
   to fetch source objects with OPERATION_ID
   
   Waiting for operation OPERATION_ID to complete...done.
   
   SOURCE_OBJECT                                      STATE         PHASE              ERROR
   {'database': 'DATABASE_NAME', 'type': 'DATABASE'}  NOT_SELECTED  PHASE_UNSPECIFIED
   {'database': 'DATABASE_NAME', 'type': 'DATABASE'}  STOPPED       CDC                {'code': 1, 'message': 'Internal error'}
   

   작업이 성공했는지 확인하려면 반환된 작업 객체를 쿼리하거나 이전 작업의 상태를 확인하면 됩니다.

   • gcloud database-migration migration-jobs describe 명령어와 MIGRATION_JOB_ID를 사용하여 이전 작업의 상태를 확인합니다.
   • OPERATION_ID와 함께 gcloud database-migration operations describe 명령어를 사용하여 작업 자체의 상태를 확인합니다.

3. 마이그레이션 작업을 시작합니다.
   gcloud database-migration migration-jobs start 명령어를 실행하여 마이그레이션 작업을 시작합니다.

   자세한 내용은 다음 섹션을 펼치세요.

   gcloud database-migration migration-jobs start

   아래의 명령어 데이터를 사용하기 전에 다음을 바꿉니다.

   • MIGRATION_JOB_ID를 이전 작업 식별자로 바꿉니다.

     식별자를 모르는 경우 gcloud database-migration migration-jobs list 명령어를 사용하여 지정된 리전의 모든 이전 작업을 나열하고 식별자를 확인할 수 있습니다.

   • REGION을 연결 프로필이 저장된 리전의 식별자로 바꿉니다.

   다음 명령어를 실행합니다.

   Linux, macOS 또는 Cloud Shell

   참고: gcloud init 또는 gcloud auth login 및 gcloud config set project를 실행하여 Google Cloud CLI를 인증 및 프로젝트와 함께 초기화했는지 확인합니다.

   gcloud database-migration migration-jobs \
   start MIGRATION_JOB_ID \
     --region=REGION

   Windows(PowerShell)

   참고: gcloud init 또는 gcloud auth login 및 gcloud config set project를 실행하여 Google Cloud CLI를 인증 및 프로젝트와 함께 초기화했는지 확인합니다.

   gcloud database-migration migration-jobs `
   start MIGRATION_JOB_ID `
     --region=REGION

   Windows(cmd.exe)

   참고: gcloud init 또는 gcloud auth login 및 gcloud config set project를 실행하여 Google Cloud CLI를 인증 및 프로젝트와 함께 초기화했는지 확인합니다.

   gcloud database-migration migration-jobs ^
   start MIGRATION_JOB_ID ^
     --region=REGION

   결과

   작업은 비동기식으로 실행됩니다. 따라서 이 명령어는 장기 실행 작업을 나타내는 작업 항목을 반환합니다.

   done: false
   metadata:
     '@type': type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata
     apiVersion: v1
     createTime: '2024-02-20T12:20:24.493106418Z'
     requestedCancellation: false
     target: MIGRATION_JOB_ID
     verb: start
   name: OPERATION_ID
   

   작업이 성공했는지 확인하려면 반환된 작업 객체를 쿼리하거나 이전 작업의 상태를 확인하면 됩니다.

   • gcloud database-migration migration-jobs describe 명령어와 MIGRATION_JOB_ID를 사용하여 이전 작업의 상태를 확인합니다.
   • OPERATION_ID와 함께 gcloud database-migration operations describe 명령어를 사용하여 작업 자체의 상태를 확인합니다.

마이그레이션 작업 승격

마이그레이션이 변경 데이터 캡처 (CDC) 단계에 도달하면 대상 데이터베이스 인스턴스를 읽기 복제본에서 독립형 인스턴스로 승격할 수 있습니다. gcloud database-migration migration-jobs promote 명령어를 실행합니다.

아래의 명령어 데이터를 사용하기 전에 다음을 바꿉니다.

• MIGRATION_JOB_ID를 이전 작업 식별자로 바꿉니다.

  식별자를 모르는 경우 gcloud database-migration migration-jobs list 명령어를 사용하여 지정된 리전의 모든 이전 작업을 나열하고 식별자를 확인할 수 있습니다.

• REGION을 연결 프로필이 저장된 리전의 식별자로 바꿉니다.

다음 명령어를 실행합니다.

Linux, macOS 또는 Cloud Shell

참고: gcloud init 또는 gcloud auth login 및 gcloud config set project를 실행하여 Google Cloud CLI를 인증 및 프로젝트와 함께 초기화했는지 확인합니다.

gcloud database-migration migration-jobs \
promote MIGRATION_JOB_ID \
  --region=REGION

Windows(PowerShell)

참고: gcloud init 또는 gcloud auth login 및 gcloud config set project를 실행하여 Google Cloud CLI를 인증 및 프로젝트와 함께 초기화했는지 확인합니다.

gcloud database-migration migration-jobs `
promote MIGRATION_JOB_ID `
  --region=REGION

Windows(cmd.exe)

참고: gcloud init 또는 gcloud auth login 및 gcloud config set project를 실행하여 Google Cloud CLI를 인증 및 프로젝트와 함께 초기화했는지 확인합니다.

gcloud database-migration migration-jobs ^
promote MIGRATION_JOB_ID ^
  --region=REGION

결과

작업은 비동기식으로 실행됩니다. 따라서 이 명령어는 장기 실행 작업을 나타내는 작업 항목을 반환합니다.

done: false
metadata:
  '@type': type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata
  apiVersion: v1
  createTime: '2024-02-20T12:20:24.493106418Z'
  requestedCancellation: false
  target: MIGRATION_JOB_ID
  verb: start
name: OPERATION_ID

작업이 성공했는지 확인하려면 반환된 작업 객체를 쿼리하거나 이전 작업의 상태를 확인하면 됩니다.

• gcloud database-migration migration-jobs describe 명령어와 MIGRATION_JOB_ID를 사용하여 이전 작업의 상태를 확인합니다.
• OPERATION_ID와 함께 gcloud database-migration operations describe 명령어를 사용하여 작업 자체의 상태를 확인합니다.