Percona XtraBackup 실제 파일을 사용하여 데이터베이스 마이그레이션

MySQL용 Percona XtraBackup 유틸리티로 만든 물리적 데이터베이스 백업 파일을 사용하여 MySQL 데이터베이스를 Cloud SQL로 마이그레이션할 수 있습니다. 물리적 백업 파일로 마이그레이션하면 논리적 백업 파일을 사용하는 마이그레이션보다 데이터 복원 속도가 향상됩니다. 따라서 테라바이트 단위의 데이터가 포함된 대형 데이터베이스를 이동하는 데 적합합니다.

이 마이그레이션 흐름에는 다음 작업이 포함됩니다.

  1. MySQL용 Percona XtraBackup 유틸리티를 사용하여 소스 MySQL 인스턴스를 백업하고 물리적 백업 파일을 준비합니다.

  2. 백업 파일을 Cloud Storage 버킷에 업로드합니다.

  3. Database Migration Service에서 마이그레이션 작업을 만들고 실행합니다.d

    시나리오에 따라 직접 대상 인스턴스를 만들거나 Database Migration Service가 마이그레이션 작업 생성 흐름의 일부로 대상 인스턴스를 만들어 주도록 할 수 있습니다. 자세한 내용은 이전 작업 구성 및 실행 단계를 참고하세요.

  4. 데이터가 완전히 마이그레이션된 후에 마이그레이션 작업을 승격합니다.

오프라인 마이그레이션

이 가이드에서는 소스 및 대상 데이터베이스 인스턴스 간에 네트워크 연결을 보장할 수 있는 환경의 마이그레이션 시나리오를 설명합니다.

Database Migration Service가 소스 인스턴스에 연결되지 않는 테스트 마이그레이션을 실행할 수 있습니다. 대신 Database Migration Service는 Cloud Storage 버킷에 업로드한 백업 파일만 읽고 콘텐츠를 MySQL용 Cloud SQL 대상에 복제합니다. 네트워크 연결을 사용하지 않는 마이그레이션 흐름은 프로덕션 마이그레이션에 권장되지 않습니다. Database Migration Service가 데이터 유효성 검사를 완전히 수행할 수 없기 때문입니다.

오프라인 마이그레이션 작업을 실행하려면 다음과 같이 절차를 조정하세요.

제한사항

이 섹션에는 Percona XtraBackup 물리적 파일을 사용하는 마이그레이션의 제한사항이 나와 있습니다.

  • 물리적 백업 파일을 사용하여 MySQL 5.6 또는 8.4로 이전하는 것은 지원되지 않습니다. 알려진 제한사항을 참고하세요.

  • 교차 버전 고려사항:

    • 동일한 데이터베이스 메이저 버전 내에서만 마이그레이션할 수 있습니다(예: MySQL 8.0.30에서 MySQL 8.0.35로 또는 MySQL 5.7.0에서 MySQL 5.7.1로).

    • MySQL 5.7에서 MySQL 8.0으로 마이그레이션할 수 없습니다.

    • 이전 데이터베이스 주 버전 또는 부 버전에는 마이그레이션이 지원되지 않습니다. 예를 들어 MySQL 8.0에서 5.7로 또는 MySQL 8.0.36에서 8.0.16으로 마이그레이션할 수 없습니다.

  • Percona XtraBackup을 사용하여 데이터를 Cloud Storage 버킷에 백업해야 합니다. 다른 백업 유틸리티는 지원되지 않습니다.

  • Percona XtraBackup 물리적 파일에서 데이터베이스 마이그레이션은 온프레미스 또는 자체 관리형 VM MySQL 데이터베이스에서만 지원됩니다. Amazon RDS 데이터베이스의 Amazon Aurora 또는 MySQL에서 마이그레이션할 수 없습니다.

  • 전체 백업에서만 마이그레이션할 수 있습니다. 증분 또는 부분 백업과 같은 다른 백업 유형은 지원되지 않습니다.

  • 데이터베이스 마이그레이션에는 데이터베이스 사용자 또는 권한이 포함되지 않습니다.

  • 바이너리 로그 형식을 ROW로 설정해야 합니다. 바이너리 로그를 STATEMENT 또는 MIXED와 같은 다른 형식으로 구성하면 복제가 실패할 수 있습니다.

  • 테이블이 5TB를 초과하는 데이터베이스는 지원되지 않습니다.

  • Cloud Storage에서는 버킷에 업로드할 수 있는 파일 크기를 5TB로 제한합니다. Percona XtraBackup 실제 파일이 5TB를 초과하면 백업 파일을 더 작은 파일로 분할해야 합니다.

  • 다른 파일이 포함되지 않은 전용 Cloud Storage 폴더에 백업 파일을 업로드해야 합니다.

  • 기본 데이터 파일 이름 ibdata1을 사용하는 데이터 파일 한 개로만 innodb_data_file_path 매개변수를 구성해야 합니다. 데이터베이스가 2개의 데이터 파일로 구성되었거나 이름이 다른 데이터 파일이 있는 경우 Percona XtraBackup 물리적 파일을 사용하여 데이터베이스를 마이그레이션할 수 없습니다. 예를 들어 innodb_data_file_path=ibdata01:50M:autoextend로 구성된 데이터베이스는 마이그레이션에 지원되지 않습니다.

  • 소스 인스턴스의 innodb_page_size 매개변수는 기본값 16384로 구성되어야 합니다.

  • 외부 데이터베이스에서 플러그인을 마이그레이션할 수 없습니다.

비용

Cloud SQL로의 동종 마이그레이션의 경우 Database Migration Service가 추가 비용 없이 제공됩니다. 하지만 Cloud SQL 및 Cloud Storage 가격은 네트워크 요금뿐만 아니라 마이그레이션 목적으로 생성된 Cloud SQL 및 Cloud Storage 항목에도 적용됩니다.

이 문서에서는 비용이 청구될 수 있는 다음과 같은 Google Cloud 구성요소를 사용합니다.

  • Cloud Storage
  • Cloud SQL

프로젝트 사용량을 기준으로 예상 비용을 산출하려면 가격 계산기를 사용하세요. Google Cloud를 처음 사용하는 사용자는 무료 체험판을 사용할 수 있습니다.

