Snowpark Migration Accelerator: 평가 요약 이해¶

Spark API 준비도 점수¶

이 보고서에는 여러 항목이 포함되어 있으며, 준비도 점수가 가장 중요한 메트릭입니다.

각 섹션을 자세히 살펴 보겠습니다.

1. 준비도 점수 - Spark API 준비도 점수는 SMA 에서 코드의 마이그레이션 준비 정도를 평가하는 데 사용하는 주요 메트릭입니다. 이 점수는 Snowpark API 로 변환할 수 있는 Spark API 참조의 비율을 나타냅니다. 이 점수는 유용하지만 Spark API 참조만 고려하며 서드 파티 라이브러리나 기타 요인은 고려하지 않습니다. 따라서 완전한 평가보다는 초기 평가로 활용하십시오.

   점수는 변환 가능한 Spark API 참조의 수를 코드에 있는 총 Spark API 참조 수로 나누어 계산합니다. 예를 들어, 점수가 3541/3746으로 표시되면 총 참조 3746개 중 3541개의 참조를 변환할 수 있다는 뜻입니다. 점수가 높을수록 Snowpark API 와의 호환성이 높음을 나타냅니다. 이 점수는 상세 보고서의 첫 페이지에서 확인할 수 있습니다.

2. 다음에 수행할 작업에 대한 제안 - 준비도 점수에 따라 SMA 에서 마이그레이션 프로세스의 다음 단계에 대한 권장 사항을 제공합니다.

3. 준비도 점수 설명 - 이 섹션에서는 Spark API 준비도 점수의 의미와 결과를 해석하는 방법에 대해 자세히 설명합니다.

4. 준비도 점수 분석 - 이 섹션에서는 두 가지 주요 메트릭을 사용하여 점수를 계산한 방법을 보여줍니다.

   • 변환 준비된 사용량: Snowpark로 변환할 수 있는 Spark API 참조(함수, 요소 또는 가져오기 문)의 수입니다

   • 식별자 사용: 코드에서 발견된 총 Spark API 참조 수입니다

서드 파티 라이브러리 준비도 점수¶

서드 파티 라이브러리 준비도 점수는 다음 형식으로 표시됩니다.

1. 준비도 점수 - 준비도 점수와 해당 카테고리(녹색, 노란색 또는 빨간색)를 표시합니다. 서드 파티 라이브러리 준비도 점수는 가져온 라이브러리 중 몇 퍼센트의 라이브러리가 Snowflake에서 지원되는지 보여줍니다. 자세한 내용은 서드 파티 API 준비도 점수 섹션을 참조하십시오.

2. 다음 단계 - 준비도 점수에 따라 SMA 에서 다음 작업에 대한 권장 사항을 제공합니다.

3. 점수 설명 - 서드 파티 라이브러리 준비도 점수의 의미와 결과를 해석하는 방법에 대해 설명합니다.

4. 점수 분석 - 이 공식을 사용하여 서드 파티 라이브러리 준비도 점수를 계산한 방법을 보여줍니다. (Snowpark에서 지원되는 라이브러리 호출 수) ÷ (식별된 라이브러리 호출의 총 수)

   여기서

   • “Snowpark에서 지원되는 라이브러리 호출”이란 Snowpark에서 사용할 수 있는 라이브러리를 의미합니다

   • “식별된 라이브러리 호출”이란 지원 여부에 관계없이 Spark 및 비 Spark 라이브러리를 모두 포함하여 코드에서 발견되는 모든 서드 파티 라이브러리 호출을 의미합니다

SQL 준비도 점수¶

SQL 준비도 점수는 다음 형식으로 표시됩니다.

• 준비도 점수 - 준비도 점수와 해당 카테고리(녹색, 노란색 또는 빨간색)를 표시합니다. 이 점수는 코드에서 Snowflake SQL 로 성공적으로 변환할 수 있는 SQL 요소의 수를 나타냅니다. 자세한 내용은 SQL Readiness Score 섹션을 참조하십시오.

• 다음 단계 - 준비도 점수에 따라 SMA 에서 진행하기 전에 수행해야 할 작업에 대한 권장 사항을 제공합니다.

• 점수 설명 - SQL 준비도 점수에 대한 명확한 설명과 결과를 해석하는 방법을 제공합니다.

• 점수 분석 - SQL 준비도 점수에 대한 자세한 계산을 표시하며, 다음과 같이 계산됩니다. (지원되는 요소 수) ÷ (총 요소 수).

Spark API 사용¶

보고서에는 탭으로 표시되는 3가지 주요 섹션이 있습니다.

1. 전체 사용 분류

2. Spark API 사용 분류

3. 상태별 Spark API 사용

아래에서 각 섹션을 자세히 살펴보겠습니다.

호출 가져오기¶

‘호출 가져오기’ 섹션에는 코드베이스에서 자주 사용하는 외부 라이브러리 가져오기가 표시됩니다. Spark API 가져오기는 “Spark API” 섹션에서 별도로 다루기 때문에 이 섹션에서 제외됩니다.

이 테이블에는 다음 정보가 포함되어 있습니다.

보고서에는 다음 정보가 표시됩니다.

1. 5개의 행이 표시된 테이블입니다.

   • 가장 자주 가져오는 3가지 Python 라이브러리

   • 나머지 모든 패키지를 요약하는 “기타” 행

   • 모든 수입의 합계를 표시하는 ‘합계’ 행

2. 각 라이브러리가 Snowflake의 Snowpark에서 지원하는 패키지 목록 에 포함되어 있는지 여부를 나타내는 “Snowpark에서 지원됨” 열

3. 모든 파일에서 각 라이브러리를 가져온 횟수를 보여주는 ‘가져오기 횟수’ 열.

