Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

이전 진행 상황 보기 및 관리

이기종 Oracle에서 PostgreSQL용 Cloud SQL로 마이그레이션하는 경우 전체 마이그레이션 작업 또는 마이그레이션 작업에 포함된 개별 테이블의 마이그레이션 진행 상황을 모니터링하고 관리할 수 있습니다.

이 페이지에서는 각 수준에서 수행할 수 있는 작업을 설명합니다. 자세한 내용은 마이그레이션 작업 관리 및 개별 테이블 관리 섹션을 참조하세요.

마이그레이션 작업 관리

Google Cloud 콘솔에서 상태가 동일한 마이그레이션 작업에 대해 일괄적으로 작업을 수행할 수 있습니다. Google Cloud 콘솔 (Database Migration Service 콘솔 또는 대상 Cloud SQL 인스턴스 페이지에서 직접)과 Google Cloud CLI를 사용하여 단일 마이그레이션 작업에 대한 작업을 수행할 수 있습니다.

마이그레이션 작업에서 다음 작업 중 하나를 수행할 수 있습니다.

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

마이그레이션 작업 검토

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

마이그레이션 작업 시작

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

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

콘솔

Database Migration Service 콘솔 또는 대상 인스턴스 페이지에서 마이그레이션 작업을 시작할 수 있습니다.

Database Migration Service 콘솔에서

Google Cloud 콘솔에서 마이그레이션 작업 페이지로 이동합니다.
마이그레이션 작업으로 이동
작업 탭에서 시작하려는 마이그레이션 작업의 표시 이름을 클릭합니다.
마이그레이션 작업 세부정보 페이지가 열립니다.
시작을 클릭합니다.
대화상자에서 시작을 클릭합니다.

대상 인스턴스에서 다음을 수행합니다.

Google Cloud 콘솔에서 Cloud SQL 인스턴스 페이지로 이동합니다.
Cloud SQL 인스턴스로 이동
마이그레이션의 대상 인스턴스 표시 이름을 클릭합니다.
인스턴스 세부정보 페이지가 열립니다.
thought 이전 섹션에서 시작을 클릭합니다.
대화상자에서 시작을 클릭합니다.

gcloud

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

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

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

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

마이그레이션 작업 중지

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

콘솔

Database Migration Service 콘솔 또는 대상 인스턴스 페이지에서 마이그레이션 작업을 중지할 수 있습니다.

Database Migration Service 콘솔에서

Google Cloud 콘솔에서 마이그레이션 작업 페이지로 이동합니다.
마이그레이션 작업으로 이동
작업 탭에서 중지하려는 마이그레이션 작업의 표시 이름을 클릭합니다.
마이그레이션 작업 세부정보 페이지가 열립니다.
중지를 클릭합니다.
대화상자에서 중지를 클릭합니다.

대상 인스턴스에서 다음을 수행합니다.

Google Cloud 콘솔에서 Cloud SQL 인스턴스 페이지로 이동합니다.
Cloud SQL 인스턴스로 이동
마이그레이션의 대상 인스턴스 표시 이름을 클릭합니다.
인스턴스 세부정보 페이지가 열립니다.
마이그레이션 섹션에서 중지를 클릭합니다.
대화상자에서 중지를 클릭합니다.

gcloud

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

MIGRATION_JOB_ID를 마이그레이션 작업 식별자로 바꿉니다.
식별자를 모르는 경우 gcloud database-migration migration-jobs list 명령어를 사용하여 특정 리전의 모든 마이그레이션 작업을 나열하고 식별자를 확인할 수 있습니다.
REGION을 연결 프로필이 저장된 리전의 식별자로 바꿉니다.

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

Linux, macOS 또는 Cloud Shell

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

Windows(PowerShell)

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

Windows(cmd.exe)

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

마이그레이션 작업 재개

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

콘솔

Database Migration Service 콘솔 또는 대상 인스턴스 페이지에서 마이그레이션 작업을 재개할 수 있습니다.

Database Migration Service 콘솔에서

Google Cloud 콘솔에서 마이그레이션 작업 페이지로 이동합니다.
마이그레이션 작업으로 이동
작업 탭에서 재개할 마이그레이션 작업의 표시 이름을 클릭합니다.
마이그레이션 작업 세부정보 페이지가 열립니다.
재개를 클릭합니다.
대화상자에서 재개를 클릭합니다.

대상 인스턴스에서 다음을 수행합니다.

