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

개요

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

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

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

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

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

Google Cloud 콘솔을 사용하여 마이그레이션 작업 만들기

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

1. Google Cloud 콘솔에서 마이그레이션 작업으로 이동합니다.

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

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

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

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

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

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

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

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

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

소스 연결 프로필 정보 지정

1. 연결 프로필을 만든 경우 기존 연결 프로필 목록에서 선택합니다.

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

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

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

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

   조정된 데이터 덤프 병렬 처리 설정을 사용하려면 소스 데이터베이스에서 max_replication_slots, max_wal_senders, max_worker_processes 매개변수를 늘려야 합니다. 마이그레이션 작업 생성의 마지막 단계에서 마이그레이션 작업 테스트를 실행하여 구성을 확인할 수 있습니다.

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

대상 인스턴스 선택

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

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

1. 연결 방법 메뉴에서 네트워크 연결 방법을 선택합니다. 이 메서드는 새로 생성된 Cloud SQL 인스턴스가 소스 데이터베이스에 연결되는 방식을 정의합니다. 현재 네트워크 연결 방법에는 IP 허용 목록, 역방향 SSH 터널, Private Service Connect 인터페이스, VPC 피어링이 포함됩니다.
   • IP 허용 목록 네트워크 연결 방법을 선택하는 경우 대상 인스턴스의 아웃바운드 IP 주소를 지정해야 합니다. 생성한 Cloud SQL 인스턴스가 고가용성 인스턴스인 경우 기본 인스턴스와 보조 인스턴스의 발신 IP 주소를 모두 포함합니다.

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

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

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

   • 비공개 IP 연결 방법 중 하나를 사용하는 경우 VPC 피어링 또는 PSC 인터페이스를 선택합니다.
   • VPC 피어링 네트워크 연결 방법을 선택한 경우 소스 데이터베이스가 있는 VPC 네트워크를 선택합니다. Cloud SQL 인스턴스가 이 네트워크에 연결되도록 업데이트됩니다.
2. 네트워크 연결 방법을 선택하고 해당 방법에 대한 추가 정보를 제공한 후 구성 및 계속을 클릭합니다.

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

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

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

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

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

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

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

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

1. 작업 테스트를 클릭하여 다음을 확인합니다.

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

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

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

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

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

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

   마이그레이션 작업이 언제 시작되든 대상 인스턴스가 있으면 조직에 요금이 청구됩니다.

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

3. 마이그레이션 작업이 마이그레이션 작업 목록에 추가되며 바로 확인할 수 있습니다.

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

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

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

시작하기 전에

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 콘솔에 표시됩니다.

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

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

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

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]

마이그레이션 작업 만들기

이 샘플에서는 모든 작업이 동기식으로 실행되도록 선택적 --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로 만든 마이그레이션 작업을 수정할 수 있습니다.

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

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 \

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 `

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을 연결 프로필이 저장된 리전의 식별자로 바꿉니다.

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

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

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

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 database-migration migration-jobs \
   verify MIGRATION_JOB_ID \
     --region=REGION

   Windows(PowerShell)

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

   Windows(cmd.exe)

   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
   

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

   • MIGRATION_JOB_ID와 함께 gcloud database-migration migration-jobs describe 명령어를 사용하여 이전 작업의 상태를 확인합니다.
   • 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 database-migration migration-jobs \
   fetch-source-objects MIGRATION_JOB_ID \
     --region=REGION

   Windows(PowerShell)

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

   Windows(cmd.exe)

   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'}
   

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

   • MIGRATION_JOB_ID와 함께 gcloud database-migration migration-jobs describe 명령어를 사용하여 이전 작업의 상태를 확인합니다.
   • 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 database-migration migration-jobs \
   start MIGRATION_JOB_ID \
     --region=REGION

   Windows(PowerShell)

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

   Windows(cmd.exe)

   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
   

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

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

마이그레이션 작업 승격

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

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

• MIGRATION_JOB_ID을 마이그레이션 작업 식별자로 바꿉니다.

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

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

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

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

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

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

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