마이그레이션 작업 보기 및 관리

프로젝트: /database-migration/docs/sqlserver-to-csql-pgsql/_project.yaml 책: /database-migration/docs/sqlserver-to-csql-pgsql/_book.yaml

Google Cloud 콘솔에서 동일한 상태의 이전 작업에 대해 일괄 작업을 실행할 수 있습니다. Google Cloud 콘솔과 Google Cloud CLI를 모두 사용하여 단일 이전 작업에 대한 작업을 실행할 수 있습니다.

이전 작업에서 다음 작업 중 하나를 수행할 수 있습니다.

작업	설명
시작	실행 중 또는 시작 중 상태가 아닌 마이그레이션 작업을 시작합니다. 마이그레이션 작업 상태를 참고하세요.
중지	실행 중인 마이그레이션 작업을 중지합니다. 데이터 이동이 일시중지됩니다. 이전 작업 상태가 먼저 Stopping으로 변경된 후 Stopped으로 변경됩니다. 중지된 이전 작업을 재개, 삭제 또는 향상할 수 있습니다. 경우에 따라 마이그레이션 작업을 재개할 때까지 소스 데이터베이스에서 데이터를 보관해야 합니다. 소스 데이터베이스의 보관 기간이 제한될 수 있습니다. 마이그레이션 작업이 보관 기간보다 오래 일시중지되었다가 재개되면 마이그레이션 작업이 실패할 수 있습니다. 이 경우 이전 작업을 삭제하거나 다시 시작합니다.
이력서	CDC 단계 중에 중지된 마이그레이션 작업을 재개할 수 있습니다. 마이그레이션 작업을 재개하면 Database Migration Service는 마이그레이션 작업이 중지될 때 누적된 변경 이벤트의 복제를 재개합니다.
다시 시작	오류가 발생하여 데이터 복제를 진행할 수 없는 마이그레이션 작업을 다시 시작할 수 있습니다. 마이그레이션 작업을 다시 시작하면 실패한 이유에 따라 결과가 달라집니다. 하나 이상의 소스 또는 대상 데이터베이스 테이블의 오류로 인해 복제가 실패한 경우 마이그레이션 작업을 다시 시작하면 마이그레이션 작업에 포함된 대상 데이터베이스 테이블의 모든 데이터가 삭제됩니다. 마이그레이션 작업을 다시 시작해도 Database Migration Service에서 소스 데이터베이스에 만든 새 테이블을 복제하지 않습니다. 먼저 테이블을 변환 작업공간에 추가하고 스키마를 변환해야 합니다.
수정	마이그레이션 작업 수정을 참고하세요.
삭제	마이그레이션 작업은 삭제할 수 있습니다. 결과는 작업 상태에 따라 달라집니다. 마이그레이션 작업이 Completed 상태이면 레코드가 마이그레이션 작업 목록에서 삭제됩니다. 마이그레이션 작업이 다른 상태인 경우 연결된 대상 Cloud SQL 인스턴스를 삭제하도록 선택할 수 있는 옵션이 있습니다.
승격	마이그레이션 프로세스 중에 대상 데이터베이스는 Database Migration Service에서 완전히 관리되는 읽기 전용 상태로 전환됩니다. 애플리케이션을 이전된 대상 데이터베이스로 전환하려면 마이그레이션 작업을 승격하여 대상 데이터베이스를 독립형 복제본으로 업데이트합니다. 마이그레이션 승격을 참고하세요.

마이그레이션 작업 검토

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

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

2. 이전 작업을 선택하여 세부정보 페이지를 확인합니다. 세부정보 페이지에는 다음이 포함됩니다.
   • 표시 이름, ID, 마이그레이션 유형, 소스 연결 프로필, 소스 데이터베이스 엔진, 대상, 연결 방법, 마이그레이션 작업 생성 날짜 및 시간, 마이그레이션 작업 실행 시간과 같은 마이그레이션 작업 메타데이터
   • 이전 작업 상태 및 하위 상태, 추가 정보 이전 작업의 상태 및 하위 상태에 따라 다양한 작업을 사용할 수 있습니다.

마이그레이션 작업 시작

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

이전 작업을 시작하려면 다음 단계를 따르세요.

콘솔gcloud

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

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

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

   이전 작업 세부정보 페이지가 열립니다.

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

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

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

마이그레이션 작업 중지

다음 단계에 따라 언제든지 실행 중인 이전 작업을 중지할 수 있습니다.

콘솔gcloud

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

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

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

   이전 작업 세부정보 페이지가 열립니다.

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

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

• 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를 사용하여 작업 자체의 상태를 확인합니다.

마이그레이션 작업 재개

다음 단계에 따라 중지된 이전 작업을 재개할 수 있습니다.