Google Cloud 콘솔에서 Cloud SQL 인스턴스 페이지로 이동합니다.
Cloud SQL 인스턴스로 이동
마이그레이션의 대상 인스턴스 표시 이름을 클릭합니다.
인스턴스 세부정보 페이지가 열립니다.
마이그레이션 섹션에서 재개를 클릭합니다.
대화상자에서 재개를 클릭합니다.

gcloud

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

MIGRATION_JOB_ID를 마이그레이션 작업 식별자로 바꿉니다.
식별자를 모르는 경우 gcloud database-migration migration-jobs list 명령어를 사용하여 특정 리전의 모든 마이그레이션 작업을 나열하고 식별자를 확인할 수 있습니다.
REGION을 연결 프로필이 저장된 리전의 식별자로 바꿉니다.

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

Linux, macOS 또는 Cloud Shell

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

Windows(PowerShell)

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

Windows(cmd.exe)

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

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

마이그레이션 작업을 다시 시작하면 Database Migration Service가 대상 테이블에서 모든 데이터를 완전 삭제합니다. 소스 데이터는 영향을 받지 않습니다. 그러면 이전 프로세스가 전체 덤프 단계부터 새로 시작됩니다.

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

콘솔

Database Migration Service 콘솔 또는 대상 인스턴스 페이지에서 마이그레이션 작업을 다시 시작할 수 있습니다.

Database Migration Service 콘솔에서

Google Cloud 콘솔에서 마이그레이션 작업 페이지로 이동합니다.
마이그레이션 작업으로 이동
작업 탭에서 다시 시작할 마이그레이션 작업의 표시 이름을 클릭합니다.
마이그레이션 작업 세부정보 페이지가 열립니다.
Restart(재시동)를 클릭합니다.
대화상자에서 다시 시작을 클릭합니다.

대상 인스턴스에서 다음을 수행합니다.

Google Cloud 콘솔에서 Cloud SQL 인스턴스 페이지로 이동합니다.
Cloud SQL 인스턴스로 이동
마이그레이션의 대상 인스턴스 표시 이름을 클릭합니다.
인스턴스 세부정보 페이지가 열립니다.
마이그레이션 섹션에서 다시 시작을 클릭합니다.
대화상자에서 다시 시작을 클릭합니다.

gcloud

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

MIGRATION_JOB_ID를 마이그레이션 작업 식별자로 바꿉니다.
식별자를 모르는 경우 gcloud database-migration migration-jobs list 명령어를 사용하여 특정 리전의 모든 마이그레이션 작업을 나열하고 식별자를 확인할 수 있습니다.
REGION을 마이그레이션 작업이 저장된 리전의 식별자로 바꿉니다.

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

Linux, macOS 또는 Cloud Shell

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

Windows(PowerShell)

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

Windows(cmd.exe)

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

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

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

Google Cloud 콘솔에서 마이그레이션 작업 페이지로 이동합니다.
마이그레이션 작업으로 이동
초안 탭에서 만들기를 완료하려는 마이그레이션 작업의 표시 이름을 클릭합니다.
마이그레이션 작업 생성 마법사가 열립니다.
마이그레이션 작업 만들기를 완료합니다. 마이그레이션 작업 만들기를 참조하세요.

마이그레이션 작업 수정

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

마이그레이션에서 객체 추가 또는 삭제

마이그레이션에서 테이블 또는 스키마를 추가하거나 삭제하려면 다음을 수행합니다.

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

마이그레이션 작업으로 이동
수정할 마이그레이션 작업의 표시 이름을 클릭합니다. 마이그레이션 작업의 개요 페이지가 표시됩니다.
마이그레이션할 객체 선택 섹션에서 체크박스를 선택하거나 선택 해제하여 Database Migration Service가 대상으로 마이그레이션할 소스의 테이블과 스키마를 변경합니다.

대상에 선택한 스키마가 있는지 확인합니다.
저장 또는 저장 후 다시 시작을 클릭합니다.
- 저장을 클릭하면 Database Migration Service는 선택한 스키마 및 테이블의 이전 데이터만 이동합니다.
- 저장 및 다시 시작을 클릭하면 Database Migration Service가 대상에서 선택한 테이블을 정리한 후 처음부터 마이그레이션을 시작합니다.

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

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

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

마이그레이션 작업으로 이동
수정할 마이그레이션 작업의 표시 이름을 클릭합니다. 마이그레이션 작업의 개요 페이지가 표시됩니다.
소스 구성 맞춤설정 > 소스 읽기 설정 섹션을 펼칩니다.
최대 동시 전체 덤프 연결 또는 최대 동시 CDC 연결 섹션에서 커스텀 필드를 사용하여 전체 덤프 또는 CDC 단계의 최대 연결 한도를 입력합니다.
저장 또는 저장 후 다시 시작을 클릭합니다.

