Oracle용 데이터베이스 마이그레이션 평가 확장

참고 항목

이 확장은 2024년 12월 15일에 사용 중지됩니다. 발생하는 문제에 대해 이 도구 지원을 중지하고 버그 수정 또는 추가 업데이트를 실행하지 않습니다.

Azure Data Studio의 Oracle용 데이터베이스 마이그레이션 평가 확장은 Azure SQL 및 Azure Database for PostgreSQL로 마이그레이션하기 위해 Oracle 워크로드를 평가하는 데 도움이 됩니다. 확장은 적절한 크기 조정 권장 사항과 마이그레이션이 얼마나 복잡할 수 있는지를 사용하여 적절한 Azure SQL 또는 PostgreSQL 대상을 식별합니다.

필수 조건

• Azure Data Studio 버전 1.39 이상.
• 버전 11g 이상을 실행하는 Oracle 데이터베이스입니다.
• Oracle 사용자에게는 CONNECT 및 SELECT ANY DICTIONARY 권한이 할당되어 있어야 합니다.

Azure Data Studio 확장 설치

이러한 단계에 따라 Azure Data Studio에 Oracle용 데이터베이스 마이그레이션 평가 확장을 설치합니다.

1. Azure Data Studio에서 확장 관리자를 엽니다. 확장 아이콘을 선택하거나 보기 메뉴에서 확장을 선택할 수 있습니다.

2. 검색 창에 Oracle을 입력합니다.

3. Oracle용 데이터베이스 마이그레이션 평가 확장을 선택하고 세부 정보를 봅니다.

4. 설치를 선택합니다.

   

확장 설정 구성

확장을 설치한 후 여러 확장 설정을 구성할 수 있습니다.

1. 확장으로 이동하여 Oracle용 데이터베이스 마이그레이션 평가를 선택하고 설정 관리 아이콘을 선택한 다음, 확장 설정을 선택합니다.

   

2. 확장 설정에서 환경의 요구 사항을 충족하도록 확장 설정을 편집합니다.

   

   참고 항목

   Oracle에서 PostgreSQL로의 코드 평가를 수행하기 위해 Oracle 클라이언트 홈 경로 및 Ora2Pg 설치 경로는 필수 매개 변수입니다.

평가 실행

평가 확장이 설치되면 다음 단계는 Oracle 데이터베이스에 연결하고, Oracle 인스턴스에서 메타데이터 정보를 수집하고, 평가 보고서를 생성하는 것입니다.

1. 메뉴 모음의 연결 아이콘으로 이동합니다.

   

2. 연결 세부 정보에서 필드를 입력합니다.

   1. 연결 유형 필드에서 Oracle을 선택합니다.
   2. 데이터 원본 필드에 Oracle 서버 이름 및 인스턴스를 입력합니다.
      1. TNS 이름도 제공할 수 있습니다. (ORACLE_HOME 환경 변수가 설정되어 있고 TNSNAMES.ORA 파일이 <ORACLE_HOME>/network/admin folder에 있는지 확인합니다.)
      2. 컨테이너 데이터베이스의 경우 CDB 서비스 ID를 사용하여 컨테이너 루트 데이터베이스에 연결하거나 플러그형 데이터베이스 서비스 이름을 사용하여 플러그형 데이터베이스에 연결할 수 있습니다.
   3. 사용자 ID 필드에 데이터베이스 사용자 이름을 제공합니다.
   4. 암호 필드에 데이터베이스 암호를 제공합니다.

   

3. 연결을 선택합니다.

4. 이제 연결 세부 정보 메뉴에 새 연결이 나타납니다.

5. Oracle 연결을 마우스 오른쪽 단추로 클릭하고 관리를 선택합니다.

   

6. 마이그레이션 평가를 선택합니다.

   

7. 새 평가 실행을 선택합니다.

   

