마이그레이션 작업 관리

마이그레이션 작업 목록, 단일 마이그레이션 작업 세부정보 페이지 또는 Cloud SQL의 대상 인스턴스 페이지에서 직접 작업을 수행할 수 있습니다. Google Cloud 콘솔에서 모든 작업의 상태가 동일한 경우 여러 작업에 대해 동시에 작업을 수행할 수 있습니다. Google Cloud 콘솔과 Google Cloud CLI를 모두 사용하여 단일 마이그레이션 작업에서 작업을 수행할 수 있습니다.

마이그레이션 작업 전체에 대해 일부 작업을 수행할 수 있지만, 마이그레이션 작업 내에서 선택한 개별 데이터베이스에 대해 다른 작업(예: 다시 시작, 승격, 세부정보 보기)을 수행할 수도 있습니다.

마이그레이션 작업에서 다음 작업을 수행할 수 있습니다.

작업	설명
수정	다음과 같이 변경하려면 마이그레이션 작업을 수정합니다. 모든 데이터베이스와 특정 데이터베이스 마이그레이션 간에 변경합니다. 마이그레이션 상태 또는 단계에서 데이터베이스를 필요한 만큼 추가하거나 삭제할 수 있습니다. 데이터베이스를 삭제하면 Database Migration Service는 해당 데이터베이스의 복제 프로세스를 중지하지만 대상 인스턴스에서 삭제하지는 않습니다. 자세한 내용은 데이터베이스 추가 또는 삭제를 참고하세요. 실행 중인 마이그레이션 작업의 데이터 덤프 동시 로드 수준을 수정합니다. 변경한 후에는 작업을 저장하고 다시 시작해야 합니다. gcloud CLI를 사용하여 마이그레이션 작업 표시 이름을 업데이트합니다. 자세한 내용은 초안이 아닌 마이그레이션 작업 수정을 참조하세요.
시작	시작되지 않고 생성된 마이그레이션 작업을 시작합니다. 실행 중 또는 시작 중 상태가 아닌 작업을 시작할 수 있습니다. 마이그레이션 작업 상태를 참조하세요.
중지	언제든지 실행 중인 마이그레이션 작업을 중지할 수 있습니다. 데이터 마이그레이션이 중지되고 마이그레이션 작업 상태가 Stopping로 변경된 후 Stopped로 변경됩니다. 초기 전체 덤프 단계 중에 마이그레이션 작업이 중지되면 작업을 삭제하거나 다시 시작할 수 있습니다. 하지만 소스 데이터베이스의 복제 슬롯에 WAL 로그가 계속 누적되어 결국 소스 데이터베이스의 디스크 공간이 부족해질 수 있습니다. 또한 Database Migration Service는 복제 지연 측정항목을 계속 폴링하여 네트워크 트래픽을 계속 사용합니다. 변경 데이터 캡처 (CDC) 단계 중에 마이그레이션 작업이 중지되면 작업을 재개, 승격 또는 삭제할 수 있습니다. 소스 데이터베이스 서버의 복제 슬롯과 디스크 공간을 모니터링합니다. 마이그레이션 작업을 삭제하면 소스의 모든 복제 슬롯이 삭제되고 네트워크 트래픽이 중지됩니다.
이력서	CDC 단계 중에 연속 마이그레이션 작업이 중지된 경우 재개할 수 있습니다. 마이그레이션 작업을 재개하면 중지된 시간 동안 누적된 이벤트 및 데이터 변경사항의 복제가 다시 시작됩니다.
다시 시작	마이그레이션 작업이 실패하고 복구할 수 없거나 초기 전체 덤프 단계 중에 중지된 경우 처음부터 다시 시작할 수 있습니다. 마이그레이션을 다시 시작하면 오류의 영향을 받는 모든 대상 데이터베이스에서 모든 데이터가 완전 삭제되고 새 전체 덤프가 수행됩니다. 마이그레이션이 시작된 후 소스 PostgreSQL 서버에 새 데이터베이스가 생성된 경우 마이그레이션을 다시 시작하면 해당 새 데이터베이스도 대상 인스턴스에 복제됩니다. 마이그레이션 작업에서 모든 데이터베이스를 다시 시작하거나 선택한 데이터베이스만 다시 시작할 수 있습니다.
삭제	마이그레이션 작업을 삭제합니다. 어떤 상태에서든 마이그레이션 작업을 삭제할 수 있습니다. 하지만 실행 중인 마이그레이션 작업은 Google Cloud 콘솔에서만 삭제할 수 있습니다. 결과는 작업 상태에 따라 달라집니다. 마이그레이션 작업 상태가 Completed이면 마이그레이션 작업 목록에서 레코드가 삭제됩니다. 마이그레이션 작업이 다른 상태인 경우 Google Cloud 콘솔에 대상 Cloud SQL 인스턴스를 삭제할지 여부를 선택하는 옵션이 있습니다. 마이그레이션 작업을 삭제하면 소스 데이터베이스에서 할당된 복제 슬롯이 삭제되고 네트워크 트래픽이 중지됩니다. 마이그레이션 작업을 삭제해도 소스 데이터베이스는 삭제되지 않습니다.
프로모션	대상 인스턴스를 복제본에서 독립형 기본 데이터베이스 인스턴스로 승격하고 소스에서 대상 인스턴스를 연결 해제합니다. 전체 마이그레이션 작업을 승격하거나 선택한 개별 데이터베이스를 승격할 수 있습니다. 자세한 내용은 마이그레이션 승격을 참조하세요.
특정 데이터베이스 보기	이전을 위해 구성된 특정 데이터베이스의 이전 세부정보를 확인합니다.
모든 데이터베이스 보기	마이그레이션하도록 구성된 모든 데이터베이스의 마이그레이션 세부정보를 확인합니다.