4. 각 라이브러리의 가져오기를 1개 이상 포함하는 파일의 비율을 보여주는’파일 범위’열입니다. 예:

   • 가져오기 문에 ‘sys’가 29번 등장하지만 28.16%의 파일에서만 사용되었다면, 이는 일반적으로 파일당 한 번만 사용되었다는 의미입니다.

   • ‘기타’ 카테고리에는 100%의 파일에서 56개의 가져오기가 발생할 수 있습니다.

파일별 자세한 가져오기 정보는 출력 보고서의 ImportUsagesInventory.csv 파일을 참조하십시오.

파일 요약¶

요약 보고서에는 파일 유형 및 크기별로 조직화된 메트릭을 표시하는 여러 테이블이 포함되어 있습니다. 이러한 메트릭은 코드베이스의 볼륨에 대한 인사이트를 제공하고 마이그레이션 프로젝트의 필수 노력을 추정하는 데 도움이 됩니다.

Snowpark Migration Accelerator는 코드와 비코드 파일을 모두 포함하여 소스 코드베이스의 모든 파일을 분석합니다. 스캔한 파일에 대한 자세한 정보는 files.csv 보고서에서 확인할 수 있습니다.

파일 요약에는 여러 섹션이 포함되어 있습니다. 각 섹션을 자세히 살펴 보겠습니다.

문제 요약¶

문제 요약은 코드 스캔 중에 발견된 잠재적 문제에 대한 중요한 정보를 제공합니다. 평가에서 변환으로 변환할 때 코드베이스에서 감지된 EWIs (오류, 경고 및 문제) 목록이 표시됩니다. 이러한 문제에 대한 자세한 설명은 설명서의 문제 분석 섹션을 참조하십시오.

문제 요약의 상단에는 식별된 모든 문제에 대한 개요를 제공하는 테이블이 있습니다.

테이블에는 두 행이 포함됩니다.

• ‘문제 수’는 각 카테고리에서 발견된 모든 문제 코드의 총 개수를 나타냅니다.

• ‘고유 문제 수’는 각 카테고리에서 발견된 고유한 오류 코드의 수를 나타냅니다.

문제는 크게 3가지 범주로 나뉩니다.

• 경고 는 소스 플랫폼과 대상 플랫폼 간에 즉각적인 작업이 필요하지 않을 수 있지만 테스트 중에 고려해야 할 잠재적 차이를 나타냅니다. 여기에는 엣지 케이스의 동작이 약간 달라지거나 소스 플랫폼과 비교하여 모양이 변경되는 알림이 포함될 수 있습니다.

• 변환 문제 는 변환에 실패했거나 대상 플랫폼에서 올바르게 작동하기 위해 추가 구성이 필요한 요소를 강조 표시합니다.

• 구문 분석 문제 는 도구가 특정 코드 요소를 해석할 수 없을 때 발생합니다. 이는 즉각적인 주의가 필요한 중요한 문제이며, 일반적으로 소스 코드가 컴파일되지 않거나 잘못된 코드 추출로 인해 발생합니다. 소스 코드가 올바른데도 구문 분석 오류가 계속 발생한다면 SMA 에서 인식되지 않는 패턴 때문일 수 있습니다. 이러한 경우 문제 보고에 문제가 있는 소스 코드 섹션을 포함하십시오.

테이블에는 각 항목의 총 개수가 요약되어 있습니다.

이 테이블 아래에는 고유 문제 코드 목록과 해당 설명이 나와 있습니다.

각 문제 코드 항목은 다음을 제공합니다.

• 고유한 문제 식별자

• 문제에 대한 설명

• 발생 횟수

• 심각도 수준(경고, 변환 오류 또는 구문 분석 오류)

문제 코드를 클릭하면 포함된 자세한 설명서를 볼 수 있습니다.

• 문제에 대한 전체 설명

• 코드 예시

• 권장 해결책

예를 들어, 위에 표시된 첫 번째 문제 코드(SPRKPY1002)를 클릭하면 전용 설명서 페이지로 이동합니다.

기본적으로 테이블에는 상위 5개 문제만 표시됩니다. 모든 문제를 보려면 테이블 아래에 위치한 SHOW ALL ISSUES 버튼을 클릭하십시오. 테이블 위의 검색창을 사용하여 특정 문제를 찾을 수도 있습니다.

평가 모드에서는 남은 변환 작업을 이해하는 것이 중요합니다. Reports 폴더의 문제 인벤토리에서 각 문제와 해당 위치에 대한 자세한 정보를 확인할 수 있습니다.

실행 요약¶

실행 요약은 도구의 최근 분석에 대한 포괄적인 개요를 제공합니다. 다음 내용이 포함됩니다.

• 코드 분석 점수

• 사용자 세부 정보

• 고유 실행 ID

• SMA 및 Snowpark API 의 버전 정보

• 프로젝트 생성 시 지정한 프로젝트 폴더 위치

부록¶

부록에는 SMA 도구에서 생성된 출력을 더 잘 이해하는 데 도움이 되는 추가 참조 정보가 포함되어 있습니다.

이 가이드에는 Snowpark Migration Accelerator(SMA) 사용에 대한 일반적인 참조 정보가 포함되어 있습니다. 내용은 주기적으로 업데이트될 수 있지만, 특정 코드베이스에 대한 세부 사항보다는 보편적인 SMA 사용법에 중점을 두고 있습니다.

대부분의 사용자가 Snowpark Migration Accelerator(SMA)를 실행할 때 보게 되는 화면입니다. 이전 버전을 사용하는 경우 아래에 표시된 약식 평가 요약이 대신 표시될 수 있습니다.