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

MySQL   |  PostgreSQL   |  PostgreSQL to AlloyDB

Database Migration Service는 마이그레이션 작업을 사용하여 소스 데이터베이스 인스턴스에서 대상 데이터베이스 인스턴스로 데이터를 마이그레이션합니다. 기존 대상 인스턴스의 마이그레이션 작업을 만들면 다음이 포함됩니다.

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

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

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

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

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

2. 마이그레이션 작업 만들기를 클릭합니다.

   이전 작업 구성 마법사 페이지가 열립니다. 이 마법사에는 각 구성 단계를 안내하는 여러 패널이 포함되어 있습니다.

   저장 및 종료를 클릭하면 언제든지 마이그레이션 작업 만들기를 일시중지할 수 있습니다. 그때까지 입력한 모든 데이터는 마이그레이션 작업 초안에 저장됩니다. 나중에 초안 마이그레이션 작업을 완료할 수 있습니다.

3. 시작하기 페이지에서 다음 정보를 입력합니다.
   1. 마이그레이션 작업 이름

      사람이 읽을 수 있는 마이그레이션 작업 이름입니다. 이 값은 Google Cloud 콘솔에 표시됩니다.

   2. 마이그레이션 작업 ID

      이는 마이그레이션 작업을 기계에서 읽을 수 있는 식별자입니다. 이 값은 Database Migration Service Google Cloud CLI 명령어 또는 API를 사용하여 마이그레이션 작업을 처리하는 데 사용됩니다.

   3. 소스 데이터베이스 엔진 목록에서 MySQL을 선택합니다.

      대상 데이터베이스 엔진 필드는 자동으로 채워지며 변경할 수 없습니다.

   4. 이전 작업을 저장할 리전을 선택합니다.

      Database Migration Service는 완전히 지역별 제품이므로 마이그레이션과 관련된 모든 항목 (소스 및 대상 연결 프로필, 마이그레이션 작업, 대상 데이터베이스)을 단일 리전에 저장해야 합니다. Compute Engine 인스턴스, App Engine 앱, 기타 서비스와 같이 데이터가 필요한 서비스의 위치에 따라 리전을 선택합니다. 대상 리전을 선택한 후에는 이 선택사항을 변경할 수 없습니다.

      중요: MySQL용 Cloud SQL Enterprise Plus 버전을 사용하려면 해당 버전이 지원되는 리전인지 확인하세요. MySQL용 Cloud SQL Enterprise Plus 버전 리전 지원을 참고하세요.
4. 저장 후 계속을 클릭합니다.

소스 연결 프로필 정보 지정

소스 정의 페이지에서 다음 단계를 수행합니다.

1. 소스 연결 프로필 드롭다운 메뉴에서 소스 데이터베이스의 연결 프로필을 선택합니다.
2. 전체 덤프 구성 맞춤설정 섹션에서 구성 수정을 클릭합니다.
3. 전체 덤프 구성 수정 패널의 전체 덤프 방법 드롭다운 메뉴에서 다음 중 하나를 선택합니다.
   • 물리적 기반: Percona XtraBackup 유틸리티를 사용하여 자체 백업 파일을 제공하려면 이 옵션을 선택합니다. 이 접근 방식을 사용하려면 추가 준비 단계가 필요합니다. Percona XtraBackup에서 생성된 실제 백업 파일 사용에 관한 전체 가이드는 Percona XtraBackup 실제 파일을 사용하여 데이터베이스 마이그레이션을 참고하세요.
   • 논리 기반: mysqldump 유틸리티로 만든 논리적 백업 파일을 사용하려면 이 옵션을 선택합니다. Database Migration Service에서 이 백업 파일을 자동으로 생성하거나 자체 사본을 제공할 수 있습니다.