대상 구성 설정 조정

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

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

마이그레이션 작업으로 이동
수정할 마이그레이션 작업의 표시 이름을 클릭합니다.
마이그레이션 작업의 개요 페이지가 표시됩니다.
대상 구성 맞춤설정 섹션을 펼치고 다음 설정을 수정합니다.

최대 동시 대상 연결

기본값: 128

허용되는 값: 최소 2, 최대 256

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

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

트랜잭션 제한 시간

기본값: 30

허용되는 값: 최소 30, 최대 300

마이그레이션 프로세스 중에 Database Migration Service에서 트랜잭션 시간 초과를 일으키는 특정 문제가 발생할 수 있습니다. Database Migration Service가 트랜잭션이 완료될 때까지 기다리는 시간(초)을 조정할 수 있습니다.

취소된 트랜잭션으로 인해 마이그레이션 작업이 실패하지는 않습니다. 마이그레이션 작업은 계속 데이터를 복사하지만 오류가 발생한 상태로 실행 중 상태로 이동합니다. 마이그레이션 작업 세부정보를 확인하여 해결해야 할 문제를 확인할 수 있습니다.
저장 또는 저장 후 다시 시작을 클릭합니다.

마이그레이션 작업 테스트

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

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

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

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

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

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

개별 테이블 관리

이기종 Oracle에서 PostgreSQL용 Cloud SQL로 마이그레이션하는 경우 마이그레이션 작업에 포함된 특정 테이블의 상태 세부정보를 볼 수 있습니다.

작업의 모든 테이블 보기

마이그레이션 작업의 모든 테이블에 대한 세부정보를 보려면 다음을 수행합니다.

콘솔

Google Cloud 콘솔에서 마이그레이션 작업 페이지로 이동합니다.
마이그레이션 작업으로 이동
작업 탭에서 마이그레이션 작업의 표시 이름을 클릭합니다.
마이그레이션 작업 세부정보 페이지가 열립니다.
테이블 탭을 선택하고 작업에 포함된 모든 테이블을 확인합니다. 대화형 필터를 사용하여 목록의 범위를 좁힐 수도 있습니다.

gcloud

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

MIGRATION_JOB_ID를 마이그레이션 작업 식별자로 바꿉니다.
식별자를 모르는 경우 gcloud database-migration migration-jobs list 명령어를 사용하여 특정 리전의 모든 마이그레이션 작업을 나열하고 식별자를 확인할 수 있습니다.
REGION을 마이그레이션 작업이 저장된 리전의 식별자로 바꿉니다.

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

Linux, macOS 또는 Cloud Shell

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

Windows(PowerShell)

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

Windows(cmd.exe)

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

결과

이 명령어는 마이그레이션 작업에 포함된 모든 테이블의 상태, 단계, 오류 세부정보를 빈 줄로 구분하여 반환합니다.

참고: 다음 예시에서는 더 쉽게 볼 수 있도록 들여쓰기를 추가하지만 응답의 ERROR 객체는 특정 객체의 모든 문제가 포함된 JSON 형식의 한 줄 문자열입니다.

SOURCE_OBJECT: {'schema': 'Schema1', 'table': 'MyTable1', 'type': 'TABLE'}
STATE: RUNNING
PHASE: CDC
ERROR: {}

SOURCE_OBJECT: {'schema': 'Production', 'table': 'MyTable2', 'type': 'TABLE'}
STATE: RUNNING
PHASE: FULL_DUMP
ERROR:
  { 'code': 2,
    'details': [
        { '@type': 'type.googleapis.com/google.rpc.ErrorInfo',
          'domain': 'datamigration.googleapis.com',
          'metadata': {
            'errorMessage': '[DATABASE] error trying to write processed rows.
              Line: 2619 Position: 0 Schema: production Table: mytable2',
            'errorScope': 'NON_GLOBAL',
            'objectId': 'Production_MyTable2',
            'projectName': 'PROJECT_ID',
            'resourceName': 'MIGRATION_JOB_ID',
            'severity': 'ERROR'
          },
          'reason': 'DESTINATION_WRITE_ERROR'
        }
      ],
    'message': 'Encountered errors with your migration job table. Check the `details`
                  array for specific information on each issue.'
  }

단일 테이블의 세부정보 보기

