자습서: 마이그레이션 서비스 미리 보기를 사용하여 Azure VM 또는 온-프레미스 PostgreSQL 서버에서 Azure Database for PostgreSQL로 온라인 마이그레이션

이 문서에서는 Azure Portal을 사용하여 PostgreSQL 데이터베이스를 Azure VM 또는 온-프레미스 PostgreSQL 서버에서 Azure Database for PostgreSQL로 마이그레이션하는 방법을 안내합니다. Azure Portal을 사용하면 데이터베이스 마이그레이션을 포함한 다양한 작업을 수행할 수 있습니다. 이 자습서에 설명된 단계에 따라 데이터베이스를 Azure로 원활하게 전송하고 Azure의 강력한 기능과 확장성을 활용할 수 있습니다.

마이그레이션 태스크 구성

마이그레이션 서비스는 Azure Portal에서 간단한 마법사 기반 환경과 함께 제공됩니다. 시작하는 방법은 다음과 같습니다.

1. 웹 브라우저를 열고 포털로 이동합니다. 자격 증명을 입력하여 로그인합니다. 기본 보기는 서비스 대시보드입니다.

2. Azure Database for PostgreSQL 유연한 서버 대상으로 이동합니다.

3. 유연한 서버 개요 탭의 왼쪽 메뉴에서 마이그레이션까지 아래로 스크롤하여 선택합니다.

   

4. 만들기 단추를 선택하여 Azure VM(가상 머신) 또는 온-프레미스 PostgreSQL 서버에서 유연한 서버로 마이그레이션합니다. 마이그레이션 서비스를 처음 사용하는 경우 첫 번째 마이그레이션을 시작하라는 메시지와 함께 빈 표가 나타납니다.

   

   유연한 서버 대상으로 마이그레이션을 이미 만든 경우 그리드에 마이그레이션 시도에 대한 정보가 포함됩니다.

5. 만들기 단추를 선택합니다. 그런 다음 마법사 기반 일련의 탭을 통해 PostgreSQL 원본 서버에서 이 유연한 서버 대상으로 마이그레이션을 만듭니다.

설정

첫 번째 탭은 사용자가 마이그레이션 이름 및 원본 유형과 같은 마이그레이션 세부 정보를 제공하여 마이그레이션을 시작하는 설정 탭입니다.

• 마이그레이션 이름은 이 유연한 서버 대상으로의 각 마이그레이션에 대한 고유 식별자입니다. 이 필드는 영숫자 문자만 허용하며 특수 문자는 허용하지 않습니다(하이픈(-) 제외). 이름은 하이픈으로 시작할 수 없으며 대상 서버에 대해 고유해야 합니다. 동일한 유연한 서버 대상으로의 두 마이그레이션은 동일한 이름을 가질 수 없습니다.

• 원본 서버 유형 — PostgreSQL 원본에 따라 Azure VM 혹은 온-프레미스를 선택할 수 있습니다.

• 마이그레이션 옵션 - 마이그레이션을 시작하기 전에 유효성 검사를 수행할 수 있습니다. 다음 옵션 중에서 선택할 수 있습니다.

  • 유효성 검사 - 대상으로 마이그레이션하기 위한 서버 및 데이터베이스 준비 상태의 유효성을 검사합니다.
  • 마이그레이션 - 유효성 검사를 건너뛰고 마이그레이션을 시작합니다.
  • 유효성 검사 및 마이그레이션—마이그레이션을 트리거하기 전에 유효성 검사를 수행합니다. 유효성 검사 실패가 없는 경우에만 마이그레이션이 트리거됩니다.

마이그레이션을 실행하기 전에 마이그레이션 전 유효성 검사를 수행할 때는 항상 유효성 검사 또는 유효성 검사 및 마이그레이션 옵션을 선택하는 것이 좋습니다. 마이그레이션 전 유효성 검사에 대해 자세히 알아보려면 이 설명서를 참조하세요.

마이그레이션 모드는 마이그레이션 모드를 선택할 수 있도록 합니다. 오프라인이 기본 옵션입니다.

다음: 원본에 연결 단추를 선택합니다.

런타임 서버

마이그레이션 런타임 서버는 마이그레이션 중에 중간 서버 역할을 하도록 설계된 Azure Database for PostgreSQL의 마이그레이션 서비스 내의 특수 기능입니다. 대상 서버는 아니지만 개인 네트워크를 통해서만 액세스할 수 있는 원본 환경에서 데이터베이스를 쉽게 마이그레이션하는 데 사용되는 별도의 Azure Database for PostgreSQL - 유연한 서버 인스턴스입니다.

