마이그레이션 작업 관리

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

이전 작업에 대해 다음 작업을 수행할 수 있습니다.

작업	설명
수정	초안이 아닌 이전 작업을 수정하여 다음 사항을 변경할 수 있습니다. gcloud CLI를 사용하여 마이그레이션 작업 표시 이름을 업데이트합니다. 자세한 내용은 초안이 아닌 마이그레이션 작업 수정을 참고하세요. 마이그레이션 작업에서 데이터베이스를 추가하거나 삭제합니다. 자세한 내용은 데이터베이스 추가 또는 삭제를 참고하세요.
시작	실행 중 또는 시작 중 상태가 아닌 마이그레이션 작업을 시작합니다. 마이그레이션 작업 상태를 참고하세요.
중지	실행 중인 마이그레이션 작업을 중지합니다. 데이터 이동이 일시중지되었습니다. 마이그레이션 작업 상태가 먼저 Stopping으로 변경되고 다시 Stopped으로 변경됩니다. 중지된 마이그레이션 작업을 재개하거나 삭제하거나 승격할 수 있습니다.
이력서	증분 로드 중에 마이그레이션 작업을 중지한 경우 나중에 다시 시작할 수 있습니다. 마이그레이션 작업을 재개하면 데이터베이스 이전 서비스가 마이그레이션 작업이 중지된 동안 누적된 모든 트랜잭션 로그 파일을 선택합니다.
다시 시작	오류가 발생하여 데이터 복제를 진행할 수 없는 마이그레이션 작업을 다시 시작할 수 있습니다. 마이그레이션 작업을 다시 시작한 결과는 실패한 이유에 따라 달라집니다. 오류에서 복구할 수 없는 실패한 마이그레이션 작업은 전체 백업 파일의 초기 로드를 포함한 전체 마이그레이션 프로세스를 다시 시도합니다. 하나 이상의 소스 또는 대상 데이터베이스의 오류로 인해 복제가 실패한 경우 마이그레이션을 다시 시작하면 대상 데이터베이스에서 모든 데이터가 완전 삭제됩니다. 이전을 시작한 후 다른 데이터베이스의 새 폴더를 만들고 이전을 위해 선택한 데이터베이스에 추가하면 이전을 다시 시작할 때 새 데이터베이스도 대상 인스턴스로 복제됩니다.
삭제	마이그레이션 작업을 삭제할 수 있습니다. 결과는 작업 상태에 따라 달라집니다. 마이그레이션 작업이 Completed 상태인 경우 레코드가 마이그레이션 작업 목록에서 삭제됩니다. 마이그레이션 작업이 다른 상태인 경우 대상 Cloud SQL 인스턴스/기본 인스턴스 쌍을 삭제하는 옵션이 있습니다.
승격	마이그레이션 프로세스 중에 대상 SQL Server용 Cloud SQL 데이터베이스는 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 \
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를 사용하여 작업 자체의 상태를 확인합니다.

마이그레이션 작업 중지

다음 단계를 실행하여 언제든지 실행 중인 마이그레이션 작업을 중지할 수 있습니다.

콘솔

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

마이그레이션 작업 재개

다음 단계를 실행하여 중지된 마이그레이션 작업을 재개할 수 있습니다.

콘솔

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

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

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

콘솔

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

gcloud

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

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

• MIGRATION_JOB_ID을 마이그레이션 작업의 머신 판독 가능 식별자로 바꿉니다.
• REGION을 연결 프로필을 저장할 리전 식별자로 바꿉니다.
• MIGRATION_JOB_NAME을 마이그레이션 작업의 사람이 읽을 수 있는 이름으로 바꿉니다. 이 값은 Database Migration Service의 Google Cloud 콘솔에 표시됩니다.
• SOURCE_CONNECTION_PROFILE_ID를 소스 연결 프로필의 머신 리더블 식별자로 바꿉니다.
• DESTINATION_CONNECTION_PROFILE_ID을 대상 연결 프로필의 머신 리더블 식별자로 바꿉니다.
• 차등 백업 구성: 마이그레이션 작업에서 Cloud Storage 버킷의 차등 백업 파일을 사용할 수 있는지 여부를 구성할 수 있습니다. 명령어에 다음 플래그 중 하나를 추가합니다.
  • --sqlserver-diff-backup: 이전 시 차등 백업 파일을 사용 설정
  • --no-sqlserver-diff-backup: 이전 시 차등 백업 파일 사용 중지

  지원되는 백업 파일에 대한 자세한 내용은 지원되는 백업 파일 형식을 참고하세요.

• COMMA_SEPARATED_DATABASE_ID_LIST를 사용하고 백업 파일에서 마이그레이션할 SQL Server의 쉼표로 구분된 데이터베이스 식별자 목록을 사용합니다.

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

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 \
  --sqlserver-databases=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 `
  --sqlserver-databases=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 ^
  --sqlserver-databases=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]

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

이전 작업에 새 데이터베이스를 추가하려면 먼저 Cloud Storage 버킷에 새 전용 폴더를 만들고 백업 파일을 여기에 업로드해야 합니다. Cloud Storage 버킷 구성을 참고하세요.

Cloud Storage 버킷에 필요한 백업 파일이 있으면 다음 단계를 실행합니다.

콘솔

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

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

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

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

3. 수정을 클릭합니다.
4. 마이그레이션할 데이터베이스 선택 섹션에서 체크박스를 사용하여 마이그레이션 작업에 추가할 새 데이터베이스를 선택하거나 삭제할 데이터베이스를 선택 해제합니다.
5. (선택사항) 암호화된 백업을 사용하는 경우 백업의 암호화 키를 제공합니다. 암호화된 백업 사용에 관한 자세한 내용은 암호화된 백업 사용을 참고하세요.

   다음 작업을 실행합니다.

   • 마이그레이션할 데이터베이스 옆에 있는 세부정보 수정을 클릭합니다.

     암호화 측면 패널이 열립니다.

   • 암호화 키 메뉴를 사용하여 키를 선택합니다.
   • Password 입력란에 암호화 키 비밀번호를 입력합니다.
   • 저장 후 종료를 클릭합니다.

gcloud

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

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

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

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

• REGION을 연결 프로필이 저장된 리전의 식별자로 바꿉니다.
• COMMA_SEPARATED_DATABASE_ID_LIST를 사용하고 백업 파일에서 마이그레이션할 SQL Server의 쉼표로 구분된 데이터베이스 식별자 목록을 사용합니다. 이 식별자는 Cloud Storage의 데이터베이스 폴더 이름과 동일해야 합니다.

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

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

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 \
  --sqlserver-databases=COMMA_SEPARATED_DATABASE_ID_LIST

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 `
  --sqlserver-databases=COMMA_SEPARATED_DATABASE_ID_LIST

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 ^
  --sqlserver-databases=COMMA_SEPARATED_DATABASE_ID_LIST

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

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]

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

초안이 아닌 이전 작업의 경우 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을 마이그레이션 작업의 사람이 읽을 수 있는 이름으로 바꿉니다. 이 값은 Database Migration Service의 Google Cloud 콘솔에 표시됩니다.

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

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

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

• 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을 연결 프로필이 저장된 리전의 식별자로 바꿉니다.
• 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를 사용하여 작업 자체의 상태를 확인합니다.