콘솔gcloud

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

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

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

   이전 작업 세부정보 페이지가 열립니다.

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

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

• 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를 사용하여 작업 자체의 상태를 확인합니다.

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

이전 작업을 시작하려면 다음 단계를 따르세요.

콘솔gcloud

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

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

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

   이전 작업 세부정보 페이지가 열립니다.

3. Restart(재시동)를 클릭합니다.
4. 대화상자에서 다시 시작을 클릭합니다.

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

• 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 명령어를 사용하여 --database-filter flag로 만든 이전 작업을 수정할 수 있습니다.

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

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. 마이그레이션 작업 생성을 완료합니다. 마이그레이션 작업 만들기를 참고하세요.

마이그레이션 작업 수정

Database Migration Service가 대상에 마이그레이션할 소스의 데이터베이스 테이블 및 스키마와 같은 소스의 구성 정보를 수정할 수 있습니다. Database Migration Service는 이 구성 정보를 사용하여 소스에서 대상으로 올바른 데이터를 마이그레이션합니다.

이전에서 객체 추가 또는 삭제

이전에서 테이블 또는 스키마를 추가하거나 삭제하려면 다음 단계를 따르세요.

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

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

2. 수정하려는 이전 작업의 표시 이름을 클릭합니다. 마이그레이션 작업의 개요 페이지가 표시됩니다.

3. 이전할 객체 선택 섹션에서 체크박스를 선택하거나 선택 해제하여 Database Migration Service가 대상에 이전할 소스의 테이블과 스키마를 변경합니다.

   대상에 선택한 스키마가 있는지 확인합니다.

4. 저장 또는 저장 후 다시 시작을 클릭합니다.

   • 저장을 클릭하면 Database Migration Service에서 선택한 스키마 및 테이블의 이전 데이터만 이동합니다.

   • 저장 및 다시 시작을 클릭하면 Database Migration Service가 대상에서 선택한 테이블을 정리한 후 처음부터 이전을 시작합니다.

소스 데이터베이스에 대한 최대 동시 연결 조정

Database Migration Service가 전체 덤프 단계 또는 CDC 단계에서 소스 인스턴스에 연결할 수 있는 최대 동시 연결 수를 맞춤설정할 수 있습니다.

1. Google Cloud Console에서 이전 작업 페이지로 이동합니다.

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

2. 수정하려는 이전 작업의 표시 이름을 클릭합니다. 마이그레이션 작업의 개요 페이지가 표시됩니다.

3. 소스 구성 맞춤설정 > 소스 읽기 설정 섹션을 펼칩니다.

4. 최대 동시 전체 덤프 연결 또는 최대 동시 CDC 연결 섹션에서 맞춤 필드를 사용하여 전체 덤프 또는 CDC 단계의 최대 연결 한도를 입력합니다.

5. 저장 또는 저장 후 다시 시작을 클릭합니다.

대상 구성 설정 조정

대상 데이터베이스의 트랜잭션 시간 제한 및 최대 동시 연결 수를 맞춤설정할 수 있습니다.

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

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

2. 수정하려는 이전 작업의 표시 이름을 클릭합니다.

   마이그레이션 작업의 개요 페이지가 표시됩니다.

3. 대상 구성 맞춤설정 섹션을 펼치고 다음 설정을 수정합니다.

   최대 동시 대상 연결

   기본값: 128

   허용되는 값: 최솟값 2, 최댓값 256

   Database Migration Service가 대상 인스턴스에 연결할 수 있는 최대 동시 연결 수를 맞춤설정할 수 있습니다.

   Database Migration Service는 제공된 연결 한도 내에서 최상의 성능을 보장하기 위해 연결 수를 조정합니다. 최대 연결 한도를 늘리면 이전 속도가 향상되지만 대상 데이터베이스에 추가 부하가 발생합니다.

   트랜잭션 시간 초과

   기본값: 30

   허용되는 값: 최솟값 30, 최댓값 300

   이전 프로세스 중에 Database Migration Service에 트랜잭션 시간 초과가 발생하는 특정 문제가 발생할 수 있습니다. Database Migration Service가 트랜잭션이 취소되기 전에 완료될 때까지 기다리는 시간을 초 단위로 조정할 수 있습니다.

   취소된 거래로 인해 마이그레이션 작업이 실패하지는 않습니다. 마이그레이션 작업은 계속해서 데이터를 복사하지만 오류가 있는 상태로 실행 중 상태로 전환됩니다. 마이그레이션 작업 세부정보를 확인하여 해결해야 할 문제를 확인할 수 있습니다.

4. 저장 또는 저장 후 다시 시작을 클릭합니다.

마이그레이션 작업 테스트

마이그레이션 작업을 실행하기 전에 테스트 작업을 실행하여 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

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

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