새 대상 클러스터로의 마이그레이션 작업 만들기

Database Migration Service를 사용하여 PostgreSQL용 대상 AlloyDB 클러스터를 만들면 해당 클러스터는 기본 인스턴스가 있는 PostgreSQL용 AlloyDB 클러스터로 프로비저닝됩니다. 마이그레이션 프로세스 중에 특정 작업을 실행하면 마이그레이션 오류가 발생할 수 있습니다. 새 대상 클러스터로 마이그레이션할 때는 다음 운영 고려사항에 유의하세요.

  • 데이터 마이그레이션 시 쓰기 작업 방지: 마이그레이션에 포함된 테이블 또는 데이터베이스의 대상 클러스터에서 쓰기 작업(예: INSERT, UPDATE, DELETE 또는 DDL 스키마 변경)을 수행하지 마세요. 이러한 작업은 소스에서 가져오는 데이터와 복제 충돌을 일으킬 수 있습니다.
  • 데이터베이스 사용자 관리: 표준 psql 명령어를 사용하거나 Google Cloud 콘솔의 PostgreSQL용 AlloyDB를 통해 언제든지 데이터베이스 사용자를 만들고 관리할 수 있습니다. 자세한 내용은 PostgreSQL용 AlloyDB 문서의 데이터베이스 사용자 관리를 참조하세요.

자세한 내용은 알려진 제한사항을 참고하세요.

마이그레이션 작업 만들기에는 다음이 포함됩니다.

  1. 마이그레이션 작업의 설정을 정의합니다.
  2. 소스 데이터베이스에 대해 만든 연결 프로필 (소스 연결 프로필)에 대한 정보 지정
  3. 대상 PostgreSQL용 AlloyDB 클러스터의 설정을 정의하고 클러스터를 만듭니다.
  4. 소스 및 대상 데이터베이스 환경 간의 연결을 설정합니다.
  5. 마이그레이션 작업을 테스트하여 작업에 대해 제공한 연결 정보가 유효한지 확인합니다.

새 대상 클러스터로의 마이그레이션 작업을 만들려면 다음을 수행합니다.

콘솔

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

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

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

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

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

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

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

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

    2. 마이그레이션 작업 ID

      마이그레이션 작업의 기계 가독형 식별자입니다. 이 값은 Database Migration Service Google Cloud CLI 명령어 또는 API를 사용하여 마이그레이션 작업을 수행하는 데 사용됩니다.

    3. 소스 데이터베이스 엔진 목록에서 PostgreSQL을 선택합니다.
    4. 대상 데이터베이스 엔진 목록에서 PostgreSQL용 AlloyDB를 선택합니다.
    5. 마이그레이션 작업을 저장할 리전을 선택합니다.

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

    6. 마이그레이션 작업 유형을 연속 (스냅샷 + 진행 중인 변경사항)으로 지정합니다. PostgreSQL용 AlloyDB 동종 마이그레이션은 지속적 마이그레이션만 지원합니다.
    7. 환경에 대해 생성된 기본 요건을 검토합니다. 소스 데이터베이스가 적절하게 구성되어 있는지 확인합니다. 자세한 내용은 소스 데이터베이스 구성을 참조하세요.
  4. 저장 후 계속을 클릭합니다.