단일 테이블의 마이그레이션 세부정보를 보려면 다음을 수행합니다.

콘솔

Google Cloud 콘솔에서 마이그레이션 작업 페이지로 이동합니다.
마이그레이션 작업으로 이동
작업 탭에서 마이그레이션 작업의 표시 이름을 클릭합니다.
마이그레이션 작업 세부정보 페이지가 열립니다.
테이블 탭을 선택하고 검사할 테이블을 클릭합니다. 대화형 필터를 사용하여 목록의 범위를 좁힐 수도 있습니다.

테이블 세부정보 측면 패널이 열립니다.

gcloud

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

MIGRATION_JOB_ID를 마이그레이션 작업 식별자로 바꿉니다.
식별자를 모르는 경우 gcloud database-migration migration-jobs list 명령어를 사용하여 특정 리전의 모든 마이그레이션 작업을 나열하고 식별자를 확인할 수 있습니다.
REGION을 마이그레이션 작업이 저장된 리전의 식별자로 바꿉니다.
SCHEMA_NAME을 테이블이 포함된 상위 스키마의 이름으로 바꿉니다.
TABLE_NAME을 테이블 이름으로 바꿉니다.

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

Linux, macOS 또는 Cloud Shell

gcloud database-migration objects lookup \
  --migration-job=MIGRATION_JOB_ID \
  --region=REGION \
  --schema=SCHEMA_NAME \
  --table=TABLE_NAME

Windows(PowerShell)

gcloud database-migration objects lookup `
  --migration-job=MIGRATION_JOB_ID `
  --region=REGION `
  --schema=SCHEMA_NAME `
  --table=TABLE_NAME

Windows(cmd.exe)

gcloud database-migration objects lookup ^
  --migration-job=MIGRATION_JOB_ID ^
  --region=REGION ^
  --schema=SCHEMA_NAME ^
  --table=TABLE_NAME

결과

이 명령어는 테이블의 상태, 단계, 생성 시간, 오류 세부정보를 반환합니다. 전체 응답은 여러 줄로 된 YAML 형식 문자열입니다. 예를 들면 다음과 같습니다.

createTime: '2025-06-02T10:20:29.792832Z'
error:
  code: 2
  details:
  - '@type': type.googleapis.com/google.rpc.ErrorInfo
    domain: datamigration.googleapis.com
    metadata:
      errorMessage: '[DATABASE] error trying to write processed rows.
              Line: 2619 Position: 0 Schema: production Table: mytable2'
      errorScope: NON_GLOBAL
      objectId: Production_MyTable2
      projectName: PROJECT_ID
      resourceName: MIGRATION_JOB_ID
      severity: ERROR
    reason: DESTINATION_WRITE_ERROR
  message: Encountered errors with your migration job table. Check the `details` array
    for specific information on each issue.
name: projects/PROJECT_ID/locations/REGION/migrationJobs/MIGRATION_JOB_ID/objects/TABLE_UUID
phase: FULL_DUMP
sourceObject:
  schema: Production
  table: MyTable2
  type: TABLE
state: RUNNING

이전 진행 상황 보기 및 관리 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

마이그레이션 작업 관리

마이그레이션 작업 검토

마이그레이션 작업 시작

콘솔

gcloud

Linux, macOS 또는 Cloud Shell

Windows(PowerShell)

Windows(cmd.exe)

결과

마이그레이션 작업 중지

콘솔

gcloud

Linux, macOS 또는 Cloud Shell

Windows(PowerShell)

Windows(cmd.exe)

결과

마이그레이션 작업 재개

콘솔

gcloud

Linux, macOS 또는 Cloud Shell

Windows(PowerShell)

Windows(cmd.exe)

결과

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

콘솔

gcloud

Linux, macOS 또는 Cloud Shell

Windows(PowerShell)

Windows(cmd.exe)

결과

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

마이그레이션 작업 수정

마이그레이션에서 객체 추가 또는 삭제

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

대상 구성 설정 조정

마이그레이션 작업 테스트

Linux, macOS 또는 Cloud Shell

Windows(PowerShell)

Windows(cmd.exe)

결과

개별 테이블 관리

작업의 모든 테이블 보기

콘솔

gcloud

Linux, macOS 또는 Cloud Shell

Windows(PowerShell)

Windows(cmd.exe)

결과

단일 테이블의 세부정보 보기

콘솔

gcloud

Linux, macOS 또는 Cloud Shell

Windows(PowerShell)

Windows(cmd.exe)

결과

이전 진행 상황 보기 및 관리