시작하기 전에

  1. 대상 데이터베이스를 만들 리전을 고려합니다. Database Migration Service는 완전히 지역화된 제품이므로 마이그레이션과 관련된 모든 항목 (소스 및 대상 연결 프로필, 마이그레이션 작업, 대상 데이터베이스, 저장소 버킷)을 단일 리전에 저장해야 합니다.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  3. Enable the Database Migration Service, Compute Engine, and Cloud SQL Admin APIs.

    Enable the APIs

필요한 역할

실제 백업 파일을 사용하여 동질적인 MySQL 이전을 실행하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 다음 IAM 역할을 부여해 달라고 요청하세요.

역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

이러한 사전 정의된 역할에는 실제 백업 파일을 사용하여 동질적인 MySQL 이전을 실행하는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 펼치세요.

필수 권한

실제 백업 파일을 사용하여 동질적인 MySQL 이전을 실행하려면 다음 권한이 필요합니다.

  • 이전을 실행하는 사용자 계정:
    • datamigration.*
    • resourcemanager.projects.get
    • resourcemanager.projects.list
    • cloudsql.instances.create
    • cloudsql.instances.get
    • cloudsql.instances.list
    • compute.machineTypes.list
    • compute.machineTypes.get
    • compute.projects.get
    • storage.buckets.create
    • storage.buckets.list

커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.

1단계: 네트워크 연결 요구사항 고려

소스와 Cloud SQL 대상 인스턴스 간의 연결을 구성하는 데 사용할 수 있는 다양한 네트워킹 방법이 있습니다. 사용하는 방법에 따라 마이그레이션 프로세스 중에 추가 단계를 실행해야 할 수도 있습니다.

다음 단계로 진행하기 전에 시나리오에 적합한 연결 방법을 고려하세요. 선택한 방법에 따라 사용해야 하는 설정이 달라질 수 있습니다. 자세한 내용은 연결 구성을 참고하세요.

2단계: 데이터 소스 준비

마이그레이션을 위해 데이터를 준비하려면 다음 단계를 수행하세요.

  1. 소스 인스턴스에 올바른 버전의 Percona XtraBackup 유틸리티를 설치합니다. 소스 인스턴스 버전과 같거나 그 이후 버전의 Percona XtraBackup을 사용해야 합니다. 자세한 내용은 Percona XtraBackup 문서의 서버 버전 및 백업 버전 비교를 참고하세요.
  2. Percona XtraBackup을 사용하여 소스 인스턴스의 물리적 백업 파일을 내보내고 준비합니다. Percona XtraBackup 사용에 관한 자세한 내용은 도구의 문서를 참고하세요. 다음 섹션을 펼쳐 권장 단계의 예시를 확인할 수도 있습니다.

    Percona XtraBackup을 사용하여 물리적 백업 파일을 만들고 준비하는 데 권장되는 샘플 단계

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

    • TARGET_DIR를 출력 백업 파일을 저장할 경로로 바꿉니다.
    • 소스 인스턴스에 대한 BACKUP_ADMIN 권한이 있는 사용자로 USERNAME
    • PASSWORD를 USERNAME 계정의 비밀번호로 바꿉니다.
    1. 소스 인스턴스의 전체 물리적 백업을 실행합니다. 다음 명령어를 실행합니다. 
        xtrabackup --backup \
    --target-dir=TARGET_DIR \
    --user=USERNAME \
    --password=PASSWORD
    2. 백업 파일이 준비되면 --prepare 명령어를 사용하여 파일 일관성을 확인합니다. 다음 명령어를 실행합니다. 
        xtrabackup --prepare --target-dir=TARGET_DIR
  3. 백업 파일을 저장할 버킷을 만듭니다. 대상 MySQL용 Cloud SQL 인스턴스를 만들 리전과 동일한 리전을 사용해야 합니다.

    Database Migration Service는 완전히 지역별 제품이므로 마이그레이션과 관련된 모든 항목 (소스 및 대상 연결 프로필, 마이그레이션 작업, 대상 데이터베이스, 백업 파일의 스토리지 버킷)을 단일 리전에 저장해야 합니다.

  4. Cloud Storage 버킷에 백업 파일을 업로드합니다. 다른 파일이 포함되지 않은 전용 Cloud Storage 폴더에 백업 파일을 업로드해야 합니다. Cloud Storage 문서의 파일 시스템에서 객체 업로드를 참고하세요.
  5. 소스 데이터베이스 인스턴스의 소스 연결 프로필을 만듭니다.

    콘솔

    소스 연결 프로필을 만들려면 다음 단계를 따르세요.

    1. Google Cloud Console에서 연결 프로필 페이지로 이동합니다.
    2. 프로필 만들기를 클릭합니다.
    3. 연결 프로필 만들기 페이지의 데이터베이스 엔진 드롭다운 메뉴에서 MySQL을 선택합니다.
    4. 연결 프로필 이름 필드에 연결 프로필의 사람이 읽을 수 있는 이름을 입력합니다. 이 값은 연결 프로필 목록에 표시됩니다.
    5. 자동 생성된 연결 프로필 ID를 그대로 둡니다.
    6. 호스트 이름 또는 IP 주소를 입력합니다.

      • 소스 데이터베이스가 Google Cloud에 호스팅되거나 역방향 SSH 터널을 사용하여 대상 데이터베이스를 소스 데이터베이스에 연결하는 경우 소스 데이터베이스의 비공개 (내부) IP 주소를 지정합니다. Cloud SQL 대상에서 이 주소에 액세스할 수 있습니다. 자세한 내용은 VPC 피어링을 사용하여 연결 구성을 참고하세요.

        IP 허용 목록과 같은 다른 연결 방법의 경우 공개 IP 주소를 제공합니다.

    7. 호스트에 액세스하는 데 사용되는 포트를 입력합니다. 기본 MySQL 기본 포트는 3306입니다.
    8. 대상 데이터베이스의 사용자 이름과 비밀번호를 입력합니다. 사용자 계정에 데이터에 액세스하는 데 필요한 권한이 있어야 합니다. 자세한 내용은 소스 데이터베이스 구성을 참고하세요.
    9. 페이지의 연결 프로필 리전 섹션에서 연결 프로필을 저장할 리전을 선택합니다.

    10. 선택사항: 공개 네트워크(IP 허용 목록 사용)를 통해 연결하는 경우 소스 데이터베이스와 대상 데이터베이스 간의 연결에 SSL/TLS 암호화를 사용하는 것이 좋습니다.

      페이지의 연결 보호 섹션에서 선택할 수 있는 SSL/TLS 구성 옵션은 세 가지입니다.

      1. None(없음): Cloud SQL 대상 인스턴스가 암호화 없이 소스 데이터베이스에 연결됩니다.

      2. 서버 전용 인증: Cloud SQL 대상 인스턴스가 소스 데이터베이스에 연결되면 인스턴스가 소스를 인증하여 인스턴스가 올바른 호스트에 안전하게 연결되는지 확인합니다. 이렇게 하면 중간자 공격을 방지할 수 있습니다. 서버 전용 인증의 경우 소스가 인스턴스를 인증하지 않습니다.

        서버 전용 인증을 사용하려면 외부 서버의 인증서에 서명한 인증 기관 (CA)의 x509 PEM 인코딩 인증서를 제공해야 합니다.

      3. 서버 클라이언트 인증: 대상 인스턴스가 소스에 연결되면 인스턴스가 소스를 인증하고 소스가 인스턴스를 인증합니다.

        서버 클라이언트 인증은 가장 강력한 보안을 제공합니다. 하지만 Cloud SQL 대상 인스턴스를 만들 때 클라이언트 인증서와 비공개 키를 제공하고 싶지 않을 경우 서버 전용 인증을 사용하면 됩니다.

        서버 클라이언트 인증을 사용하려면 대상 연결 프로필을 만들 때 다음과 같은 항목을 제공해야 합니다.

        • 소스 데이터베이스 서버의 인증서(CA 인증서)에 서명한 CA의 인증서입니다.
        • 소스 데이터베이스 서버(클라이언트 인증서)를 인증하기 위해 인스턴스가 사용하는 인증서입니다.
        • 클라이언트 인증서와 연결된 비공개 키 (클라이언트 키)입니다.
    11. 만들기를 클릭합니다. 이제 연결 프로필이 생성되었습니다.

    gcloud

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

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

    • CONNECTION_PROFILE_ID: 연결 프로필의 기계가 읽을 수 있는 식별자
    • REGION을 연결 프로필을 저장하려는 리전의 식별자로 바꿉니다.
    • Database Migration Service가 소스 데이터베이스 인스턴스에 도달할 수 있는 IP 주소가 포함된 HOST_IP_ADDRESS 이 값은 이전에 사용하는 연결 방법에 따라 다를 수 있습니다.
    • PORT_NUMBER: 소스 데이터베이스가 수신 연결을 수락하는 포트 번호입니다. 기본 MySQL 포트는 3306입니다.
    • USERNAME: Database Migration Service가 소스 데이터베이스 인스턴스에 연결할 데이터베이스 사용자 계정의 이름입니다.
    • PASSWORD를 데이터베이스 사용자 계정의 비밀번호로 바꿉니다.
    • (선택사항) CONNECTION_PROFILE_NAME: 연결 프로필의 사람이 읽을 수 있는 이름입니다. 이 값은 Google Cloud 콘솔에 표시됩니다.

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

    Linux, macOS 또는 Cloud Shell

    gcloud database-migration connection-profiles \