소스 연결 프로필 정보 지정

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

  1. 소스 연결 프로필 드롭다운 메뉴에서 소스 데이터베이스의 연결 프로필을 선택합니다 (또는 연결 프로필 만들기 클릭, 소스 연결 프로필 만들기 참조).
  2. 병렬 처리 구성 맞춤설정 섹션에서 병렬 처리 구성 표시를 클릭합니다.

    초기 전체 덤프 중에 pglogical 확장 프로그램은 테이블 수준에서 데이터를 복제하며, 개별 파티션 테이블, 리프 파티션 또는 기본 키가 없는 테이블을 여러 구독에 분할하지 않습니다. 즉, 향상된 데이터 덤프 동시 로드는 단일 대규모 파티션을 나누지 않은 테이블의 초기 덤프 속도를 높일 수 없습니다. 해당 테이블이 하나의 구독 내에서 복사되기 때문입니다. 자세한 내용은 데이터 덤프 동시 로드 고려사항을 참조하세요.

    데이터 덤프 동시 로드 속도는 소스 데이터베이스에 유도되는 부하량과 관련이 있습니다.

    • 최적(권장): 소스 데이터베이스에 최적의 부하를 가하는 균형 잡힌 성능입니다. Database Migration Service는 데이터베이스당 최대 2개의 구독을 만듭니다(모든 데이터베이스에서 총 최대 2개, 마이그레이션된 데이터베이스당 최소 1개의 구독).
    • 최대: 덤프 속도가 가장 빠르지만 소스 데이터베이스의 부하가 증가할 수 있습니다. Database Migration Service는 데이터베이스당 최대 4개의 구독을 만듭니다(모든 데이터베이스에서 최대 4개, 마이그레이션된 데이터베이스당 최소 1개의 구독).
    • 최소: 소스 데이터베이스에서 가장 낮은 양의 컴퓨팅 리소스를 사용하지만 덤프 처리량이 느릴 수 있습니다. Database Migration Service는 데이터베이스당 구독을 1개 만듭니다.

    조정된 데이터 덤프 동시 로드 설정을 선택하는 경우 소스 데이터베이스에서 max_replication_slots, max_wal_senders, max_worker_processes 매개변수를 늘려야 합니다.

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

PostgreSQL용 대상 AlloyDB 클러스터 구성 및 만들기

