자습서: 마이그레이션 서비스를 사용하여 Amazon Aurora PostgreSQL에서 Azure Database for PostgreSQL로 오프라인 마이그레이션

Azure Portal은 마이그레이션을 안내하는 간단하고 직관적인 마법사 기반 환경을 제공합니다. 이 자습서에 설명된 단계를 완료하면 데이터베이스를 Azure Database for PostgreSQL - 유연한 서버로 원활하게 전송하고 강력한 기능과 확장성을 활용할 수 있습니다.

Azure Portal을 사용하여 마이그레이션하려면 먼저 마이그레이션 작업을 구성합니다. 그런 다음 원본 및 대상에 연결하고 마이그레이션을 시작합니다.

마이그레이션 태스크 구성

Azure Portal에서 마이그레이션 작업을 구성하려면 다음을 수행합니다.

1. 웹 브라우저를 열고 Azure Portal로 이동합니다. 자격 증명을 입력하여 로그인합니다.

2. Azure Database for PostgreSQL - 유연한 서버의 인스턴스로 이동합니다.

3. 서비스 메뉴에서 마이그레이션을 선택합니다.

   

4. 만들기를 선택하여 Amazon Aurora에서 유연한 서버로 마이그레이션합니다.

   마이그레이션 서비스를 처음 사용하면 첫 번째 마이그레이션을 시작하라는 메시지와 함께 빈 그리드가 나타납니다. 유연한 서버 대상으로의 마이그레이션이 이미 만들어진 경우 그리드에는 마이그레이션 시도에 대한 정보가 포함됩니다.

5. 만들기를 선택하여 일련의 탭을 단계별로 실행하여 마이그레이션을 설정합니다.

   

설정

다음 정보를 입력하거나 선택합니다.

• 마이그레이션 이름: 이 유연한 서버 대상으로 마이그레이션할 때마다 고유 식별자를 입력합니다. 마이그레이션 이름에는 영숫자 문자와 하이픈(-)만 사용할 수 있습니다. 이름은 하이픈으로 시작할 수 없으며 대상 서버에 대해 고유해야 합니다. 동일한 유연한 서버 대상으로의 두 마이그레이션은 동일한 이름을 가질 수 없습니다.

• 원본 서버 유형: 클라우드 기반 PostgreSQL 서비스, 온-프레미스 설정 또는 가상 머신과 같이 PostgreSQL 원본에 해당하는 원본 유형을 선택합니다.

• 마이그레이션 옵션: 마이그레이션 전 유효성 검사에 대해 다음 옵션 중 하나를 선택합니다.

  • 유효성 검사 대상 원본으로 마이그레이션할 서버 및 데이터베이스 준비 상태를 확인합니다.
  • 마이그레이션합니다. 유효성 검사를 건너뛰고 마이그레이션을 시작합니다.
  • 유효성을 검사하고 마이그레이션합니다. 마이그레이션을 트리거하기 전에 유효성 검사를 수행합니다. 유효성 검사 실패가 없으면 마이그레이션이 트리거됩니다.

  마이그레이션 전 유효성 검사에 대해 유효성 검사 또는 유효성 검사 및 마이그레이션 옵션을 선택하는 것이 좋습니다.

  자세한 내용은 미리 배포 유효성 검사를 참조 하세요.

• 마이그레이션 모드: 마이그레이션 모드를 선택합니다. 기본 옵션은 오프라인입니다.

다음을 선택합니다 . 원본에 연결합니다.

런타임 서버 선택

마이그레이션 런타임 서버는 마이그레이션 서비스의 특수한 기능입니다. 런타임 서버는 마이그레이션 중에 중간 서버 역할을 합니다. 대상 서버가 아닌 Azure Database for PostgreSQL - 유연한 서버의 별도 인스턴스입니다. 런타임 서버는 프라이빗 네트워크를 통해서만 액세스할 수 있는 원본 환경에서 데이터베이스를 쉽게 마이그레이션할 수 있습니다.

자세한 내용은 마이그레이션 런타임 서버를 참조 하세요.

원본에 연결

원본에 연결 탭에서 데이터베이스 원본 에 대해 다음 정보를 입력하거나 선택합니다.