마이그레이션 작업 시작

마이그레이션 작업이 완전히 생성되면 (즉, 초안 상태로 저장되지 않음) 언제든지 시작하여 데이터 마이그레이션을 시작할 수 있습니다.

마이그레이션 작업을 시작하려면 다음 단계를 수행합니다.

콘솔

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

   마이그레이션 작업으로 이동

2. 작업 탭에서 시작하려는 마이그레이션 작업의 표시 이름을 클릭합니다.

   마이그레이션 작업 세부정보 페이지가 열립니다.

3. 시작을 클릭합니다.
4. 대화상자에서 시작을 클릭합니다.

gcloud

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

• 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

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

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

마이그레이션 작업 중지

언제든지 실행 중인 마이그레이션 작업을 중지할 수 있습니다. 마이그레이션 작업을 중지하면 데이터 마이그레이션이 중지되고 마이그레이션 작업 상태가 Stopping로 변경된 후 Stopped로 변경됩니다.

주의: 마이그레이션 작업이 중지되면 소스 데이터베이스 서버의 복제 슬롯에 WAL 로그가 계속 누적됩니다. 이로 인해 결국 소스 데이터베이스의 디스크 공간이 부족해질 수 있습니다. 또한 Database Migration Service는 복제 지연 측정항목을 계속 폴링하여 네트워크 트래픽을 계속 사용합니다. 소스 데이터베이스 서버의 복제 슬롯 및 디스크 공간을 모니터링합니다. 마이그레이션을 재개할 계획이 없으면 마이그레이션 작업을 삭제하여 복제 슬롯을 정리하고 네트워크 트래픽을 중지합니다.

마이그레이션 작업을 중지하려면 다음 단계를 수행합니다.

콘솔

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

   마이그레이션 작업으로 이동

2. 작업 탭에서 중지하려는 마이그레이션 작업의 표시 이름을 클릭합니다.

   마이그레이션 작업 세부정보 페이지가 열립니다.

3. 중지를 클릭합니다.
4. 대화상자에서 중지를 클릭합니다.

gcloud

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

• 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 \
stop MIGRATION_JOB_ID \
  --region=REGION

Windows(PowerShell)

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

gcloud database-migration migration-jobs `
stop 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 ^
stop 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: stop
name: OPERATION_ID

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

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

마이그레이션 작업 재개

변경 데이터 캡처 (CDC) 단계 중에 연속 마이그레이션 작업이 중지된 경우 이를 재개할 수 있습니다. 마이그레이션 작업을 재개하면 작업이 중지된 동안 소스 데이터베이스에 누적된 이벤트 및 데이터 변경사항의 복제가 다시 시작됩니다.

중지된 마이그레이션 작업을 재개하려면 다음 단계를 수행합니다.

콘솔

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

   마이그레이션 작업으로 이동

2. 작업 탭에서 재개할 마이그레이션 작업의 표시 이름을 클릭합니다.

   마이그레이션 작업 세부정보 페이지가 열립니다.

3. 재개를 클릭합니다.
4. 대화상자에서 재개를 클릭합니다.

gcloud

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

• 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 \
resume MIGRATION_JOB_ID \
  --region=REGION

Windows(PowerShell)

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

gcloud database-migration migration-jobs `
resume 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 ^
resume 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: resume
name: OPERATION_ID

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

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

마이그레이션 작업 다시 시작

마이그레이션 작업이 실패하고 복구할 수 없거나 초기 전체 덤프 단계 중에 중지된 경우 처음부터 다시 시작할 수 있습니다.

마이그레이션을 다시 시작하면 오류의 영향을 받는 모든 대상 데이터베이스에서 모든 데이터가 완전 삭제되고 새 전체 덤프가 시작됩니다. 마이그레이션이 시작된 후 소스 PostgreSQL 서버에 새 데이터베이스가 생성된 경우 마이그레이션을 다시 시작하면 해당 새 데이터베이스도 대상 인스턴스에 복제됩니다.