이제 마이그레이션 작업을 위한 새 대상 PostgreSQL용 AlloyDB 클러스터를 만듭니다. 클러스터는 PostgreSQL용 AlloyDB의 최상위 리소스입니다. 여기에는 마이그레이션 프로세스 중에 만드는 데이터베이스에 대한 읽기 및 쓰기 액세스를 위한 단일 기본 인스턴스가 포함됩니다.

  1. 대상 정의 페이지의 대상 인스턴스 유형 드롭다운 메뉴에서 새 클러스터를 선택합니다.
  2. 클러스터 유형을 선택합니다. Database Migration Service는 초기 프로비저닝 중에 읽기 풀 없이 리전의 두 개 이상의 영역에서 데이터를 제공할 수 있는 고가용성 PostgreSQL용 AlloyDB 클러스터를 지원합니다.
  3. 계속을 클릭합니다.
  4. 클러스터를 구성합니다.
    1. 클러스터 ID 필드에 PostgreSQL용 AlloyDB 클러스터의 식별자를 입력하거나 자동 생성된 식별자를 사용합니다.

      식별자에 민감한 정보나 개인 식별 정보를 포함하지 마세요. 클러스터 이름에 프로젝트 ID를 포함하지 않아도 됩니다. 필요한 경우 자동으로 포함됩니다.

    2. 비밀번호 필드에 대상 PostgreSQL용 AlloyDB 클러스터의 영숫자 비밀번호를 입력합니다. 이는 클러스터의 postgres 관리자 계정 비밀번호입니다.

      비밀번호를 직접 입력하거나 생성을 클릭하여 Database Migration Service에서 자동으로 비밀번호를 만들도록 할 수 있습니다.

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

      버전 간 이전 지원에 대해 자세히 알아보세요.

    4. 네트워크 필드에서 다음을 수행합니다.
      1. 마이그레이션 연결을 설정할 때 사용할 수 있는 리소스를 정의하는 네트워크 경로를 선택합니다. 클러스터는 비공개 IP 네트워크 경로로 구성됩니다. VPC 피어링을 사용하여 소스 데이터베이스에 연결하려면 소스 데이터베이스가 있는 VPC를 선택합니다.
      2. 네트워크가 비공개 서비스 액세스용으로 구성되지 않은 경우 연결 설정을 클릭하고 연결 구성 마법사를 따릅니다.
      3. 선택한 VPC에 관리형 서비스 네트워크가 구성되지 않은 경우 IP 범위를 선택하고 연결을 클릭하거나 자동으로 선택된 IP 범위를 사용하고 할당 및 연결을 클릭할 수 있습니다.

    5. (선택사항) 대상 클러스터의 데이터 암호화 옵션을 구성합니다.

      이 섹션을 펼쳐 선택적 단계를 확인합니다.

      고급 옵션 표시를 클릭하여 소스에서 대상으로 마이그레이션되는 데이터의 암호화를 관리할지 여부를 지정합니다. 기본적으로 데이터는 Google Cloud에서 관리하는 키로 암호화됩니다.

      암호화를 직접 관리하려면 고객 관리 암호화 키 (CMEK)를 사용하면 됩니다. 키는 PostgreSQL용 AlloyDB 클러스터와 동일한 위치에 있어야 합니다. 예를 들어 us-west1에 있는 클러스터는 us-west1의 키만 사용할 수 있습니다.

      1. 고객 관리 암호화 키 (CMEK) 사용 라디오 버튼을 선택합니다.
      2. 고객 관리 키 선택 메뉴에서 CMEK를 선택합니다.

      키가 표시되지 않으면 키 리소스 이름 입력을 클릭하여 사용할 키의 리소스 이름을 입력합니다. 예를 들어 키 리소스 이름 필드에 projects/my-project-name/locations/my-location/keyRings/my-keyring/cryptoKeys/my-key을 입력한 다음 저장을 클릭합니다.
    6. 계속을 클릭합니다.
  5. 기본 인스턴스를 구성합니다. 기본 인스턴스는 클러스터의 컴퓨팅 용량을 결정하고 읽기 및 쓰기 작업을 지원합니다.
    1. 인스턴스 ID 필드에 기본 인스턴스 ID를 입력합니다.
    2. 기본 인스턴스의 머신 유형을 선택합니다.
    3. IP 허용 목록 연결 방법을 사용하려면 아웃바운드 공개 IP 사용 설정 체크박스를 선택합니다.

    4. (선택사항) 기본 인스턴스의 데이터베이스 플래그를 구성합니다.

      이 섹션을 펼쳐 선택적 단계를 확인합니다.

      고급 옵션 표시를 클릭하여 기본 인스턴스의 데이터베이스 플래그를 설정합니다. 지원되는 플래그에 대한 자세한 내용은 PostgreSQL용 AlloyDB 문서의 데이터베이스 플래그 구성을 참조하세요. 각 플래그에 대해 다음을 수행합니다.

      1. 플래그 추가를 클릭합니다.
      2. 새 데이터베이스 플래그 목록에서 플래그를 선택합니다.
      3. 플래그 값을 입력합니다.
      4. 완료를 클릭합니다.
  6. 저장하고 계속하기를 클릭한 다음 대상 만들고 계속하기를 클릭하여 선택을 확인합니다. Database Migration Service는 PostgreSQL용 AlloyDB 대상 클러스터와 기본 인스턴스를 만듭니다. 이 프로세스는 몇 분이 소요될 수 있습니다.

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

연결 방법 드롭다운 메뉴에서 네트워크 연결 방법을 선택합니다. 이 메서드는 대상 PostgreSQL용 AlloyDB 클러스터가 소스 데이터베이스에 연결하는 방법을 정의합니다. 새 클러스터로 마이그레이션하기 위한 현재 네트워크 연결 방법에는 IP 허용 목록, VPC 피어링, 역방향 SSH 터널, 클라우드 호스팅 VM을 통한 TCP 프록시가 포함됩니다.