• 서버 이름: 원본 PostgreSQL 인스턴스의 호스트 이름 또는 IP 주소를 입력합니다.
• 포트: 원본 서버의 포트 번호를 입력합니다.
• 서버 관리자 로그인 이름: 원본 PostgreSQL 서버의 사용자 이름을 입력합니다.
• 암호: 원본 PostgreSQL 서버의 암호를 입력합니다.
• SSL 모드: 지원되는 값은 Prefer 및 Require입니다. 원본 PostgreSQL 서버의 SSL(Secure Sockets Layer)이 꺼져 있으면 [선호]를 선택합니다. 원본 서버의 SSL이 켜진 경우 [필요]를 선택합니다. SSL 값은 postgresql.conf 파일에 설정됩니다.
• 연결 테스트: 대상과 원본 간의 연결 테스트를 시작합니다. 연결에 성공하면 다음 단계로 이동하여 대상과 원본 간의 네트워킹 문제를 식별하고 원본의 사용자 이름과 암호를 확인합니다. 연결 테스트를 설정하는 데 몇 분 정도 걸립니다.

테스트 연결이 성공하면 다음을 선택합니다 . 마이그레이션 대상을 선택합니다.

마이그레이션 대상 선택

마이그레이션 대상 선택 탭에서 구독, 리소스 그룹 및 서버 이름 외에도 유연한 서버 대상에 대해 다음 정보를 입력하거나 선택합니다.

• 관리자 사용자 이름: 대상 PostgreSQL 서버의 관리자 사용자 이름입니다.
• 암호: 대상 PostgreSQL 서버의 암호입니다.
• 사용자 지정 FQDN/IP(선택 사항): 사용자 지정 FQDN/IP 필드는 선택 사항이며 대상이 사용자 지정 DNS 서버 뒤에 있거나 사용자 지정 DNS 네임스페이스가 있는 경우 사용할 수 있으므로 특정 FQDN 또는 IP 주소를 통해서만 액세스할 수 있습니다. 예를 들어 사용자 지정 DNS 서버에 DNS 영역이 포함되어 있거나 이 영역에 168.63.129.16대한 쿼리를 전달하여 Azure 공용 또는 프라이빗 DNS 영역에서 postgres.database.azure.com FQDN이 확인되는 경우와 같은 PostgreSQL FQDN과 같은 flexibleserver.postgres.database.azure.comflexibleserver.example.com198.1.0.2항목이 포함될 수 있습니다.
• 연결 테스트: 대상과 원본 간의 연결 테스트를 시작합니다. 연결에 성공하면 다음 단계로 이동하여 대상과 원본 간의 네트워킹 문제를 식별하고 대상 서버의 사용자 이름과 암호를 확인합니다. 연결 테스트를 설정하는 데 몇 분 정도 걸립니다.

테스트 연결이 성공하면 다음을 선택합니다 . 마이그레이션할 데이터베이스를 선택합니다.

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

마이그레이션할 데이터베이스 선택 탭에서 원본 PostgreSQL 서버에서 마이그레이션할 사용자 데이터베이스 목록에서 선택합니다.

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

요약

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

마이그레이션 모니터링

유효성 검사 및 마이그레이션 시작을 선택한 후 몇 초 이내에 유효성 검사 또는 마이그레이션 만들기가 성공했음을 알리는 알림이 나타납니다. 유연한 서버 인스턴스 마이그레이션 창으로 리디렉션됩니다. 상태 항목은 InProgress이고 하위 상태는 PerformingPreRequisiteSteps입니다. 이 워크플로는 마이그레이션 인프라를 설정하고 네트워크 연결을 확인하는 데 2~3분이 걸립니다.

마이그레이션을 표시하는 표에는 다음과 같은 열이 있습니다.

• 이름
• 상태
• 마이그레이션 모드
• 마이그레이션 유형
• 원본 서버
• 원본 서버 유형
• 데이터베이스
• 기간
• 시작 시간

항목은 시작 시간의 내림차순으로 표시되며 가장 최근 항목이 맨 위에 표시됩니다. 메뉴 모음에서 새로 고침을 선택하여 유효성 검사 또는 마이그레이션 실행의 상태를 새로 고칠 수 있습니다.

마이그레이션 세부 정보

마이그레이션 목록에서 마이그레이션 이름을 선택하여 관련 세부 정보를 확인합니다.