4. 나머지 덤프 설정을 수정합니다. 다음 중 하나를 수행합니다.
   • 실제 백업 파일을 사용하는 경우 폴더 제공에서 찾아보기를 클릭한 다음 전체 덤프 파일을 업로드한 폴더를 선택합니다. 저장소 버킷 자체가 아닌 전체 백업 파일이 포함된 전용 폴더를 선택해야 합니다.

   • 논리적 백업 파일을 사용하는 경우 데이터 덤프 동시 로드 또는 덤프 플래그를 구성합니다.

     이 섹션을 펼쳐서 전체 논리적 백업 파일 단계를 확인하세요.

     덤프 파일을 생성하는 방법 선택 섹션에서 다음 옵션 중 하나를 사용합니다.

     1. 자동 생성 (권장)

        Database Migration Service는 마이그레이션 작업이 생성되고 시작된 후 항상 초기 데이터베이스 덤프 파일을 생성하므로 이 옵션을 사용하는 것이 좋습니다.

        Database Migration Service는 이 파일을 사용하여 소스 데이터베이스의 원래 객체 정의와 테이블 데이터를 재현하여 이 정보를 대상 Cloud SQL 데이터베이스 인스턴스로 마이그레이션할 수 있도록 합니다.

        자동 생성 덤프를 사용하는 경우 데이터 덤프 작업 구성 섹션에서 Database Migration Service가 실행해야 하는 작업 유형을 선택합니다.

        • 데이터 덤프 동시 로드: MySQL 버전 5.7 또는 8로 이전할 때 사용할 수 있는 고성능 동시 로드 옵션을 사용합니다.
          데이터 덤프 병렬 처리를 사용하는 경우 시나리오에 필요한 권한 (예: LOCK_TABLES)을 소스 데이터베이스에 제공해야 합니다. 소스 데이터베이스에 필요한 권한에 관한 자세한 내용은 소스 데이터베이스 구성을 참고하세요.

          데이터 병렬 처리 속도는 소스 데이터베이스에 발생하는 부하량과 관련이 있습니다.

          • 최적 (권장): 소스 데이터베이스의 최적 부하로 균형 잡힌 성능을 제공합니다.
          • 최대: 가장 빠른 덤프 속도를 제공하지만 소스 데이터베이스의 부하가 증가할 수 있습니다.
          • 최소: 소스 데이터베이스에서 가장 적은 양의 컴퓨팅 리소스를 사용하지만 덤프 처리량이 느릴 수 있습니다.
        • 덤프 플래그: 이 옵션은 데이터 덤프 동시 로드와 함께 사용할 수 없습니다. 이 설정을 사용하여 덤프 파일을 만드는 데 사용되는 mysqldump 유틸리티의 플래그를 직접 구성합니다.

          플래그를 추가하려면 다음 단계를 따르세요.

          1. 플래그 추가를 클릭합니다.

          2. 다음 플래그 중 하나를 선택합니다.

             • add-locks: 이 플래그는 덤프 파일에 포함된 각 테이블을 LOCK TABLES 및 UNLOCK TABLES 문이 포함된 괄호로 묶습니다. 이렇게 하면 덤프 파일이 대상 인스턴스에 로드될 때 삽입 속도가 빨라집니다.
             • ignore-error: 이 플래그를 사용하여 쉼표로 구분된 오류 번호 목록을 입력합니다. 이 숫자는 mysqldump 유틸리티에서 무시하는 오류를 나타냅니다.
             • max-allowed-packet: 이 플래그를 사용하여 MySQL 클라이언트와 소스 MySQL 데이터베이스 간의 통신을 위한 버퍼의 최대 크기를 설정합니다. 버퍼의 기본 크기는 24MB이며 최대 크기는 1GB입니다.
               소스 데이터베이스의 테이블에서 큰 BLOB 열이나 긴 문자열을 사용하는 경우 이 플래그의 버퍼 크기를 늘려야 합니다.
             이러한 플래그에 관한 자세한 내용은 MySQL 8.0 참조 설명서의 mysqldump 유틸리티에 관한 문서를 참고하세요.
          3. 완료를 클릭합니다.
          4. 추가하려는 플래그마다 이 단계를 반복합니다.

          신고를 삭제하려면 신고가 포함된 행 오른쪽에 있는 휴지통 아이콘을 클릭합니다.

     2. 직접 제공

        기본적으로 Database Migration Service는 마이그레이션 작업 실행의 일환으로 초기 덤프를 실행하므로 이 옵션은 권장되지 않습니다.

        자체 덤프 파일을 사용하려면 자체 제공을 선택하고 찾아보기를 클릭한 다음 파일 (또는 여러 파일을 사용하는 경우 전체 Cloud Storage 폴더)을 선택하고 선택을 클릭합니다.

        덤프가 지난 24시간 이내에 생성되었으며 덤프 요구사항을 준수하는지 확인합니다.

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

대상 Cloud SQL 인스턴스 선택

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

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

연결 방법 드롭다운 메뉴에서 네트워크 연결 방법을 선택합니다. 이 메서드는 새로 생성된 Cloud SQL 인스턴스가 소스 데이터베이스에 연결되는 방식을 정의합니다. 현재 네트워크 연결 방법에는 IP 허용 목록, 역방향 SSH 터널, VPC 피어링이 있습니다.