사용하려는 항목…수행할 작업
IP 허용 목록 네트워크 연결 방법 대상 클러스터의 기본 인스턴스의 아웃바운드 공개 IP 주소를 모두 복사하여 소스 데이터베이스 서버 및 pg_hba.conf 파일의 네트워크 방화벽을 구성하는 데 사용합니다.
역방향 SSH 터널 네트워크 연결 방법, 터널을 호스팅할 Compute Engine VM 인스턴스를 선택합니다.

인스턴스를 지정하면 Google에서 소스 데이터베이스와 대상 데이터베이스 간에 터널을 설정하는 단계를 수행하는 스크립트를 제공합니다. 소스 데이터베이스와 Google Cloud모두에 연결된 머신에서 Google Cloud CLI로 스크립트를 실행합니다.
VPC 피어링 네트워크 연결 방법 소스 데이터베이스가 있는 VPC 네트워크를 선택합니다. 대상 클러스터는 비공개 서비스 액세스를 사용하여 이 네트워크에 연결합니다.
클라우드 호스팅 VM 연결 방법을 통한 TCP 프록시 TCP 프록시를 호스팅할 새 Compute Engine VM 인스턴스의 필수 세부정보를 입력합니다.

세부정보를 지정하면 Google Cloud 콘솔에서 소스 데이터베이스와 대상 데이터베이스 간에 프록시를 설정하는 스크립트를 제공합니다. 업데이트된 Google Cloud CLI가 있는 머신에서 스크립트를 실행합니다.

스크립트를 실행한 후 새로 만든 VM의 비공개 IP 주소를 입력하고 구성 및 계속을 클릭합니다.

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

마이그레이션 데이터베이스 구성하기

소스 인스턴스에서 모든 데이터베이스를 마이그레이션하거나 특정 데이터베이스만 선택할 수 있습니다.

  1. 마이그레이션할 데이터베이스 목록에서 다음 옵션 중 하나를 선택합니다.
    • 모든 데이터베이스: 소스에 있는 모든 데이터베이스를 선택합니다.
    • 특정 데이터베이스: 소스에 있는 모든 데이터베이스에서 특정 데이터베이스를 선택할 수 있습니다.

  2. 특정 데이터베이스를 마이그레이션하려면 표시되는 목록을 필터링하고 Database Migration Service에서 대상으로 마이그레이션할 데이터베이스를 선택합니다.

    목록이 표시되지 않고 데이터베이스 검색 오류가 표시되면 새로고침을 클릭합니다. 데이터베이스 검색에 실패하면 작업에서 모든 데이터베이스를 마이그레이션합니다. 마이그레이션 작업 만들기를 계속하고 나중에 연결 오류를 수정할 수 있습니다.

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

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

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

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

    테스트에 실패하면 흐름의 적절한 부분에서 문제를 해결한 후 다시 테스트할 수 있습니다. 실패한 마이그레이션 작업 테스트 문제 해결에 대한 자세한 내용은 PostgreSQL용 AlloyDB 문제 진단을 참조하세요.

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

    작업이 생성될 때 시작되지 않으면 마이그레이션 작업 페이지에서 시작을 클릭하여 시작할 수 있습니다. 마이그레이션 작업이 시작되는 시점과 관계없이 대상 클러스터가 존재하면 조직에 요금이 청구됩니다.

    마이그레이션 작업을 시작하면 Database Migration Service가 초기 전체 덤프 및 연속 복제를 시작합니다. 자세한 내용은 알려진 제한사항을 참고하세요.

  3. 마이그레이션 작업 검토로 진행합니다.