런타임 서버에 대한 자세한 내용을 보려면 마이그레이션 런타임 서버를 참조하세요.

원본에 연결

원본에 연결 탭에는 데이터베이스 원본인 설정 탭에서 선택한 원본과 관련된 세부 정보를 제공하라는 메시지가 표시됩니다.

• 서버 이름 - 원본 PostgreSQL 인스턴스의 호스트 이름 또는 IP 주소를 제공합니다.
• 포트 - 원본 서버의 포트 번호
• 서버 관리자 로그인 이름 - 원본 PostgreSQL 서버의 사용자 이름
• 암호 - 원본 PostgreSQL 서버의 암호
• SSL 모드 - 지원되는 값이 기본 설정되고 필수입니다. 원본 PostgreSQL 서버의 SSL이 OFF인 경우 SSLMODE=prefer를 사용합니다. 원본 서버의 SSL이 ON인 경우 SSLMODE=require를 사용합니다. SSL 값은 postgresql.conf 파일에서 확인할 수 있습니다.
• 연결 테스트 - 대상과 원본 간의 연결 테스트를 수행합니다. 연결이 성공하면 사용자는 다음 단계를 진행할 수 있습니다. 그렇지 않으면 대상과 원본 간의 네트워킹 문제를 식별하고 원본의 사용자 이름/암호를 확인해야 합니다. 연결 테스트는 대상과 원본 간의 연결을 설정하는 데 몇 분 정도 걸립니다.

연결 테스트가 성공적으로 완료되면 다음: 마이그레이션 대상 선택을 선택합니다.

마이그레이션 대상 선택

마이그레이션 대상 선택 탭에는 구독 이름, 리소스 그룹, 서버 이름, 위치, PostgreSQL 버전과 같은 유연한 서버 대상에 대한 메타데이터가 표시됩니다.

• 관리 사용자 이름 - 대상 PostgreSQL 서버의 관리 사용자 이름
• 암호 - 대상 PostgreSQL 서버의 암호
• 연결 테스트 - 대상과 원본 간의 연결 테스트를 수행합니다. 연결이 성공하면 사용자는 다음 단계를 진행할 수 있습니다. 그렇지 않으면 대상과 원본 간의 네트워킹 문제를 식별하고 대상의 사용자 이름/암호를 확인해야 합니다. 연결 테스트는 대상과 원본 간의 연결을 설정하는 데 몇 분 정도 걸립니다.

연결 테스트가 성공적으로 완료되면 다음: 마이그레이션할 데이터베이스 선택을 선택합니다.

마이그레이션할 데이터베이스 선택

이 탭 아래에는 설정 탭에서 선택한 원본 서버 내에 사용자 데이터베이스 목록이 있습니다. 단일 마이그레이션 시도에서 최대 8개의 데이터베이스를 선택하고 마이그레이션할 수 있습니다. 8개 이상의 사용자 데이터베이스가 있는 경우 다음 데이터베이스 집합에 대해 원본 서버와 대상 서버 간에 마이그레이션 프로세스가 반복됩니다.

데이터베이스를 선택한 후 다음: 요약을 선택합니다.

요약

요약 탭에는 유효성 검사 또는 마이그레이션 만들기에 대한 모든 원본 및 대상 세부 정보가 요약되어 있습니다. 세부 사항을 검토하고 시작 단추를 선택합니다.

마이그레이션 모니터링

시작 단추를 선택하면 몇 초 후에 유효성 검사 또는 마이그레이션 만들기가 성공했다는 알림이 나타납니다. 최근에 만든 유효성 검사 또는 마이그레이션에 대한 새 항목이 있는 유연한 서버의 마이그레이션 블레이드로 자동으로 리디렉션됩니다.

마이그레이션을 표시하는 그리드에는 이름, 상태, 마이그레이션 모드, 마이그레이션 형식, 원본 서버, 원본 서버 형식, 데이터베이스, **기간 및 시작 시간 열이 있습니다. 항목은 시작 시간의 내림차순으로 표시되며 가장 최근 항목이 맨 위에 표시됩니다. 새로 고침 단추를 사용하여 유효성 검사 또는 마이그레이션 상태를 새로 고칠 수 있습니다. 관련 세부 정보를 보려면 그리드에서 마이그레이션 이름을 선택합니다.