다음을 사용하려면	수행할 작업
IP 허용 목록 네트워크 연결 방법	대상 인스턴스의 발신 IP 주소를 지정해야 합니다. 만든 Cloud SQL 인스턴스가 고가용성 인스턴스인 경우 기본 인스턴스와 보조 인스턴스의 발신 IP 주소를 모두 포함합니다.
역방향 SSH 터널 네트워크 연결 메서드	터널을 호스팅할 Compute Engine VM 인스턴스를 선택해야 합니다. 인스턴스를 지정하면 소스 데이터베이스와 대상 데이터베이스 간의 터널을 설정하는 단계를 실행하는 스크립트가 제공됩니다. Google Cloud CLI에서 스크립트를 실행해야 합니다. 소스 데이터베이스와 Google Cloud에 모두 연결된 머신에서 명령어를 실행합니다.
VPC 피어링 네트워크 연결 방법	소스 데이터베이스가 있는 VPC 네트워크를 선택해야 합니다. Cloud SQL 인스턴스가 이 네트워크에 연결되도록 업데이트됩니다.

네트워크 연결을 선택하고 구성한 후 구성 및 계속을 클릭합니다.

마이그레이션 작업 테스트, 만들기, 실행

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

1. 마이그레이션 작업 테스트 및 만들기 페이지에서 작업 테스트를 클릭합니다.

   테스트에 실패하면 흐름의 적절한 부분에서 문제를 해결한 후 다시 테스트할 수 있습니다. 실패한 이전 작업 테스트를 해결하는 방법에 관한 자세한 내용은 MySQL 문제 진단을 참고하세요.

2. 마이그레이션 작업 테스트가 완료되면 작업 만들기 및 시작을 클릭하여 마이그레이션 작업을 만들고 즉시 시작하거나 작업 만들기를 클릭하여 마이그레이션 작업을 만들고 즉시 시작하지 않습니다.

   작업이 생성될 때 시작되지 않은 경우 시작을 클릭하여 마이그레이션 작업 페이지에서 시작할 수 있습니다. 마이그레이션 작업이 시작된 시점과 관계없이 조직은 대상 인스턴스의 존재에 대해 비용을 청구받습니다.

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

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

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

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

시작하기 전에

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

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

Linux, macOS 또는 Cloud Shell

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

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

Windows(PowerShell)

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

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

Windows(cmd.exe)

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

gcloud database-migration connection-profiles ^
create mysql 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]

마이그레이션 작업 만들기

참고: 다음 예는 소스 데이터베이스와 대상 데이터베이스 간에 비공개 IP 연결을 사용하는 이전 시나리오를 나타냅니다. 다른 연결 유형 (예: VPC 피어링 또는 역방향 SSH 터널)을 사용하는 경우 --peer-vpc 또는 --vm, --vm-ip, --vm-port, --vpc와 같은 필수 플래그를 추가해야 합니다. 자세한 내용은 연결 구성 및 Google Cloud CLI 예시를 참고하세요.

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

• MIGRATION_JOB_TYPE을 마이그레이션 작업 유형으로 바꿉니다. 허용되는 값은 ONE_TIME 또는 CONTINUOUS 두 가지입니다. 자세한 내용은 마이그레이션 유형을 참고하세요.

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

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 \
  --type=MIGRATION_JOB_TYPE \

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 `
  --type=MIGRATION_JOB_TYPE `

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 ^
  --type=MIGRATION_JOB_TYPE ^

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

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

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

Linux, macOS 또는 Cloud Shell

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

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

Windows(PowerShell)

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

gcloud database-migration migration-jobs `
demote-destination 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 ^
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를 사용하여 작업 자체의 상태를 확인합니다.

마이그레이션 작업 관리

이 시점에서 마이그레이션 작업이 구성되고 대상 데이터베이스 인스턴스에 연결됩니다. verify,start, stop, restart, resume 작업을 사용하여 관리할 수 있습니다.

마이그레이션 작업 확인

먼저 gcloud database-migration migration-jobs verify 명령어를 실행하여 이전 작업을 확인하는 것이 좋습니다.

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

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

마이그레이션 작업 시작

gcloud database-migration migration-jobs start 명령어를 실행하여 이전 작업을 시작합니다.

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

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

마이그레이션 작업 승격

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

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

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

Windows(PowerShell)

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

gcloud database-migration migration-jobs `
promote 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 ^
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

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

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