SnowConvert: 보고서¶

용어집¶

이 섹션에서는 SnowConvert 에서 생성된 여러 보고서 문서에 사용되는 개념을 설명하려고 합니다.

• 총 변환 문제, 변환 프로세스 중에 발생한 변환 문제의 총 개수입니다. 변환 문제는 파일 I/O, 메모리 관리 또는 처리할 수 없는 비정상적인 상황과 관련된 변환 과정에서 발생한 오류를 말합니다. 이는 처리되지 않은 코드 예외이며 중요한 문제로 간주됩니다.

• 총 구문 분석 오류, 코드 분석 과정에서 발생한 구문 분석 오류의 총 개수입니다. 구문 분석 오류는 구문 분석기(소스 코드 파일을 읽는 구성 요소)가 예상치 못한 것을 발견할 때 발생합니다. 이는 일반적으로 구문 오류를 의미하며, 구문 분석기가 예상한 SQL 문법 사양과 일치하지 않는 파일의 코드 요소를 나타냅니다. 다른 경우에는 구문 분석기가 아직 특정 문법을 지원할 준비가 되지 않았기 때문에 이러한 오류가 발생할 수도 있습니다. 구문 분석 오류도 중요한 문제로 간주됩니다. 마이그레이션 워크로드 규모에 비해 이 숫자가 높으면 입력 코드를 수정하는 것이 좋습니다.

• 총 경고, 지정된 입력에 대해 SnowConvert 가 생성한 경고의 총 개수입니다. 경고는 특정 요소의 변환이 대부분 기능적으로 동일하지만 일부 사용자 개입이 필요할 수 있는 코너 케이스가 있을 때 삽입됩니다. 코드가 대상 플랫폼에서 실행될 때 어떤 종류의 기능적 차이를 보이는지 검토할 수 있는 정보를 제공하기 위한 것이므로 심각도가 낮습니다.

• 총 코드 라인 수(LOC), 소스 코드 파일의 텍스트에서 설명이나 빈 줄이 아닌, 변환 도구로 처리된 총 줄 수입니다.

• 식별자 오브젝트, 일반적으로 TABLES, VIEWS, PROCEDURES 를 의미합니다. 이러한 오브젝트는 일반적으로 데이터베이스 언어 DDL 의 “루트” 요소이기 때문에 최상위 레벨로 분류되며 다른 “작은” 정의를 포함할 수 있습니다. 최상위 오브젝트는 SQL 언어마다 다릅니다(Oracle, Teradata, SqlServer 등). SnowConvert 에서 지원하는 각 SQL 언어의 최상위 오브젝트에 대한 자세한 내용은 설명서의 이 링크에서 확인할 수 있습니다. 구문 분석 오류로 인해 SnowConvert 가 일부 최상위 레벨 오브젝트를 올바르게 계산하지 못할 수 있습니다.

• 인식할 수 없는 요소, DML, DDL, 제어 문과 같은 코드 요소(또는 그 일부)로, SnowConvert 가 처리할 수 없는 구문 분석 오류가 있는 요소.

• 인식할 수 없는 요소의 코드 라인, 인식할 수 없는 모든 요소의 총 코드 라인 수입니다. 이는 SnowConvert 가 처리할 수 없는 코드의 양을 나타내는 우수한 지표입니다.

• 완전히 변환된 오브젝트, 하위 파트에서 오류 없이 완전히 변환된 최상위 레벨 오브젝트의 개수입니다. 배포 준비가 완료된 것으로 간주됩니다.

• 코드 변환율 (SQL), 이 메트릭은 주어진 워크로드에서 인식된 요소와 인식되지 않은 요소의 소스 코드를 기준으로 계산됩니다.. 변환률은 SnowConvert 에서 기능적으로 동등한 Snowflake 코드로 성공적으로 변환된 소스 코드의 비율입니다. 구문 분석 문제로 인해 인식할 수 없는 요소는 소스 코드가 변환되지 않은 것으로 계산되므로 이 메트릭에 영향을 미친다는 점을 고려하십시오. 또한 Snowflake에서 동등성이 없는 요소는 SnowConvert 에서 처리할 수 있더라도(종종 제거하거나 설명하는 방식으로) 변환이 기능적으로 동등한 코드를 나타내지 않기 때문에 변환율에 불이익을 줍니다. 예를 들어, Snowflake에 해당하는 인덱스 코드가 많은 경우, 지원되지 않는 요소의 소스 코드가 전체 작업량의 상당 부분을 차지할 수 있으므로 변환율이 크게 떨어질 수 있습니다.

• 오브젝트 변환율, 완전히 변환된오브젝트와 식별된 오브젝트 사이의 백분율입니다.

평가 보고서(docx)¶

평가 보고서는 코드 변환율 추정치를 요약한 문서로, 사용자가 기능적으로 동등한 Snowflake 코드에 어느 정도 도달했는지 추정할 수 있는 유용한 정보가 많이 포함되어 있습니다.

최상위 코드 단위 보고서¶

최상위 코드 단위 보고서는 소스 코드에 있는 주요 오브젝트에 대한 일반적인 개요를 제공합니다. 이러한 최상위 오브젝트에는 변환 상태에 대한 유용한 정보가 있으며 변환 후 다음 단계를 결정하는 데 사용할 수 있습니다

문제 보고서¶

문제 보고서는 마이그레이션 프로세스 중에 발생한 모든 문제에 대한 정보가 포함된 파일입니다.

HTML 보고서¶

HTML 보고서에서 변환 결과에 대한 일반적인 개요를 확인할 수 있습니다. 이 설명서는 보고서의 내용을 읽는 방법에 대한 가이드를 제공합니다.

요소 보고서¶

요소 보고서에는 마이그레이션 과정에서 발견된 문법 요소의 요약된 수가 표시됩니다. 요약은 여러 열을 기준으로 이루어지므로 같은 문법 요소라도 서로 다른 문맥에 속할 경우 구분이 됩니다. 예를 들어, SELECT 쿼리는 PROCEDURE 또는 VIEW 의 일부이거나 스크립트 파일에 포함될 수도 있습니다. 이 보고서를 사용하면 약간의 뉘앙스가 있는 요소를 확인하고 전반적인 변환 상태를 검토할 수 있습니다.