AWS Schema Conversion Tool를 사용하여 Java 애플리케이션의 SQL 코드 변환 - AWS Schema Conversion Tool
Java 애플리케이션 변환 프로젝트 생성Java 애플리케이션 SQL 코드 변환변환된 애플리케이션 코드 저장Java 애플리케이션 변환 프로젝트 관리Java 애플리케이션 변환 평가 보고서 생성

AWS Schema Conversion Tool를 사용하여 Java 애플리케이션의 SQL 코드 변환

Oracle에서 PostgreSQL로 변환하는 경우 AWS Schema Conversion Tool를 사용하면 Java 애플리케이션에 포함된 SQL 코드를 변환할 수 있습니다. 이 특정 Java 애플리케이션 변환기는 애플리케이션 로직을 이해합니다. 또한 이 변환기는 함수, 파라미터, 로컬 변수 등과 같은 다양한 애플리케이션 객체에 있는 명령문을 수집합니다.

이러한 심층 분석 덕분에 Java 애플리케이션 SQL 코드 변환기는 일반 변환기와 비교하여 더 나은 변환 결과를 제공합니다.

Java 애플리케이션이 MyBatis 프레임워크를 사용하여 데이터베이스와 상호 작용하는 경우, AWS SCT를 사용하여 MyBatis XML 파일 및 주석에 포함된 SQL 문을 변환할 수 있습니다. 이러한 SQL 문의 로직을 이해하기 위해 AWS SCT에서는 MyBatis 구성 파일을 사용합니다. AWS SCT는 애플리케이션 폴더에서 이 파일을 자동으로 검색하거나 이 파일의 경로를 수동으로 입력할 수 있습니다.

AWS SCT에서 Java 애플리케이션 변환 프로젝트 생성

Oracle 데이터베이스 스키마를 PostgreSQL 데이터베이스 스키마로 변환하기 위한 Java 애플리케이션 변환 프로젝트를 생성할 수 있습니다. 소스 Oracle 스키마와 대상 PostgreSQL 데이터베이스를 포함하는 매핑 규칙을 프로젝트에 추가해야 합니다. 자세한 내용은 AWS Schema Conversion Tool에서 데이터 유형 매핑 단원을 참조하십시오.

단일 AWS SCT 프로젝트에 여러 애플리케이션 변환 프로젝트를 추가할 수 있습니다. 다음 절차에 따라 Java 애플리케이션 변환 프로젝트를 생성합니다.

Java 애플리케이션 변환 프로젝트를 생성하려면

  1. 데이터베이스 변환 프로젝트를 만들고 소스 Oracle 데이터베이스를 추가합니다. 자세한 내용은 AWS SCT에서 프로젝트 시작 및 관리 및 AWS SCT의 프로젝트에 서버 추가 단원을 참조하세요.

  2. 소스 Oracle 데이터베이스와 대상 PostgreSQL 데이터베이스를 포함하는 매핑 규칙을 추가합니다. 매핑 규칙에 대상 PostgreSQL 데이터베이스를 추가하거나 가상 PostgreSQL 대상 데이터베이스 플랫폼을 사용할 수 있습니다. 자세한 내용은 AWS Schema Conversion Tool에서 데이터 유형 매핑 및 AWS Schema Conversion Tool에서 가상 대상에 매핑 단원을 참조하세요.

  3. 보기 메뉴에서 Main view를 선택합니다.

  4. 애플리케이션 메뉴에서 New Java application을 선택합니다.

    Creating a Java application conversion project 대화 상자가 나타납니다.

    새 Java 애플리케이션 변환 프로젝트 대화 상자

  5. 이름에 Java 애플리케이션 변환 프로젝트의 이름을 입력합니다. 각 데이터베이스 스키마 변환 프로젝트에는 하위 애플리케이션 변환 프로젝트가 하나 이상 있을 수 있으므로 여러 프로젝트를 추가할 경우 적합한 이름을 선택합니다.

  6. 위치에 애플리케이션의 소스 코드 위치를 입력합니다.

  7. (선택 사항) MyBatis configuration file에 MyBatis 구성 파일의 경로를 입력합니다. AWS SCT가 애플리케이션 폴더를 스캔하여 이 파일을 자동으로 검색합니다. 이 파일이 애플리케이션 폴더에 없거나, 여러 구성 파일을 사용하는 경우에는 경로를 수동으로 입력합니다.

  8. 소스 트리에서 애플리케이션이 사용하는 스키마를 선택합니다. 이 스키마는 매핑 규칙에 속해야 합니다. AWS SCT는 매핑 규칙에 속하는 스키마를 굵게 강조 표시합니다.

  9. 확인을 선택하여 Java 애플리케이션 변환 프로젝트를 생성합니다.

  10. 왼쪽 패널의 애플리케이션 노드에서 Java 애플리케이션 변환 프로젝트를 찾습니다.