create mysql CONNECTION_PROFILE_ID \
  --no-async \
  --region=REGION \
  --host=HOST_IP_ADDRESS \
  --port=PORT_NUMBER \
  --username=USERNAME \
  --password=PASSWORD \
  --display-name=CONNECTION_PROFILE_NAME

    Windows(PowerShell)

    gcloud database-migration connection-profiles `
create mysql CONNECTION_PROFILE_ID `
  --no-async `
  --region=REGION `
  --host=HOST_IP_ADDRESS `
  --port=PORT_NUMBER `
  --username=USERNAME `
  --password=PASSWORD `
  --display-name=CONNECTION_PROFILE_NAME

    Windows(cmd.exe)

    gcloud database-migration connection-profiles ^
create mysql CONNECTION_PROFILE_ID ^
  --no-async ^
  --region=REGION ^
  --host=HOST_IP_ADDRESS ^
  --port=PORT_NUMBER ^
  --username=USERNAME ^
  --password=PASSWORD ^
  --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]

3단계: 마이그레이션 작업 구성 및 실행

Percona XtraBackup으로 마이그레이션할 때는 Cloud SQL 대상 인스턴스를 직접 만들거나 Database Migration Service에서 만들도록 할 수 있습니다. 자세한 내용은 마이그레이션 작업 만들기 개요를 참고하세요.