8. 평가 세부 정보를 제공합니다.

   1. 평가 이름 필드에 제목(예: demo1)을 입력합니다.
   2. 평가 설정을 입력합니다.

      1. 대상 플랫폼 필드에 대상 마이그레이션 데이터베이스를 입력합니다. 현재, Azure SQL 및 PostgreSQL이 대상으로 지원됩니다.

         참고 항목

         PostgreSQL 대상은 프리뷰로 제공됩니다. 이 대상 옵션은 중단될 예정입니다. 이전 평가를 내보내야 합니다.

      2. 성능 데이터 수집 섹션에서 Oracle 데이터베이스에서 성능 데이터 수집 실행(연결됨) 또는 AWR 보고서 추가를 선택합니다.

         최대 부하 또는 실제 로드 중에 이 도구를 실행하는 경우 연결된 옵션을 사용하는 것이 좋습니다. 그렇지 않으면 성능 및 크기 조정 권장 사항에 대해 이전에 생성된 AWR 보고서를 제공합니다.

         참고 항목

         플러그형 데이터베이스에서는 AWR 보고서 평가 옵션이 사용되지 않습니다.

      3. 배율 필드에 승수 값을 입력합니다.

         • 권장되는 SKU가 다른 최고 부하를 고려해야 하는 경우 배율 승수는 1보다 커야 합니다. 이러한 배율의 예로는 버스트 부하, 계절별 사용량 및 향후 용량 계획이 있습니다. 부분 Oracle 스키마 워크로드를 마이그레이션하는 경우 승수는 1보다 작아야 합니다.

      4. 백분위수 사용률 필드에 Azure 대상 크기 조정에 대한 백분위수 값을 입력합니다.

         • Azure 대상 크기 조정을 위해 고려할 성능 샘플 집합의 백분위수 값입니다.

   

9. 평가에는 두 가지 유형이 있습니다.

   • 워크로드 평가. 이 평가에서 Oracle 평가 모듈은 스키마 개체의 간단한 검색을 수행하고 변환 시간을 대략적으로 예측하여 다양한 범주로 마이그레이션할 때의 스키마 복잡성을 분류합니다. 이러한 사전 평가는 대상 플랫폼으로의 마이그레이션의 실행 가능성을 파악하는 데 도움이 됩니다.

   • 코드 평가. 코드 평가는 Oracle 스키마 개체에 대한 심층 평가를 수행한 다음, 세분화된 수준에서 "준비됨", "검토 필요" 및 "준비되지 않음" 개체 형식과 코드 개체의 전반적인 준비 상태를 제안하고 더 높은 정확도로 연결된 변환 시간을 제안합니다.

     참고

     확장은 코드 평가를 위해 오픈 소스 Ora2Pg 스키마 변환기를 사용합니다.

     Oracle 클라이언트 및/또는 Ora2Pg가 Azure Data Studio와 동일한 컴퓨터에 설치되지 않은 경우 수동으로 설치하거나 GitHub의 Ora2Pg 설치 스크립트를 사용합니다.

     Oracle 클라이언트 및 Ora2Pg가 설치된 경우 확장 설정에서 Oracle 클라이언트 홈 경로 및 Ora2Pg 설치 경로가 업데이트되었는지 확인합니다.

     • SQL 시나리오에 대한 코드 평가를 선택할 때 Oracle에서 SQL로 변환하고 마이그레이션하기 위해 액세스하려는 스키마를 선택합니다. 기본값으로 평가에 적합한 모든 스키마가 선택됩니다.

10. 보안 권한, 구성 설정 등과 관련된 필수 구성 요소 및 다양한 유효성 검사 규칙을 수행하려면 유효성 검사 실행을 선택하세요. 유효성 검사가 실패하면 오류를 수정해야 계속 진행할 수 있습니다.

11. 유효성 검사가 성공적으로 수행되면 평가 실행을 선택할 수 있습니다.

12. 이제 “마지막 5개 평가” 섹션에 새 평가가 표시됩니다.

    

13. 평가 링크를 선택하여 평가 세부 정보 페이지를 봅니다. 최신 평가 상태를 볼 수 있습니다.

    

14. 새로 고침을 선택하거나 평가가 완료될 때까지 기다립니다. 기본적으로 평가 상태 페이지는 15초마다 새로 고쳐집니다. 성공, 실패, 진행 중 또는 취소됨의 네 가지 상태 중 하나가 표시됩니다.

평가 보기