Google Cloud CLI

  1. 대상 연결 프로필을 만듭니다.
    Google Cloud CLI를 사용하여 새 대상 클러스터로 마이그레이션할 때 단일 작업으로 대상 클러스터와 연결 프로필을 만듭니다.
    다음 명령어를 실행합니다 (링크를 클릭하여 펼치기).

    gcloud database-migration connection-profiles create alloydb

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

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

    • DEST_CONN_ID를 대상 연결 프로필 식별자로 바꿉니다.
    • REGION: 연결 프로필을 저장하고 대상 클러스터를 만들려는 리전입니다.
    • DEST_PASSWORD: 대상 PostgreSQL용 AlloyDB 클러스터에 있는 postgres 사용자의 초기 비밀번호입니다.
    • PRIMARY_ID: 대상 PostgreSQL용 AlloyDB 클러스터의 기본 인스턴스 ID
    • CPU_COUNT을 기본 인스턴스의 vCPU 수로 바꿉니다 (예: 2, 4, 8).
    • VPC_NETWORK을 비공개 서비스 액세스용으로 구성된 가상 프라이빗 클라우드 네트워크의 이름 또는 전체 리소스 URI로 바꿉니다.
    • 선택사항: 새 대상 PostgreSQL용 AlloyDB 클러스터 및 기본 인스턴스에 대한 추가 설정을 구성하려면 다음 플래그를 전달하면 됩니다.
      • --enable-outbound-public-ip: 기본 인스턴스에서 아웃바운드 공개 IP를 사용 설정합니다 (IP 허용 목록 연결을 사용하는 경우 필요).
      • --kms-key, --kms-keyring, --kms-project: 고객 관리 암호화 키 (CMEK)로 대상 클러스터를 암호화합니다.
      • --database-version: 대상 클러스터의 PostgreSQL 메이저 버전을 지정합니다 (예: POSTGRES_15).
      • --database-flags: 대상 기본 인스턴스의 데이터베이스 플래그 (KEY=VALUE)를 쉼표로 구분된 목록으로 지정합니다.

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

    Linux, macOS 또는 Cloud Shell

    gcloud database-migration connection-profiles create alloydb DEST_CONN_ID \
  --region=REGION \
  --password=DEST_PASSWORD \
  --primary-id=PRIMARY_ID \
  --cpu-count=CPU_COUNT \
  --network=VPC_NETWORK \
  --no-async

    Windows(PowerShell)

    gcloud database-migration connection-profiles create alloydb DEST_CONN_ID `
  --region=REGION `
  --password=DEST_PASSWORD `
  --primary-id=PRIMARY_ID `
  --cpu-count=CPU_COUNT `
  --network=VPC_NETWORK `
  --no-async

    Windows(cmd.exe)

    gcloud database-migration connection-profiles create alloydb DEST_CONN_ID ^
  --region=REGION ^
  --password=DEST_PASSWORD ^
  --primary-id=PRIMARY_ID ^
  --cpu-count=CPU_COUNT ^
  --network=VPC_NETWORK ^
  --no-async

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

    Waiting for connection profile [DEST_CONN_ID]
to be created with [OPERATION_ID]

Waiting for operation [OPERATION_ID] to complete...done.

Created connection profile DEST_CONN_ID [OPERATION_ID]

  2. 마이그레이션 작업을 만듭니다.
    IP 허용 목록, VPC 피어링 또는 역방향 SSH 터널 연결을 사용하는 경우 --static-ip, --peer-vpc 또는 --vm, --vm-ip, --vm-port, --vpc와 같은 필수 플래그를 추가해야 합니다. 자세한 내용은 연결 구성 및 Google Cloud CLI 예시를 참조하세요.
    다음 명령어를 실행합니다 (링크를 클릭하여 펼치기).

    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: 대상 연결 프로필의 기계 가독형 식별자

    • 선택사항: Database Migration Service는 기본적으로 소스의 모든 데이터베이스를 마이그레이션합니다. 특정 데이터베이스만 마이그레이션하려면 --databases-filter 플래그를 사용하고 식별자를 쉼표로 구분된 목록으로 지정합니다.

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

      나중에 gcloud database-migration migration-jobs update 명령어를 사용하여 --databases-filter 플래그로 만든 마이그레이션 작업을 수정할 수 있습니다.

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

    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=CONTINUOUS

    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=CONTINUOUS

    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=CONTINUOUS

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

    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]