이러한 각 접근 방식에는 약간 다른 절차를 따라야 합니다. 드롭다운 메뉴를 사용하여 시나리오와 관련된 절차를 표시합니다.

  • Database Migration Service에서 대상 데이터베이스를 자동으로 만들도록 하려면 새 대상 인스턴스로 마이그레이션을 선택합니다.
  • Database Migration Service 외부에서 만든 대상 데이터베이스로 마이그레이션하려면 기존 대상 인스턴스로 마이그레이션을 선택합니다.

  • 새 대상 인스턴스로 마이그레이션하면 Database Migration Service가 마이그레이션 작업 생성 흐름 중에 대상 MySQL용 Cloud SQL 인스턴스를 자동으로 만듭니다.

    3a단계. 새 대상 인스턴스로의 마이그레이션 작업 만들기

    새 대상 인스턴스로의 마이그레이션 작업을 만들려면 다음 단계를 따르세요.

    콘솔

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

    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 앱, 기타 서비스와 같이 데이터가 필요한 서비스의 위치에 따라 리전을 선택합니다. 대상 리전을 선택한 후에는 이 선택사항을 변경할 수 없습니다.

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

    소스 연결 프로필 정보 지정

    1. 소스 정의 페이지에서 다음 단계를 수행합니다.
      1. 소스 연결 프로필 드롭다운 메뉴에서 소스 데이터베이스의 연결 프로필을 선택합니다.
      2. 전체 덤프 구성 맞춤설정 섹션에서 구성 수정을 클릭합니다.
      3. 전체 덤프 구성 수정 패널의 전체 덤프 방법 드롭다운 메뉴에서 물리적 기반을 선택합니다.
      4. 폴더 제공에서 찾아보기를 클릭한 다음 전체 덤프 파일을 업로드한 폴더를 선택합니다 (소스 데이터 준비 섹션의 3단계).
      5. 저장을 클릭합니다.
    2. 저장 후 계속을 클릭합니다.

    대상 Cloud SQL 인스턴스 구성 및 만들기

    1. 대상 정의 페이지의 대상 인스턴스 유형 드롭다운 메뉴에서 새 인스턴스를 선택합니다. 관련 설정을 모두 정의합니다.
      1. 대상 인스턴스 ID 필드에 Cloud SQL 인스턴스의 식별자를 입력하거나 자동 생성된 식별자를 사용합니다.

        식별자에 민감한 정보나 개인 식별 정보를 포함하지 마세요. 인스턴스 이름에 프로젝트 ID를 포함하지 않아도 됩니다. 필요한 경우 자동으로 포함됩니다(예: 로그 파일에서).

      2. 비밀번호 필드에 대상 Cloud SQL 인스턴스의 영숫자 비밀번호를 입력합니다. 이는 인스턴스의 root 관리자 계정 비밀번호입니다.

        비밀번호를 직접 입력하거나 생성을 클릭하여 데이터베이스 이전 서비스에서 자동으로 비밀번호를 만들도록 할 수 있습니다.

      3. 데이터베이스 버전 드롭다운 메뉴에서 대상 인스턴스의 데이터베이스 버전을 선택합니다.

        마이너 버전 표시를 클릭하여 모든 마이너 버전을 확인합니다. 교차 버전 이전 지원에 대해 자세히 알아보세요.

      4. 대상 인스턴스의 MySQL용 Cloud SQL 버전을 선택합니다. MySQL용 Cloud SQL Enterprise 버전과 MySQL용 Cloud SQL Enterprise Plus 버전의 두 가지 옵션이 있습니다.

        MySQL용 Cloud SQL 버전에는 다양한 기능, 사용 가능한 머신 유형, 가격이 있습니다. Cloud SQL 문서를 참고하여 요구사항에 적합한 버전을 선택하세요. 자세한 내용은 MySQL용 Cloud SQL 버전 소개를 참고하세요.

      5. 리전 메뉴에는 시작하기 페이지에서 선택한 것과 동일한 리전이 표시됩니다.

        인스턴스를 고가용성으로 구성하는 경우 여러 영역 (고가용성)을 선택합니다. 기본 영역과 보조 영역을 모두 선택할 수 있습니다. 인스턴스를 만드는 동안 보조 영역이 사용되면 다음 조건이 적용됩니다.

        • 기본 영역은 Any로 보조 영역은 Any (different from primary)로 기본 설정됩니다.
        • 기본 영역과 보조 영역을 모두 지정할 경우 서로 다른 영역이어야 합니다.
      6. 연결 섹션에서 대상 인스턴스에 공개 IP 주소를 추가할지 아니면 비공개 IP 주소를 추가할지 선택합니다. 두 유형의 IP 주소를 모두 포함하도록 인스턴스를 구성할 수 있지만 이전에는 하나 이상의 유형이 필요합니다. 다음 중 하나를 선택합니다.
        • VPC 피어링 또는 역방향 SSH 터널을 사용하여 마이그레이션하려면 비공개 IP를 선택합니다.

          • 비공개 IP 연결을 사용 설정하려면 모든 추가 네트워킹 요구사항을 충족해야 합니다.

            전체 비공개 IP 요구사항을 확인하려면 이 섹션을 펼치세요.

            • Service Networking API가 사용 설정되어 있습니다. Google Cloud 콘솔을 사용하여 Service Networking API를 사용 설정할 수 있습니다.
            • servicenetworking.services.addPeering IAM 권한이 있습니다.
            • 프로젝트에 비공개 서비스 액세스를 구성했으며, 이 경우 compute.networkAdmin IAM 역할이 필요합니다.
            • 프로젝트에 이전 네트워크가 아닌 VPC 네트워크 또는 공유 VPC 네트워크가 하나 이상 있습니다.
            • 공유 VPC 네트워크를 사용하는 경우 다음 작업도 수행해야 합니다.
              • 호스트 프로젝트에 Service Networking API를 사용 설정합니다.
              • 호스트 프로젝트에 사용자를 추가합니다.
              • 사용자에게 호스트 프로젝트의 compute.networkAdmin IAM 역할을 부여합니다.
          • 피어링할 연결된 VPC 네트워크를 선택합니다. VPC 피어링을 사용하여 마이그레이션 소스에 연결하려는 경우 인스턴스가 있는 VPC를 선택합니다.
          • 선택한 VPC에 관리 서비스 네트워크가 구성되지 않은 경우 IP 범위를 선택하고 연결을 클릭하거나 자동으로 선택된 IP 범위를 사용하고 할당 및 연결을 클릭할 수 있습니다.
        • IP 허용 목록을 사용하여 인터넷을 통해 이전하려면 공개 IP를 선택합니다.

          원하는 경우 공개 IP에서 승인된 네트워크 필드를 클릭하고 Cloud SQL 인스턴스에 연결할 네트워크 또는 프록시를 승인합니다. 네트워크는 제공한 주소로만 승인됩니다. Cloud SQL 문서의 공개 IP 구성을 참고하세요.

        나중에 마이그레이션 작업 연결을 구성합니다. 사용 가능한 네트워킹 방법에 대해 자세히 알아보려면 연결 구성을 참고하세요.

    2. Cloud SQL 인스턴스의 머신 유형을 선택합니다. 디스크 크기는 소스 데이터베이스 크기 이상이어야 합니다. MySQL 머신 유형에 대해 자세히 알아보세요.
    3. MySQL용 Cloud SQL Enterprise Plus 버전: 대상 데이터베이스에서 데이터 캐시 기능을 사용하려면 데이터 캐시 사용 설정 체크박스를 선택합니다.

      데이터 캐시는 MySQL용 Cloud SQL Enterprise Plus 버전 인스턴스에서 사용할 수 있는 선택적 기능으로, 대상 데이터베이스에 고속 로컬 솔리드 스테이트 드라이브를 추가합니다. 이 기능을 사용하면 Cloud SQL에 추가 비용이 발생할 수 있습니다. 데이터 캐시에 대한 자세한 내용은 Cloud SQL 문서의 데이터 캐시 개요를 참고하세요.

    4. Cloud SQL 인스턴스의 스토리지 유형을 지정합니다. 솔리드 스테이트 드라이브 (SSD) 또는 하드 디스크 드라이브 (HDD) 중 하나를 선택할 수 있습니다.
    5. Cloud SQL 인스턴스의 스토리지 용량 (GB)을 지정합니다.

      인스턴스에 소스 데이터베이스의 데이터를 처리할 수 있는 충분한 스토리지 용량이 있는지 확인합니다. 이 용량은 언제든지 늘릴 수 있지만 줄일 수는 없습니다.

    6. (선택사항) 대상 인스턴스의 데이터 암호화 옵션 또는 리소스 라벨을 구성합니다.

      이 섹션을 펼쳐 선택 단계를 확인하세요.

      선택적 구성 표시를 클릭한 다음 다음을 수행합니다.

      1. 소스에서 대상으로 이전되는 데이터의 암호화를 관리할지 지정합니다. 기본적으로 데이터는 Google Cloud에서 관리하는 키로 암호화됩니다. 암호화를 직접 관리하려면 고객 관리 암호화 키 (CMEK)를 사용하면 됩니다. 방법은 다음과 같습니다.

        1. 고객 관리 암호화 키 (CMEK) 사용 체크박스를 선택합니다.
        2. 고객 관리 키 선택 메뉴에서 CMEK를 선택합니다.

        키가 표시되지 않으면 키 리소스 이름 입력을 클릭하여 사용할 키의 리소스 이름을 입력합니다. 키 리소스 이름의 예: projects/my-project-name/locations/my-location/keyRings/my-keyring/cryptoKeys/my-key.

      2. 데이터베이스 서버에 적용할 필수 플래그를 추가합니다. 가능하면 생성된 대상 Cloud SQL 인스턴스의 데이터베이스 플래그가 소스 데이터베이스의 데이터베이스 플래그와 동일한지 확인합니다. MySQL에서 지원되는 데이터베이스 플래그에 대해 자세히 알아보세요.
      3. Cloud SQL 인스턴스와 관련된 라벨을 추가합니다.

        라벨은 인스턴스를 정리하는 데 도움이 됩니다. 예를 들어 비용 센터 또는 환경을 기준으로 라벨을 정리할 수 있습니다. 청구서에도 라벨이 포함되므로 라벨별 비용 분포를 확인할 수 있습니다.

    7. 대상 만들기 및 계속을 클릭합니다. 이제 Database Migration Service에서 Cloud SQL 대상 인스턴스를 만들고 있습니다. 이 프로세스는 몇 분이 소요될 수 있습니다.

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

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

    다음을 사용하려면수행할 작업
    IP 허용 목록 네트워크 연결 방법 대상 인스턴스의 발신 IP 주소를 지정해야 합니다. 만든 Cloud SQL 인스턴스가 고가용성 인스턴스인 경우 기본 인스턴스와 보조 인스턴스의 발신 IP 주소를 모두 포함합니다.
    역방향 SSH 터널 네트워크 연결 메서드 터널을 호스팅할 Compute Engine VM 인스턴스를 선택해야 합니다.

    인스턴스를 지정하면 소스 데이터베이스와 대상 데이터베이스 간의 터널을 설정하는 단계를 실행하는 스크립트가 제공됩니다. Google Cloud CLI에서 스크립트를 실행해야 합니다.

    소스 데이터베이스와 Google Cloud에 모두 연결된 머신에서 명령어를 실행합니다.
    VPC 피어링 네트워크 연결 방법 소스 데이터베이스가 있는 VPC 네트워크를 선택해야 합니다. Cloud SQL 인스턴스가 이 네트워크에 연결되도록 업데이트됩니다.

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

    마이그레이션 작업 만들기

    마이그레이션 작업 테스트 및 만들기에서 마이그레이션 작업의 설정을 확인합니다. 이 시점에서 Cloud SQL 대상 인스턴스와 연결된 서비스 계정에 필요한 권한이 없으므로 마이그레이션 작업 테스트가 실패합니다.

    작업 구성을 확인하기 위해 작업을 테스트하기 전에 다음 작업 중 하나를 실행합니다.

    • 대상 인스턴스 서비스 계정에 권한을 할당한 후 Google Cloud 콘솔을 사용하여 이전 작업을 테스트하려면 저장하고 종료를 클릭합니다. 이 작업을 수행하면 마이그레이션 작업이 초안으로 저장됩니다. 나중에 이 화면으로 돌아와서 이전 작업을 테스트하고 실행할 수 있습니다.
    • 대상 인스턴스 서비스 계정에 권한을 할당한 후 Google Cloud CLI를 사용하여 이전 작업을 테스트하려면 만들기를 클릭합니다. Google Cloud CLI를 사용하면 생성되었지만 아직 시작되지 않은 이전 작업을 테스트할 수 있습니다.

    gcloud

    1. 대상 연결 프로필을 만듭니다.
      Google Cloud CLI를 사용하여 새 대상 인스턴스로 이전하면 단일 작업으로 대상 인스턴스와 연결 프로필이 생성됩니다.
      다음 명령어를 실행합니다 (링크를 클릭하여 펼치기).

      gcloud database-migration connection-profiles create cloudsql

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

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

      • CONNECTION_PROFILE_ID: 연결 프로필의 기계가 읽을 수 있는 식별자
      • 대상 인스턴스에서 사용할 MySQL 버전을 포함하는 DATABASE_VERSION. 데이터베이스 버전은 메이저 버전과 마이너 버전이 모두 포함된 문자열로 지정됩니다. 예를 들면 MYSQL_8_0, MYSQL_8_0_32, MYSQL_8_0_36입니다.

        가능한 모든 MySQL 버전은 --database-version 플래그 참조를 참고하세요.

      • (선택사항) EDITION 기본적으로 Google Cloud CLI로 만드는 새 인스턴스는 MySQL용 Cloud SQL Enterprise Plus 버전을 사용합니다. MySQL용 Cloud SQL Enterprise Plus 버전을 사용하려면 해당 버전이 지원되는 리전인지 확인하세요. MySQL용 Cloud SQL Enterprise Plus 버전 리전 지원을 참고하세요.

        다음 값 중 하나와 함께 --edition 플래그를 사용하여 버전을 변경할 수 있습니다.

        • MySQL용 Cloud SQL Enterprise Plus 버전의 경우 enterprise-plus
        • MySQL용 Cloud SQL Enterprise 버전의 경우 enterprise
      • TIER을 사용할 Cloud SQL 머신 유형의 이름으로 바꿉니다. 머신 유형은 Cloud SQL 규칙을 따르는 문자열(예: db-n1-standard-1, db-perf-optimized-N-2)로 지정됩니다. Google Cloud CLI와 함께 사용할 수 있는 머신 유형 및 식별자의 전체 목록은 MySQL용 Cloud SQL 문서의 머신 유형을 참고하세요.

        Google Cloud CLI로 만든 인스턴스는 기본적으로 다양한 머신 유형을 사용할 수 있는 MySQL용 Cloud SQL Enterprise Plus 버전을 사용합니다. MySQL용 Cloud SQL Enterprise 버전에서만 사용할 수 있는 머신 유형을 사용하려면 선택적 --edition=enterprise 플래그를 사용하여 버전을 지정합니다.

      • REGION을 연결 프로필을 저장하려는 리전의 식별자로 바꿉니다.

        기본적으로 Google Cloud CLI로 만드는 새 인스턴스는 MySQL용 Cloud SQL Enterprise Plus 버전을 사용합니다. MySQL용 Cloud SQL Enterprise Plus 버전을 사용하려면 해당 버전이 지원되는 리전인지 확인하세요. MySQL용 Cloud SQL Enterprise Plus 버전 리전 지원을 참고하세요. 선택적 --edition 플래그를 사용하여 버전을 변경할 수 있습니다.

      • (선택사항) CONNECTION_PROFILE_NAME: 연결 프로필의 사람이 읽을 수 있는 이름입니다. 이 값은 Google Cloud 콘솔에 표시됩니다.
      • 네트워킹 구성

        기본적으로 Google Cloud CLI로 만드는 새 인스턴스에는 공개 IP 주소가 할당되고 공개 IP 연결을 사용하도록 구성됩니다. 다른 연결 방법을 사용할 수 있습니다. 자세한 내용은 연결 구성을 참고하세요.

        공개 IP 연결을 사용하려면 추가 플래그를 사용할 필요가 없습니다. VPC 네트워크 피어링 또는 역방향 SSH 터널과 함께 비공개 IP 연결을 사용하려면 비공개 IP 연결을 사용 설정하기 위한 다음과 같은 추가 네트워크 요구사항을 충족하고 명령어에 추가 플래그를 포함해야 합니다.

        전체 비공개 IP 요구사항을 확인하려면 이 섹션을 펼치세요.

        • Service Networking API가 사용 설정되어 있습니다. Google Cloud 콘솔을 사용하여 Service Networking API를 사용 설정할 수 있습니다.
        • servicenetworking.services.addPeering IAM 권한이 있습니다.
        • 프로젝트에 비공개 서비스 액세스를 구성했으며, 이 경우 compute.networkAdmin IAM 역할이 필요합니다.
        • 프로젝트에 이전 네트워크가 아닌 VPC 네트워크 또는 공유 VPC 네트워크가 하나 이상 있습니다.
        • 공유 VPC 네트워크를 사용하는 경우 다음 작업도 수행해야 합니다.
          • 호스트 프로젝트에 Service Networking API를 사용 설정합니다.
          • 호스트 프로젝트에 사용자를 추가합니다.
          • 사용자에게 호스트 프로젝트의 compute.networkAdmin IAM 역할을 부여합니다.

        비공개 IP 연결(VPC 네트워크 피어링 사용 또는 Compute Engine VM의 역방향 SSH 터널 사용)을 사용하려면 다음 플래그를 추가로 포함합니다.

        • --no-enable-ip-v4: (선택사항) 대상 인스턴스에 공개 IP 주소를 할당하지 않습니다. 대상 인스턴스에 공개 IP 주소와 비공개 IP 주소를 모두 할당할 수 있지만 비공개 IP 연결을 사용하는 경우 공개 IP 주소가 필요하지 않을 수 있습니다.
        • --private-network: 대상 인스턴스에 비공개 IP 주소를 할당하려면 비공개 IP 주소를 할당할 Virtual Private Cloud의 이름을 지정합니다.

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

      Linux, macOS 또는 Cloud Shell

      gcloud database-migration connection-profiles \