마이그레이션 작업에서 모든 데이터베이스를 다시 시작하거나 특정 데이터베이스만 다시 시작할 수 있습니다.

마이그레이션 작업을 다시 시작하려면 다음 단계를 수행합니다.

콘솔

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

   마이그레이션 작업으로 이동

2. 작업 탭에서 다시 시작할 마이그레이션 작업의 표시 이름을 클릭합니다.

   마이그레이션 작업 세부정보 페이지가 열립니다.

3. 다음 다시 시작 작업 중 하나를 수행합니다.

   • 마이그레이션에 포함된 모든 데이터베이스를 다시 시작하려면 마이그레이션 작업의 툴바에서 다시 시작을 클릭합니다.

     마이그레이션 작업 다시 시작 대화상자가 표시됩니다.

   • 특정 데이터베이스만 다시 시작하려면 데이터베이스 이름 옆에 있는 체크박스를 사용하여 선택하고 데이터베이스 탭에서 다시 시작을 클릭합니다.

     다시 시작하려는 데이터베이스 수가 포함된 대화상자가 표시됩니다.

4. 대화상자에서 다시 시작을 클릭합니다.

gcloud

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

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

  식별자를 모르는 경우 gcloud database-migration migration-jobs list 명령어를 사용하여 특정 리전의 모든 마이그레이션 작업을 나열하고 식별자를 볼 수 있습니다.

• REGION을 마이그레이션 작업이 저장된 리전의 식별자로 바꿉니다.

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

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

  나중에 gcloud database-migration migration-jobs update 명령어를 사용하여 --databases-filter 플래그로 만든 마이그레이션 작업을 수정할 수 있습니다.

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

Linux, macOS 또는 Cloud Shell

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

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

Windows(PowerShell)

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

gcloud database-migration migration-jobs `
restart 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 ^
restart 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: restart
name: OPERATION_ID

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

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

마이그레이션 작업 초안 업데이트

마이그레이션 작업 만들기를 완료하려면 다음 단계를 수행합니다.

콘솔

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

   마이그레이션 작업으로 이동

2. 초안 탭에서 만들기를 완료하려는 마이그레이션 작업의 표시 이름을 클릭합니다.

   마이그레이션 작업 생성 마법사가 열립니다.

3. 마이그레이션 작업 만들기를 완료합니다. 마이그레이션 작업 만들기를 참조하세요.

gcloud

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

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

• MIGRATION_JOB_ID을 마이그레이션 작업의 기계 가독형 식별자로 바꿉니다.
• REGION을 연결 프로필을 저장할 리전 식별자로 바꿉니다.
• MIGRATION_JOB_NAME을 인간이 읽을 수 있는 마이그레이션 작업 이름으로 바꿉니다. 이 값은 Google Cloud 콘솔의 Database Migration Service에 표시됩니다.
• SOURCE_CONNECTION_PROFILE_ID를 소스 연결 프로필의 기계 가독형 식별자로 바꿉니다.
• DESTINATION_CONNECTION_PROFILE_ID: 대상 연결 프로필의 기계 가독형 식별자
• COMMA_SEPARATED_DATABASE_ID_LIST: 마이그레이션할 PostgreSQL의 데이터베이스 식별자의 쉼표로 구분된 목록입니다.

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

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 \
  --databases-filter=COMMA_SEPARATED_DATABASE_ID_LIST \
  --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 `
  --databases-filter=COMMA_SEPARATED_DATABASE_ID_LIST `
  --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 ^
  --databases-filter=COMMA_SEPARATED_DATABASE_ID_LIST ^
  --type=CONTINUOUS

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

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

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

Updated migration job MIGRATION_JOB_ID [OPERATION_ID]

마이그레이션 작업에서 데이터베이스 추가 또는 삭제

필요한 만큼 마이그레이션 상태 또는 단계에서 데이터베이스를 추가하거나 삭제할 수 있습니다. 데이터베이스를 삭제하면 Database Migration Service가 해당 데이터베이스에서 복제 프로세스를 중지하지만 대상 Cloud SQL 인스턴스에서 삭제하지는 않습니다.

참고: 변경할 때마다 마이그레이션 작업을 저장해야 합니다.

마이그레이션 작업에서 데이터베이스를 추가하거나 삭제하려면 다음 단계를 수행합니다.

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

   마이그레이션 작업으로 이동

2. 작업 탭에서 마이그레이션 작업의 표시 이름을 클릭합니다. 마이그레이션 작업 세부정보 페이지가 열립니다.
3. 수정을 클릭합니다.
4. 마이그레이션할 데이터베이스 선택 섹션에서 체크박스를 사용하여 마이그레이션 작업에 추가할 새 데이터베이스를 선택하거나 삭제할 데이터베이스를 선택 해제합니다.
5. 저장을 클릭합니다.

초안이 아닌 마이그레이션 작업 수정

실행 중인 마이그레이션 작업의 데이터 덤프 동시 로드 수준을 수정하려면 동시 로드 고려사항을 참조하세요. 동시 로드 설정을 변경한 후 마이그레이션 작업을 저장하고 다시 시작해야 합니다.

초안이 아닌 마이그레이션 작업의 경우 Google Cloud CLI를 사용하여 마이그레이션 작업의 표시 이름을 변경할 수 있습니다.

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

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

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

  식별자를 모르는 경우 gcloud database-migration migration-jobs list 명령어를 사용하여 특정 리전의 모든 마이그레이션 작업을 나열하고 식별자를 볼 수 있습니다.

• REGION: 연결 프로필이 저장된 리전의 식별자
• MIGRATION_JOB_NAME을 인간이 읽을 수 있는 마이그레이션 작업 이름으로 바꿉니다. 이 값은 Google Cloud 콘솔의 Database Migration Service에 표시됩니다.

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

Linux, macOS 또는 Cloud Shell

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

gcloud database-migration migration-jobs \
update MIGRATION_JOB_ID \
  --region=REGION \
  --display-name=MIGRATION_JOB_NAME

Windows(PowerShell)

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

gcloud database-migration migration-jobs `
update MIGRATION_JOB_ID `
  --region=REGION `
  --display-name=MIGRATION_JOB_NAME