AWS SCT에서 Java 애플리케이션 SQL 코드 변환

AWS SCT 프로젝트에 Java 애플리케이션을 추가한 후 이 애플리케이션의 SQL 코드를 대상 데이터베이스 플랫폼과 호환되는 형식으로 변환합니다. 다음 절차를 사용하여 AWS Schema Conversion Tool에서 Java 애플리케이션에 포함된 SQL 코드를 분석하고 변환할 수 있습니다.

SQL 코드를 변환하려면

  1. 왼쪽 패널의 애플리케이션에서 Java 노드를 확장합니다.

  2. 변환할 애플리케이션을 선택하고 컨텍스트(마우스 오른쪽 버튼 클릭) 메뉴를 엽니다.

  3. 변환을 선택합니다. AWS SCT가 소스 코드 파일을 분석하고, 애플리케이션 로직을 결정한 후 코드 메타데이터를 프로젝트에 로드합니다. 이 코드 메타데이터에는 Java 클래스, 객체, 메서드, 전역 변수, 인터페이스 등이 포함됩니다.

    AWS SCT는 대상 데이터베이스 패널에서 소스 애플리케이션 프로젝트와 유사한 폴더 구조를 만듭니다. 여기서 변환된 애플리케이션 코드를 검토할 수 있습니다.

    분석할 SQL 코드

  4. 변환된 애플리케이션 코드를 저장합니다. 자세한 내용은 변환된 애플리케이션 코드 저장 단원을 참조하십시오.

Java 애플리케이션에는 다양한 소스 데이터베이스와 상호 작용하는 SQL 코드가 포함될 수 있습니다. 이러한 소스 데이터베이스 중 일부를 PostgreSQL로 마이그레이션할 수 있습니다. 이 경우 마이그레이션 범위에서 제외한 데이터베이스와 상호 작용하는 SQL 코드를 변환하지 않도록 해야 합니다. 변환 범위에서 Java 애플리케이션의 소스 파일을 제외할 수 있습니다. 이렇게 하려면 변환 범위에서 제외할 파일 이름의 확인란을 선택 취소합니다.

변환 범위를 변경한 후에도 AWS SCT는 계속 Java 애플리케이션의 모든 소스 파일에 대해 SQL 코드를 분석합니다. 그런 다음 AWS SCT는 변환 범위에서 제외한 모든 소스 파일을 대상 폴더에 복사합니다. 이 작업을 수행하면 변환된 애플리케이션 파일을 저장한 후 애플리케이션을 빌드할 수 있습니다.

AWS SCT를 사용하여 변환된 애플리케이션 코드 저장

다음 절차에 따라 변환된 애플리케이션 코드를 저장합니다.

변환된 애플리케이션 코드를 저장하려면

  1. 대상 데이터베이스 패널의 애플리케이션에서 Java 노드를 확장합니다.

  2. 변환된 애플리케이션을 선택하고 저장을 선택합니다.

  3. 변환된 애플리케이션 코드를 저장할 폴더의 경로를 입력하고 폴더 선택을 선택합니다.

소스 Java 애플리케이션이 MyBatis 프레임워크를 사용하는 경우, 새 데이터베이스에서 작동하도록 구성 파일을 업데이트해야 합니다.

AWS SCT에서 Java 애플리케이션 변환 프로젝트 관리

여러 Java 애플리케이션 변환 프로젝트를 추가하거나, AWS SCT 프로젝트에서 애플리케이션 코드를 업데이트하거나, AWS SCT 프로젝트에서 Java 변환 프로젝트를 제거할 수 있습니다.

Java 애플리케이션 변환 프로젝트를 더 추가하려면

  1. 왼쪽 패널에서 애플리케이션 노드를 확장합니다.

  2. Java 노드를 선택하고 컨텍스트(마우스 오른쪽 버튼 클릭) 메뉴를 엽니다.

  3. 새 애플리케이션(New application)을 선택합니다.

  4. 새 Java 애플리케이션 변환 프로젝트를 생성하는 데 필요한 정보를 입력합니다. 자세한 내용은 Java 애플리케이션 변환 프로젝트 생성 단원을 참조하십시오.