평가가 완료되면 각 Azure SQL 대상(Azure Virtual Machines의 SQL Server, Azure SQL Database 및 Azure SQL Managed Instance 또는 Azure Database for PostgreSQL - Flexible server)에 대해 카드를 사용하는 통합 출력이 생성됩니다.

각 카드에는 여러 섹션이 있습니다. 이 카드는 대상으로 마이그레이션할 때의 전반적인 타당성을 보여 줍니다. 다양한 마이그레이션 복잡성 범주에서 다양한 워크로드를 드릴다운할 수 있습니다.

• 기능 평가 검토 결과를 제공하는 기능 호환성 섹션입니다.
• SKU 권장 사항은 대상의 적절한 크기 조정을 제공합니다.
• 코드 평가는 데이터베이스 개체의 코드 복잡성을 제공합니다.

보고서 세부 정보 보기를 선택하면 먼저 평가 요약이 표시됩니다.

선택한 대상이 Azure PostgreSQL용 데이터베이스인 경우 선택한 평가 유형에 따라 데이터베이스 세부 정보 탭 또는 코드 평가 탭이 표시됩니다.

다음 데이터베이스 세부 정보 탭은 스키마별 분석을 제공합니다. 검색된 스키마 목록, 마이그레이션 타당성, 예상 스키마 변환 시간(시간)을 보여 줍니다.

이 예측은 개체 수, 코드 줄, 활성화된 기능, 데이터베이스 크기에 적용되는 통계 모델을 기준으로 합니다. 코드 변환에 대한 더 정확한 추정을 위해 코드 평가를 사용하세요.

참고 항목

다음 시스템 또는 Oracle 기본 제공 스키마는 워크로드 평가에서 제외됩니다.

APEX, APPQOSSYS, AUDSYS, CSMIG, CTXSYS, DBMS_PRIVILEGE_CAPTURE, DBSFWUSER, DBSNMP, DIP, DMSYS, DVF, DVSYS, EXFSYS, FLOW_, GSMADMIN_INTERNAL, LBACSYS, MDDATA, MDSYS, MGDSYS, MGMT_VIEW, MTMSYS, ODM, ODM_MTR, OJVMSYS, OLAPSYS, ORACLE_OCM, ORDDATA, ORDPLUGINS, ORDSYS, OSE$HTTP$ADMIN, OUTLN, OWBSYS, OWBSYS_AUDIT, PERFSTAT, SDE, SI_INFORMTN_SCHEMA, SPATIAL_CSW_ADMIN_USR, SPATIAL_WFS_ADMIN_USR, SQLTXPLAIN, SYS, SYSMAN, SYSTEM, TRACESRV, TSMSYS, WEBSYS, WKPROXY, WKSYS, WK_PROXY, WK_TEST, WMSYS, XDB, XS$NULL

SKU 권장 사항은 다음 항목을 제공합니다.

• 적합한 Azure 대상

• 서비스 계층

• 메트릭 임계값은 권장되는 SKU를 제공하는 데 사용됩니다.

  

SKU 권장 사항은 CPU, 메모리, IOPS, 대기 시간, 스토리지와 같은 다양한 성능 메트릭을 평가합니다. 사용량 및 구성 데이터에 따라 추천자는 적절한 대상 및 적절한 서비스 계층을 제공합니다. SKU 권장 사항은 컨테이너 루트 인스턴스 또는 플러그형 데이터베이스 활용도를 기반으로 합니다. 스키마 선택은 무시되며 SKU 크기 조정에 적용되지 않습니다.

참고 항목

Oracle 인스턴스에서 AWR(자동 워크로드 리포지토리) 기능을 사용하도록 설정한 경우 SKU 추천자는 DBA_HIST_ 뷰를 사용하여 성능 메트릭 메타데이터를 수집합니다. 그렇지 않으면 권장자는 Azure SQL 대상의 크기를 조정하기 위해 서버 구성 및 기타 시스템 보기 정보를 사용합니다.

코드 호환성(PostgreSQL 대상에만 해당)은 Azure 대상으로 변환할 수 있는 스키마 개체의 요약을 제공합니다. 보고서는 자동으로 변환할 수 있고, 조건에 따라 준비 상태이며, 수동으로 수정 및 변환해야 하는 개체를 분석해서 설명합니다.