Windows(cmd.exe)

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

gcloud database-migration migration-jobs ^
update MIGRATION_JOB_ID ^
  --region=REGION ^
  --display-name=MIGRATION_JOB_NAME

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

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

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

Updated migration job MIGRATION_JOB_ID [OPERATION_ID]

마이그레이션 작업 테스트

마이그레이션 작업을 실행하기 전에 테스트 작업을 수행하여 Database Migration Service가 필요한 모든 소스 및 대상 항목에 도달할 수 있는지 확인할 수 있습니다. Google Cloud 콘솔에서는 마이그레이션 작업 만들기 마법사에서 만든 초안 마이그레이션 작업만 테스트할 수 있습니다 ( 마이그레이션 작업 만들기 참조).

gcloud CLI를 사용하면 생성되었지만 아직 시작되지 않은 마이그레이션 작업을 테스트할 수 있습니다.

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

• 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

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

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

특정 데이터베이스의 마이그레이션 세부정보 보기

마이그레이션 작업이 완전히 생성되면 (즉, 초안 상태로 저장되지 않음) Google Cloud CLI를 사용하여 해당 마이그레이션 작업의 특정 데이터베이스에 대한 세부정보를 볼 수 있습니다.

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

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

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

  식별자를 모르는 경우 gcloud database-migration migration-jobs list 명령어를 사용하여 특정 리전의 모든 마이그레이션 작업을 나열하고 식별자를 볼 수 있습니다.

• REGION: 연결 프로필이 저장된 리전의 식별자
• DATABASE_NAME을 데이터베이스 이름으로 바꿉니다.

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

Linux, macOS 또는 Cloud Shell

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

gcloud database-migration objects lookup --migration-job=MIGRATION_JOB_ID \
  --region=REGION --database=DATABASE_NAME

Windows(PowerShell)

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

gcloud database-migration objects lookup --migration-job=MIGRATION_JOB_ID `
  --region=REGION --database=DATABASE_NAME

Windows(cmd.exe)

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

gcloud database-migration objects lookup --migration-job=MIGRATION_JOB_ID ^
  --region=REGION --database=DATABASE_NAME

결과

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

createTime: '2025-03-21T17:05:19.211441641Z'
name: PROJECT_ID
phase: FULL_DUMP
sourceObject:
  database: DATABASE_NAME
  type: DATABASE
state: RUNNING

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

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

특정 데이터베이스의 마이그레이션 세부정보 보기

마이그레이션 작업이 완전히 생성되면 (즉, 초안 상태로 저장되지 않음) Google Cloud CLI를 사용하여 해당 마이그레이션 작업에 대해 선택한 모든 데이터베이스를 나열하고 세부정보를 볼 수 있습니다.

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

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

• 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 objects list --migration-job=MIGRATION_JOB_ID \
  --region=REGION

Windows(PowerShell)

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

gcloud database-migration objects list --migration-job=MIGRATION_JOB_ID `
  --region=REGION

Windows(cmd.exe)

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

gcloud database-migration objects list --migration-job=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': 'db1', 'type': 'DATABASE'}  RUNNING  FULL_DUMP
{'database': 'db2', 'type': 'DATABASE'}  STOPPED  CDC        {'code': 1, 'message': 'Internal error'}

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

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