create mysql CONNECTION_PROFILE_ID \
  --no-async \
  --region=REGION \
  --database-version=DATABASE_VERSION \
  --tier=TIER \
  --display-name=CONNECTION_PROFILE_NAME

      Windows(PowerShell)

      gcloud database-migration connection-profiles `
create mysql CONNECTION_PROFILE_ID `
  --no-async `
  --region=REGION `
  --database-version=DATABASE_VERSION `
  --tier=TIER `
  --display-name=CONNECTION_PROFILE_NAME

      Windows(cmd.exe)

      gcloud database-migration connection-profiles ^
create mysql CONNECTION_PROFILE_ID ^
  --no-async ^
  --region=REGION ^
  --database-version=DATABASE_VERSION ^
  --tier=TIER ^
  --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]
    2. 네트워크 구성 설정을 완료합니다.

      사용하려는 네트워크 연결에 따라 이전 작업을 만들기 전에 따라야 할 추가 단계가 있을 수 있습니다.

    3. 마이그레이션 작업을 만듭니다.
      다음 명령어를 실행합니다 (링크를 클릭하여 펼치기).

      gcloud database-migration migration-jobs create

      이 샘플에서는 모든 작업이 동기식으로 실행되도록 선택적 --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을 대상 연결 프로필의 기계 판독식 식별자로 바꿉니다.
      • MIGRATION_JOB_TYPE을 마이그레이션 작업 유형으로 바꿉니다. 허용되는 값은 ONE_TIME 또는 CONTINUOUS 두 가지입니다. 자세한 내용은 마이그레이션 유형을 참고하세요.
      • PATH_TO_THE_FOLDER_IN_STORAGE_BUCKET_WITH_PHYSICAL_BACKUP_FILES Cloud Storage 버킷의 폴더에 저장된 실제 백업 파일의 경로입니다. gs://<bucket_name>/<path_to_backup_file_folder> 형식을 사용합니다.
      • 네트워킹 구성

        VPC 네트워크 피어링 또는 역방향 SSH 터널과 함께 비공개 IP 연결을 사용하는 경우 명령어에 다음 플래그를 추가합니다.

        VPC 네트워크 피어링을 통한 비공개 IP 연결
        --peer-vpc 플래그를 사용하여 피어링할 네트워크의 이름을 지정합니다.
        Compute Engine VM의 역방향 SSH 터널
        다음 플래그를 사용하여 Compute Engine의 네트워킹 세부정보를 제공합니다. --vm-ip, --vm-port, --vpc 선택적 --vm 플래그를 사용하여 VM 이름을 지정할 수도 있습니다.

        사용 예시를 더 보려면 Google Cloud CLI 예시를 참고하세요.

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

      Linux, macOS 또는 Cloud Shell

      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
  --dump-type=PHYSICAL
  --dump-path=PATH_TO_THE_FOLDER_IN_STORAGE_BUCKET_WITH_PHYSICAL_BACKUP_FILES

      Windows(PowerShell)

      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
  --dump-type=PHYSICAL
  --dump-path=PATH_TO_THE_FOLDER_IN_STORAGE_BUCKET_WITH_PHYSICAL_BACKUP_FILES

      Windows(cmd.exe)

      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
  --dump-type=PHYSICAL
  --dump-path=PATH_TO_THE_FOLDER_IN_STORAGE_BUCKET_WITH_PHYSICAL_BACKUP_FILES

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

      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]

    3b단계. Cloud SQL 인스턴스 서비스 계정에 필요한 권한 부여

    새 인스턴스로의 마이그레이션 작업을 만들면 Database Migration Service에서 대상 Cloud SQL 인스턴스도 만듭니다. 이전을 실행하려면 먼저 인스턴스의 서비스 계정에 Cloud Storage 권한을 할당해야 합니다.

    대상 인스턴스와 연결된 서비스 계정에 Cloud Storage 권한을 부여하려면 다음 단계를 따르세요.

    1. Cloud SQL 인스턴스 세부정보 페이지에서 Cloud SQL 인스턴스의 서비스 계정 이메일 주소를 찾습니다. 이 주소는 <project-identifier>@gcp-sa-cloud-sql.iam.gserviceaccount.com 형식을 사용합니다. Cloud SQL 문서의 인스턴스 정보 보기를 참고하세요.
    2. 서비스 계정에 스토리지 객체 뷰어 (roles/storage.objectViewer) IAM 역할을 추가합니다. Identity and Access Management로 액세스 권한을 관리하는 방법에 대한 자세한 내용은 IAM 문서의 프로젝트, 폴더, 조직에 대한 액세스 관리를 참고하세요.

    3c단계. (선택사항) 마이그레이션 작업 테스트

    마이그레이션 작업을 실행하기 전에 테스트 작업을 실행하여 Database Migration Service가 필요한 모든 소스 및 대상 항목에 도달할 수 있는지 확인할 수 있습니다. gcloud CLI를 사용하면 생성되었지만 아직 시작되지 않은 이전 작업을 테스트할 수 있습니다.

    콘솔

    Google Cloud 콘솔에서는 마이그레이션 작업 만들기 마법사에서 만든 초안 마이그레이션 작업만 테스트할 수 있습니다. 작업을 답안으로 저장하지 않고 마법사에서 완전히 만들었다면 Google Cloud CLI를 사용하여야만 테스트를 실행할 수 있습니다.

    초안 이전 작업을 테스트하려면 다음 단계를 따르세요.

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

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

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

      이전 작업 만들기 마법사가 열립니다.

    3. 마이그레이션 작업 테스트 및 만들기 페이지에서 작업 테스트를 클릭합니다. 이제 Database Migration Service가 대상 인스턴스에 필요한 모든 권한이 있고 소스 데이터베이스에 연결할 수 있는지 확인합니다.
    4. 테스트가 완료되면 만들기를 클릭합니다.

      이제 마이그레이션 작업이 생성되었으며 시작할 준비가 되었습니다.

    gcloud

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

    • 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

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

    3d단계. 마이그레이션 작업 시작

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

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

    콘솔

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

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

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

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

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

    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

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


  • 기존 대상 인스턴스로 이전하려면 먼저 대상 인스턴스를 만들고 구성해야 합니다.

    3a단계. 대상 인스턴스 준비

    대상 Cloud SQL 인스턴스를 구성하려면 다음 단계를 따르세요.

    1. MySQL용 Cloud SQL 대상 인스턴스를 만듭니다. 이전 요구사항을 충족하기에 충분한 컴퓨팅 및 메모리 리소스를 사용해야 합니다. Cloud SQL 문서의 인스턴스 만들기를 참고하세요.

      이전에 사용할 연결 방법에 따라 대상 인스턴스에 공개 또는 비공개 IP 주소를 추가해야 할 수 있습니다. 연결 방법에 관한 자세한 내용은 연결 구성을 참고하세요.

    2. 대상 인스턴스와 연결된 서비스 계정에 Cloud Storage 권한을 부여합니다. 대상 인스턴스를 만든 후에 이 계정이 생성됩니다.
      1. Cloud SQL 인스턴스 세부정보 페이지에서 Cloud SQL 인스턴스의 서비스 계정 이메일 주소를 찾습니다. 이 주소는 <project-identifier>@gcp-sa-cloud-sql.iam.gserviceaccount.com 형식을 사용합니다. Cloud SQL 문서의 인스턴스 정보 보기를 참고하세요.
      2. 서비스 계정에 스토리지 객체 뷰어 (roles/storage.objectViewer) IAM 역할을 추가합니다. Identity and Access Management로 액세스 권한을 관리하는 방법에 대한 자세한 내용은 IAM 문서의 프로젝트, 폴더, 조직에 대한 액세스 관리를 참고하세요.
    3. Cloud SQL 인스턴스의 대상 연결 프로필을 만듭니다.

      콘솔

      대상 연결 프로필은 만들지 않아도 됩니다. Google Cloud 콘솔에서 마이그레이션 작업을 만들 때는 대상 인스턴스 식별자를 사용하고 Database Migration Service가 연결 프로필을 자동으로 관리합니다.

      마이그레이션 작업 만들기 및 실행 섹션으로 이동합니다.

      gcloud

      이 샘플에서는 모든 작업이 동기식으로 실행되도록 선택적 --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 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 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 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]

    3b단계. 마이그레이션 작업 만들기 및 실행

    콘솔

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

    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 앱, 기타 서비스와 같이 데이터가 필요한 서비스의 위치에 따라 리전을 선택합니다. 대상 리전을 선택한 후에는 이 선택사항을 변경할 수 없습니다.

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

    소스 연결 프로필 정보 지정

    1. 소스 정의 페이지에서 다음 단계를 수행합니다.
      1. 소스 연결 프로필 드롭다운 메뉴에서 소스 데이터베이스의 연결 프로필을 선택합니다.
      2. 전체 덤프 구성 맞춤설정 섹션에서 구성 수정을 클릭합니다.
      3. 전체 덤프 구성 수정 패널의 전체 덤프 방법 드롭다운 메뉴에서 물리적 기반을 선택합니다.
      4. 폴더 제공에서 찾아보기를 클릭한 다음 전체 덤프 파일을 업로드한 폴더를 선택합니다 (소스 데이터 준비 섹션의 4단계).
      5. 저장을 클릭합니다.
    2. 저장 후 계속을 클릭합니다.

    대상 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에서 전체 덤프를 시작하여 소스 데이터베이스를 잠시 잠급니다.

    gcloud

    이전을 구성하고 실행하려면 다음 단계를 따르세요.

    1. 마이그레이션 작업을 만듭니다.
      다음 명령어를 실행합니다 (링크를 클릭하여 펼치기).

      gcloud database-migration migration-jobs create

      이 샘플에서는 모든 작업이 동기식으로 실행되도록 선택적 --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을 대상 연결 프로필의 기계 판독식 식별자로 바꿉니다.
      • MIGRATION_JOB_TYPE을 마이그레이션 작업 유형으로 바꿉니다. 허용되는 값은 ONE_TIME 또는 CONTINUOUS 두 가지입니다. 자세한 내용은 마이그레이션 유형을 참고하세요.
      • PATH_TO_THE_FOLDER_IN_STORAGE_BUCKET_WITH_PHYSICAL_BACKUP_FILES Cloud Storage 버킷의 폴더에 저장된 실제 백업 파일의 경로입니다. gs://<bucket_name>/<path_to_backup_file_folder> 형식을 사용합니다.
      • 네트워킹 구성

        VPC 네트워크 피어링 또는 역방향 SSH 터널과 함께 비공개 IP 연결을 사용하는 경우 명령어에 다음 플래그를 추가합니다.

        VPC 네트워크 피어링을 통한 비공개 IP 연결
        --peer-vpc 플래그를 사용하여 피어링할 네트워크의 이름을 지정합니다.
        Compute Engine VM의 역방향 SSH 터널
        다음 플래그를 사용하여 Compute Engine의 네트워킹 세부정보를 제공합니다. --vm-ip, --vm-port, --vpc 선택적 --vm 플래그를 사용하여 VM 이름을 지정할 수도 있습니다.

        사용 예시를 더 보려면 Google Cloud CLI 예시를 참고하세요.

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

      Linux, macOS 또는 Cloud Shell

      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
  --dump-type=PHYSICAL
  --dump-path=PATH_TO_THE_FOLDER_IN_STORAGE_BUCKET_WITH_PHYSICAL_BACKUP_FILES

      Windows(PowerShell)

      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
  --dump-type=PHYSICAL
  --dump-path=PATH_TO_THE_FOLDER_IN_STORAGE_BUCKET_WITH_PHYSICAL_BACKUP_FILES

      Windows(cmd.exe)

      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
  --dump-type=PHYSICAL
  --dump-path=PATH_TO_THE_FOLDER_IN_STORAGE_BUCKET_WITH_PHYSICAL_BACKUP_FILES

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

      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]

    2. Cloud SQL 대상 인스턴스를 강등합니다.
      다음 명령어를 실행합니다 (링크를 클릭하여 펼치기).

      gcloud database-migration migration-jobs demote-destination

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

      • MIGRATION_JOB_ID를 이전 작업 식별자로 바꿉니다.

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

      • REGION을 연결 프로필이 저장된 리전의 식별자로 바꿉니다.

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

      Linux, macOS 또는 Cloud Shell

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

      Windows(PowerShell)

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

      Windows(cmd.exe)

      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

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

    3. (선택사항) 마이그레이션 작업 테스트 실행
      Database Migration Service가 필요한 모든 소스 및 대상 항목에 도달할 수 있는지 확인하는 검사를 실행할 수 있습니다. 다음 명령어를 실행합니다 (링크를 클릭하여 펼치기).

      gcloud database-migration migration-jobs verify

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

      • 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

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

    4. 마이그레이션 작업을 시작합니다.
      다음 명령어를 실행합니다 (링크를 클릭하여 펼치기).

      gcloud database-migration migration-jobs start

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

      • 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

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

      마이그레이션 작업을 시작하면 대상 Cloud SQL 인스턴스가 읽기 전용 모드로 전환되며 이 모드에서는 Database Migration Service에서 완전히 관리합니다. 데이터가 완전히 마이그레이션되면 독립형 인스턴스로 승격할 수 있습니다.

      참고: Database Migration Service 관찰 가능성 기능을 사용하여 대상 인스턴스 상태와 마이그레이션 진행 상황을 모니터링할 수 있습니다. [마이그레이션 작업 측정항목](/database-migration/docs/mysql/migration-job-metrics)을 참고하세요.

4단계: (선택사항) 이전 중지

데이터 마이그레이션 프로세스를 취소하려면 언제든지 마이그레이션 작업을 중지하고 삭제할 수 있습니다. Google Cloud 콘솔 또는 Google Cloud CLI에서 이전 작업을 관리할 수 있습니다.

5단계: 이전 완료

마이그레이션 작업이 완료되면 다음 단계 중 하나를 실행하여 마이그레이션 작업을 완료합니다.

  • 일회성 이전: 이전 작업 상태가 완료로 변경됩니다. 더 이상 조치를 취하지 않아도 됩니다. 마이그레이션 작업 및 연결 프로필 리소스를 정리할 수 있습니다.

  • 연속 마이그레이션: 마이그레이션 작업을 승격하여 애플리케이션을 새 데이터베이스 인스턴스로 전환합니다.