이 보고서는 코드를 Azure PostgreSQL 데이터베이스로 마이그레이션하는 데 필요한 총 개체 수와 변환 작업 시간을 보여 줍니다. 그래픽 이미지는 테이블, 뷰 및 클러스터와 같은 각 스키마 개체 형식을 분석해서 보여 줍니다. 이러한 작업은 "준비됨 - 자동으로 변환됨", "검토 필요", "준비되지 않음 - 수동 변환 필요"로 분류됩니다.

"준비되지 않음" 및 "검토 필요" 섹션에 대한 드릴다운은 수정 작업 목록과 각 작업에 대한 작업 시간을 제공합니다.

기능 평가는 Oracle-Azure 데이터 대상 매핑 기능과 이러한 기능을 Azure 대상으로 마이그레이션하는 데 필요한 노력을 제공합니다.

결합된 보고서 다운로드를 선택하거나 개별 보고서 다운로드를 선택하여 오프라인 보기용 보고서를 다운로드할 수 있습니다.

진행 중인 평가를 취소하고 평가를 삭제하고 평가를 다른 디렉터리로 이동할 수도 있습니다.

평가 경로 변경

1. 확장 마켓플레이스로 이동하여 Oracle용 데이터베이스 마이그레이션 평가를 검색합니다.
2. 관리 아이콘을 선택하고 확장 설정을 선택합니다.
3. Oracle 평가: 평가 경로 아래에 새 평가 경로를 제공합니다.

문제 해결

로그

확장은 오류, 경고 및 기타 진단 로그를 기본 로그 디렉터리에 저장합니다.

• Windows - C:\Users\<username>.dmaoracle\logs\
• Linux - ~/.dmaoracle/logs
• macOS - /Users/<username>/.dmaoracle/logs

참고

기본적으로 확장은 마지막 7개의 로그 파일을 저장합니다.

로그 디렉터리를 변경하려면 확장 설정 파일에서 LogDirectory 속성을 업데이트합니다.

운영 체제	경로
Windows	C:\Users\<username>\.azuredatastudio\extensions\microsoft.azuredatastudio-dma-oracle-<VersionNumber>\bin\service\Properties\ConfigSettings\extension-settings.json
Linux	~/.azuredatastudio/extensions/microsoft.azuredatastudio-dma-oracle-<VersionNumber>/<VersionNumber>/bin/service/Properties/ConfigSettings/extension-settings.json
macOS	/Users/<username>/.azuredatastudio/extensions/microsoft.azuredatastudio-dma-oracle-<VersionNumber>/<VersionNumber>/bin/service/Properties/ConfigSettings/extension-settings.json

문제 해결에 대한 자세한 내용은 Oracle 확장 오류에 대한 데이터베이스 마이그레이션 평가 문제 해결을 참조하세요.

알려진 문제 및 제한 사항

• 제공된 경로가 없습니다.

  이유: 파일이 없거나 평가 폴더에 대한 권한이 없습니다.

  가능한 해결 방법:

  • 사용자에게 평가 폴더에 대한 읽기 및 쓰기 권한이 있습니다.
  • 누락된 파일 또는 폴더가 있는 경우 평가를 삭제하고 새 평가를 생성합니다.

• Oracle과 상호 작용하는 동안 연결 시간 제한 예외가 발생했습니다.

  이유: Oracle 인스턴스에 연결하지 못했습니다.

  가능한 해결 방법:

  • 방화벽 규칙이 Oracle 수신 대기 포트를 차단하는지 확인합니다.
  • tnsping을 실행하고 서비스 ID가 확인되는지 확인합니다.

Microsoft에 문의하여 도움 받기

Microsoft에서 추가 지원이 필요한 경우 @dmasupport로 문의하세요. 더 빠른 처리 시간을 위해 기본 로그 디렉터리의 로그를 연결할 수 있습니다.

관련 콘텐츠

• Oracle용 확장(프리뷰)
• Azure Data Studio용 Azure SQL 마이그레이션 확장
• 데이터베이스 스키마 도구 키트(DSCT)
• Azure Data Studio의 기능 확장