소스 애플리케이션 코드를 변경한 후 AWS SCT 프로젝트로 업로드합니다.

업데이트된 애플리케이션 코드를 업로드하려면

  1. 왼쪽 패널의 애플리케이션에서 Java 노드를 확장합니다.

  2. 업데이트할 애플리케이션을 선택하고 컨텍스트(마우스 오른쪽 버튼 클릭) 메뉴를 엽니다.

  3. 새로 고침을 선택한 다음, 예를 선택합니다.

    AWS SCT가 소스 파일의 애플리케이션 코드를 업로드하고 변환 결과를 제거합니다. AWS SCT에서 변경된 코드와 변환 결과를 유지하려면 새 Java 변환 프로젝트를 만듭니다.

소스 Java 애플리케이션이 MyBatis 프레임워크를 사용하는 경우, AWS SCT는 MyBatis 구성 파일을 사용하여 SQL 코드를 구문 분석합니다. 이 파일을 변경한 후 AWS SCT 프로젝트로 업로드합니다.

MyBatis 구성 파일의 경로를 편집하려면

  1. 왼쪽 패널의 애플리케이션에서 Java 노드를 확장합니다.

  2. 애플리케이션을 선택한 후 설정을 선택합니다.

  3. 찾아보기를 선택한 다음 MyBatis 구성 파일을 선택합니다.

  4. 적용을 선택합니다.

  5. 왼쪽 패널에서 애플리케이션을 선택하고 컨텍스트(마우스 오른쪽 버튼 클릭) 메뉴를 연 다음 새로 고침을 선택합니다.

Java 애플리케이션 변환 프로젝트를 제거하려면

  1. 왼쪽 패널의 애플리케이션에서 Java 노드를 확장합니다.

  2. 제거할 애플리케이션을 선택하고 컨텍스트(마우스 오른쪽 버튼 클릭) 메뉴를 엽니다.

  3. 삭제를 선택한 다음, 확인을 선택합니다.

AWS SCT에서 Java 애플리케이션 변환 평가 보고서 생성

Java 애플리케이션 변환 평가 보고서는 Java 애플리케이션에 포함된 SQL 코드를 대상 데이터베이스와 호환되는 형식으로 변환하는 방법에 대한 정보를 제공합니다. 평가 보고서는 모든 SQL 실행 지점과 모든 소스 코드 파일에 대한 변환 세부 정보를 제공합니다. 평가 보고서에는 AWS SCT에서 변환할 수 없는 SQL 코드에 대한 작업 항목도 포함되어 있습니다.

다음 절차에 따라 Java 애플리케이션 변환 평가 보고서를 생성합니다.

Java 애플리케이션 변환 평가 보고서를 생성하려면

  1. 왼쪽 패널의 애플리케이션에서 Java 노드를 확장합니다.

  2. 변환할 애플리케이션을 선택하고 컨텍스트(마우스 오른쪽 버튼 클릭) 메뉴를 엽니다.

  3. 변환을 선택합니다.

  4. 보기 메뉴에서 Assessment report view를 선택합니다.

  5. 요약 탭을 검토합니다.

    아래에 나온 요약 탭에는 Java 애플리케이션 평가 보고서의 요약 정보가 표시됩니다. 또한 모든 SQL 실행 지점과 모든 소스 코드 파일에 대한 변환 결과를 보여줍니다.

    Java 애플리케이션 평가 보고서 요약 탭

  6. Save statements to JSON을 선택하여 Java 애플리케이션에서 추출된 SQL 코드를 JSON 파일로 저장합니다.

  7. (선택 사항) 보고서의 로컬 사본을 PDF 파일 또는 쉼표로 구분된 값(CSV) 파일로 저장합니다.

    • 오른쪽 상단에서 Save to PDF를 선택하여 보고서를 PDF 파일로 저장합니다.

      PDF 파일에는 애플리케이션 변환에 대한 요약 정보, 작업 항목 및 권장 사항이 포함되어 있습니다.

    • 오른쪽 상단에서 Save to CSV를 선택하여 보고서를 CSV 파일로 저장합니다.

      CSV 파일에는 SQL 코드 변환에 필요한 작업 항목, 권장 작업 및 예상 수작업의 복잡성 등이 포함되어 있습니다.