유효성 검사 또는 마이그레이션이 만들어질 때 InProgress 상태 및 PerformingPreRequisiteSteps 하위 상태로 이동합니다. 워크플로는 마이그레이션 인프라 및 네트워크 연결을 설정하는 데 2~3분이 걸립니다.

마이그레이션 세부 정보

설정 탭에서 마이그레이션 옵션으로 마이그레이션 및 유효성 검사를 선택했습니다. 이 시나리오에서는 마이그레이션이 시작되기 전에 먼저 유효성 검사가 수행됩니다. PerformingPreRequisiteSteps 하위 상태가 완료된 후 워크플로는 유효성 검사 진행 중 하위 상태로 이동합니다.

• 유효성 검사에 오류가 있으면 마이그레이션이 실패 상태로 전환됩니다.
• 유효성 검사가 오류 없이 완료되면 마이그레이션이 시작되고 워크플로는 데이터 마이그레이션의 기반으로 이동합니다.

유효성 검사 결과는 유효성 검사 탭 아래에 표시되며 마이그레이션은 마이그레이션 탭에서 모니터링됩니다.

가능한 마이그레이션 상태는 다음과 같습니다.

마이그레이션 상태

마이그레이션 하위 상태

유효성 검사 하위 상태

중단

마이그레이션과 유효성 검사 및 마이그레이션이 모두 있는 경우 온라인 마이그레이션을 완료하려면 또 다른 단계가 필요합니다. 즉, 사용자의 컷오버 작업이 필요합니다. 기본 데이터의 복사/복제가 완료된 후 마이그레이션은 WaitingForUserAction 상태 및 `WaitingForCutoverTrigger' 하위 상태로 이동합니다. 이 상태에서 사용자는 마이그레이션을 선택하여 포털에서 컷오버를 트리거할 수 있습니다.

컷오버를 시작하기 전에 다음을 확인해야 합니다.

• 원본에 대한 쓰기가 중지되었습니다. Latency 값이 0이거나 0에 가깝습니다. Latency 정보는 아래와 같이 마이그레이션 세부 정보 화면에서 가져올 수 있습니다.
• latency 값이 0으로 감소하거나 0과 가까움
• latency 값은 대상이 원본과 마지막으로 동기화된 시간을 나타냅니다. 이 시점에서 원본에 대한 쓰기가 중지되고 컷오버가 시작될 수 있습니다. 원본에 트래픽이 많은 경우 먼저 쓰기를 중지하여 Latency가 0에 가까워진 다음 컷오버가 시작되도록 하는 것이 좋습니다.

컷오버 작업은 원본에서 대상으로 보류 중인 모든 변경 내용을 적용하고 마이그레이션을 완료합니다. 0이 아닌 Latency,(을)를 사용해도 "컷오버"를 트리거하면 해당 시점까지 복제가 중지됩니다. 컷오버 지점까지 원본의 모든 데이터가 대상에 적용됩니다. 컷오버 지점에서 15분의 대기 시간이 발생하는 경우 지난 15분 동안 변경된 모든 데이터가 대상에 적용됩니다. 시간은 지난 15분 동안 발생한 변경 내용의 백로그에 따라 달라집니다. 따라서 컷오버를 트리거하기 전에 대기 시간을 0 또는 0에 가깝게 만드는 것이 좋습니다.

• Migrating Data 하위 상태 또는 컷오버(온라인 마이그레이션에서)가 성공적으로 완료되면 마이그레이션이 Succeeded 상태로 이동합니다. Migrating Data 하위 상태에 문제가 있는 경우 마이그레이션은 Failed 상태로 전환됩니다.

마이그레이션 취소

진행 중인 유효성 검사이나 마이그레이션을 취소할 수 있습니다. 취소하려면 워크플로가 InProgress 상태여야 합니다. 성공 또는 실패 상태에서는 유효성 검사나 마이그레이션을 취소할 수 없습니다.

유효성 검사를 취소하면 추가 유효성 검사 작업이 중지되고 유효성 검사가 취소됨 상태로 전환됩니다.

마이그레이션을 취소하면 대상 서버에서 추가 마이그레이션 작업이 중지되고 취소됨 상태로 전환됩니다. 대상 서버의 변경 내용을 삭제하거나 롤백하지 않습니다. 취소된 마이그레이션과 관련된 대상 서버에서 데이터베이스를 삭제해야 합니다.

이 문서에서는 Azure CLI를 사용하여 PostgreSQL 데이터베이스를 Azure 가상 머신 또는 온-프레미스 PostgreSQL 인스턴스에서 Azure Database for PostgreSQL로 마이그레이션하는 방법을 살펴봅니다. Azure CLI는 데이터베이스 마이그레이션을 포함한 다양한 작업을 수행할 수 있는 강력하고 유연한 명령줄 인터페이스를 제공합니다. 이 문서에 설명된 단계에 따라 데이터베이스를 Azure로 원활하게 전송하고 Azure의 강력한 기능과 확장성을 활용할 수 있습니다.

마이그레이션 서비스를 사용하는 Azure CLI에 대해 자세히 알아보려면 마이그레이션 서비스용 Azure CLI를 설정하는 방법을 참조하세요.

CLI가 설치되면 명령 프롬프트를 열고 아래 명령을 사용하여 Azure 계정에 로그인합니다.

az login

마이그레이션 태스크 구성

마이그레이션을 시작하려면 마이그레이션 세부 정보가 포함된 JSON 파일을 만듭니다. JSON 파일에는 다음 정보가 포함되어 있습니다.

• JSON 줄에서 아래 자리 표시자 << >>을 편집하고 CLI가 호출되는 로컬 컴퓨터에 <<filename>>.json으로 저장합니다. 이 자습서에서는 C:\migration-CLI\migration_body.json에 파일을 저장했습니다.

{
"properties": {
"SourceDBServerResourceId": "<<source hostname or IP address>>:<<port>>@<<username>>",
        "SecretParameters": {
            "AdminCredentials": {
                "SourceServerPassword": "<<Source Password>>",
                "TargetServerPassword": "<<Target Password>>"
            },
			"targetServerUserName": "<<Target username>>"
        },
        "DBsToMigrate": "<<comma separated list of databases in a array like - ["ticketdb","timedb","inventorydb"]>>",
        "OverwriteDBsInTarget": "true",
        "sourceType": "OnPremises",
        "sslMode": "Prefer"
    }
}

• 다음 명령을 실행하여 마이그레이션이 실행 중인지 확인합니다. 마이그레이션 이름은 Azure Database for PostgreSQL 유연한 서버 대상 내의 마이그레이션 전체에서 고유합니다.

  az postgres flexible-server migration list --subscription 11111111-1111-1111-1111-111111111111 --resource-group my-learning-rg --name myflexibleserver --filter All
  

• 위 단계에서는 수행된 마이그레이션이 없으므로 다음 명령을 실행하여 새 마이그레이션을 시작합니다.

  az postgres flexible-server migration create --subscription 11111111-1111-1111-1111-111111111111 --resource-group my-learning-rg --name myflexibleserver --migration-name migration1 --migration-mode online --migration-option ValidateAndMigrate --properties "C:\migration-cli\migration_body.json"
  

• 다음 명령을 실행하여 마이그레이션 단계의 마이그레이션 상태를 시작합니다. 마이그레이션 이름을 제공하여 마이그레이션 상태를 확인할 수 있습니다.

  az postgres flexible-server migration show --subscription 11111111-1111-1111-1111-111111111111 --resource-group my-learning-rg --name myflexibleserver --migration-name migration1
  

• 마이그레이션 진행 상태는 Azure CLI에 표시됩니다.

• Azure Portal에서 Azure Database for PostgreSQL 유연한 서버의 상태를 확인할 수도 있습니다.

• cancel 명령을 사용하여 진행 중인 마이그레이션 시도를 취소할 수 있습니다. 이 명령은 특정 마이그레이션 시도를 중지하고 대상 서버의 모든 변경 내용을 롤백합니다. 다음은 마이그레이션을 삭제하는 CLI 명령입니다.

  az postgres flexible-server migration update cancel --subscription 11111111-1111-1111-1111-111111111111 --resource-group my-learning-rg --name myflexibleserver --migration-name migration1
  

중단

• 온라인 마이그레이션에서 기본 데이터 마이그레이션이 완료된 후 마이그레이션 작업은 WaitingForCutoverTrigger 하위 상태로 이동합니다. 이 상태에서 사용자는 아래 명령을 사용하여 CLI를 통해 컷오버를 트리거할 수 있습니다. 마이그레이션 그리드에서 마이그레이션 이름을 선택하여 포털에서 컷오버를 트리거할 수도 있습니다.

• Azure Portal에서 컷오버를 시작할 수도 있습니다.

  az postgres flexible-server migration update --subscription 11111111-1111-1111-1111-111111111111 --resource-group my-learning-rg --name myflexibleserver --migration-name migration1 --cutover