SnowConvert AI - 보고서¶
용어집¶
이 섹션에서는 SnowConvert 에서 생성된 여러 보고서 문서에 사용되는 개념을 설명하려고 합니다.
코드 줄(LOC): 변환 도구에 의해 처리된, 빈 줄을 제외한 소스 코드 파일 텍스트의 총 줄 수입니다. 주석은 코드 줄로 간주됩니다.
구문 분석 EWIs: 코드 분석 프로세스 중에 발생한 총 구문 분석 오류 수입니다. 구문 분석기(소스 코드 파일을 읽고 이해하는 구성 요소)에 예기치 않은 문제가 발생하면 구문 분석 오류가 발생합니다. 이는 일반적으로 구문 오류를 의미하며, 구문 분석기가 예상한 SQL 문법 사양과 일치하지 않는 파일의 코드 요소를 참조합니다. 다른 경우에는 구문 분석기가 아직 특정 문법을 지원할 준비가 되지 않았기 때문에 이러한 오류가 발생할 수도 있습니다. 코드가 구문 분석되지 않으면 SnowConvert AI에서 평가하거나 변환할 수 없기 때문에 구문 분석 오류는 중요한 문제로 간주됩니다. 마이그레이션 워크로드 크기에 비해 이 숫자가 높으면 입력 코드를 수정하는 것이 좋습니다.
인식할 수 없는 요소: SnowConvert AI가 처리할 수 있는 구문 분석 오류가 있는 DML, DDL, 제어 문과 같은 모든 코드 요소(또는 해당 일부)입니다.
인식할 수 없는 요소의 코드 줄: 인식할 수 없는 모든 요소의 총 코드 줄입니다. 이는 SnowConvert AI가 처리할 수 없는 코드 양을 나타내는 좋은 지표입니다.
(최상위) 코드 단위: 코드 단위는 가장 원자적인 독립 실행형 실행 요소입니다. 대부분의 경우, 이는 문(예: DDL 또는 DML)이지만, 스크립트 파일은 단일 요소로 실행되므로 스크립트 파일도 포함합니다. 일반적으로 데이터베이스 언어의 “루트” 요소이며 다른 “더 작은” 정의를 포함할 수 있으므로 최상위 수준으로 분류됩니다. 최상위 코드 단위는 SQL 언어(Oracle, Teradata, SQL Server 등)마다 다릅니다. 구문 분석 오류로 인해 SnowConvert AI는 모든 최상위 코드 단위를 올바르게 계산할 수 없습니다.
코드 줄 변환율: SnowConvert AI에서 Snowflake 코드로 성공적으로 변환된 코드 줄의 백분입니다. 인식할 수 없는 요소(구문 분석 문제로 인해)는 해당 소스 코드가 변환되지 않은 것으로 간주되므로 이 메트릭에 영향을 준다는 점을 고려하세요. 또한, 플랫폼의 차이나 제한으로 인해 Snowflake에서는 성공적인 요소 변환이 완전히 동일하지 않을 수 있습니다. 이러한 경우 변환율이 저하되지는 않지만, SnowConvert AI는 FDM을 생성하여 기능의 가능한 차이점에 대해 경고합니다. 코드 단위의 변환율이 90%라는 것은 코드 줄의 10%만 변환되지 않았음을 의미하므로 이에 대한 EWIs가 생성됩니다.
완전히 변환된 코드 단위: 하위 부분에서 오류 없이 완전히 변환된 최상위 코드 단위의 백분율입니다. 이는 배포할 준비가 된 것으로 간주됩니다. 변환율이 100% 미만인 코드 단위는 완전히 변환된 것으로 간주되지 않습니다.
평가 보고서(docx)¶
평가 보고서는 코드 변환율 추정치를 요약한 문서로, 사용자가 기능적으로 동등한 Snowflake 코드에 어느 정도 도달했는지 추정할 수 있는 유용한 정보가 많이 포함되어 있습니다.
최상위 코드 단위 보고서¶
최상위 코드 단위 보고서는 소스 코드에 있는 주요 오브젝트에 대한 일반적인 개요를 제공합니다. 이러한 최상위 오브젝트에는 변환 상태에 대한 유용한 정보가 있으며 변환 후 다음 단계를 결정하는 데 사용할 수 있습니다
문제 보고서¶
문제 보고서는 마이그레이션 프로세스 중에 발생한 모든 문제에 대한 정보가 포함된 파일입니다.
요소 보고서¶
요소 보고서에는 마이그레이션 과정에서 발견된 문법 요소의 요약된 수가 표시됩니다. 요약은 여러 열을 기준으로 이루어지므로 같은 문법 요소라도 서로 다른 문맥에 속할 경우 구분이 됩니다. 예를 들어, SELECT 쿼리는 PROCEDURE 또는 VIEW 의 일부이거나 스크립트 파일에 포함될 수도 있습니다. 이 보고서를 사용하면 약간의 뉘앙스가 있는 요소를 확인하고 전반적인 변환 상태를 검토할 수 있습니다.
함수 사용 보고서¶
함수 사용 보고서는 변환 프로세스 중에 발견된 기본 제공 함수 및 사용자 정의 함수의 호출을 마이그레이션 상태별로 그룹화하여 요약합니다. 이 보고서를 통해 사용자는 함수 사용, 문제 없이 Snowflake로 변환되었는지 여부 추가적인 변환 후 작업이 필요한지 여부에 대한 세부 정보를 확인할수 있습니다.
ETL Replatform Issues Report¶
The ETL Replatform Issues Report (EWIs Report) provides a detailed inventory of errors, warnings, and issues encountered during SSIS to dbt migration. Use this report to identify ETL components that require manual intervention or review.
ETL Replatform Component Summary Report¶
The ETL Replatform Component Summary Report provides a comprehensive inventory of all identified SSIS components and their migration outcomes. Use this report to understand the overall ETL migration scope and identify areas requiring attention.