설치 탭에서 마이그레이션 옵션 유효성 검사 및 마이그레이션을 선택합니다. 이 시나리오에서는 마이그레이션이 시작되기 전에 유효성 검사가 완료됩니다. PerformingPreRequisiteSteps 하위 상태가 완료되면 워크플로가 진행률 하위 상태의 유효성 검사로 이동합니다.

• 유효성 검사에 오류가 있으면 마이그레이션이 실패 상태로 전환됩니다.

• 오류 없이 유효성 검사가 완료되면 마이그레이션이 시작되고 워크플로가 하위 상태 마이그레이션 데이터로 이동합니다.

인스턴스 수준 및 데이터베이스 수준에서 유효성 검사 세부 정보를 확인할 수 있습니다.

• 인스턴스 수준에서 유효성 검사:

  • Azure Database for PostgreSQL - 유연한 서버 인스턴스의 서버 매개 변수에서 확장이 사용하도록 설정되어 있는지 원본 버전( PostgreSQL version >= 9.5 서버 매개 변수 확인)에 대한 연결 검사와 관련된 유효성 검사를 확인합니다.

• 데이터베이스 수준에서 유효성 검사:

  • Azure Database for PostgreSQL - 유연한 서버에서 확장 및 데이터 정렬 지원과 관련된 개별 데이터베이스의 유효성 검사를 확인합니다.

마이그레이션 세부 정보 창에서 마이그레이션 및 유효성 검사의 현재 상태를 볼 수 있습니다.

다음 표에서는 몇 가지 가능한 마이그레이션 상태 및 하위 상태를 설명합니다.

마이그레이션 상태

마이그레이션 하위 상태

유효성 검사 하위 상태

마이그레이션 취소

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

마이그레이션을 취소하면 대상 서버에서 추가 마이그레이션 작업이 중지되고 마이그레이션 시도가 취소됨 상태로 이동합니다. 취소 작업은 마이그레이션 서비스에서 대상 서버의 모든 변경 내용을 롤백합니다.

이 문서에서는 Azure CLI를 사용하여 PostgreSQL 데이터베이스를 Amazon Aurora에서 Azure Database for PostgreSQL로 마이그레이션하는 방법을 설명합니다. Azure CLI는 데이터베이스 마이그레이션을 비롯한 다양한 작업을 완료하는 데 사용할 수 있는 강력하고 유연한 명령줄 인터페이스입니다.

자세한 내용은 마이그레이션 서비스에 대한 Azure CLI 설정을 참조하세요.

Azure CLI가 설치되면 명령줄에서 다음 명령을 사용하여 Azure 계정에 로그인합니다.

az login

마이그레이션 태스크 구성

1. 마이그레이션을 시작하려면 마이그레이션 세부 정보를 저장할 JSON 파일을 만듭니다. 로컬 컴퓨터에 JSON 파일을 [filename].json 저장합니다. 예를 들어 파일을 C:\migration-CLI\migration_body.json 저장할 수 있습니다.

   다음 JSON을 복사하여 JSON 파일에 붙여넣습니다. 시나리오의 관련 정보로 대체 <placeholders> 합니다.

   {
   "properties": {
   "SourceDBServerResourceId": "<source host name or IP address>:<port>@<username>",
           "SecretParameters": {
               "AdminCredentials": {
                   "SourceServerPassword": "<source password>",
                   "TargetServerPassword": "<target password>"
               },
               "targetServerUserName": "<target username>"
           },
           "DBsToMigrate": "<a comma-separated list of databases in an array, similar to the example "ticketdb","timedb","inventorydb">",
           "OverwriteDBsInTarget": "true",
           "sourceType": "AWS_AURORA",
           "sslMode": "Require"
       }
   }
   

2. 다음 명령을 실행하여 마이그레이션이 실행 중인지 확인합니다. 마이그레이션 이름은 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
   

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

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

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

   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 명령을 사용하여 진행 중인 마이그레이션 시도를 취소할 수 있습니다. 이 명령은 특정 마이그레이션 시도를 중지하고 대상 서버의 모든 변경 내용을 롤백합니다.

마이그레이션을 삭제하는 Azure CLI 명령은 다음과 같습니다.

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