SnowConvert: 用語集

レポート

このページでは、 SnowConvert を使用して変換を実行したときに生成される、さまざまなタイプのレポートについて説明します。

​用語集

このセクションでは、複数のレポートドキュメント(SnowConvert)に共通する概念について説明します。

  • 変換の問題の合計数: ファイルI/Oの問題やメモリ管理の問題など、変換中に発生した重大なエラーの数。

  • 解析エラーの合計数: コードを分析したときに見つかったエラーの数。これらは、パーサーが予期しないコードや、 SQL の文法規則に一致しない構文に遭遇したときに発生します。高い数値は、コードレビューの必要性を示唆しています。

  • 警告の合計数: 変換されたコードはほぼ同等だが、見直しが必要なケースの数。これらは、潜在的な機能差に関する重大度が低い通知です。

  • コードの行合計数(LOC): コメントと空白行を除いた、実際のコード行数。

  • 識別されたコードユニット: TABLES、 VIEWS、 PROCEDURES のようなスタンドアロンデータベースオブジェクトの数。これらの定義には、より小さな定義が含まれている場合があります。

  • 未認識要素: SC、解析エラーにより処理できなかったコードコンポーネント。

  • 未認識要素のコード行数: SC が処理に失敗したコード行の合計数。

  • 完全に変換されたコードユニット: エラーなしで変換され、配備可能な状態になった完全なデータベースオブジェクトの数。

  • **コード変換率(SQL): このメトリックは、与えられたワークロード内の認識された要素と未認識要素の両方のソースコードを参照として使用して計算されます。変換率とは、 SnowConvert により、関数と同等のSnowflakeコードに変換できたソースコードの割合です。未認識要素(解析の問題のため)は、ソースコードが変換されていないとカウントされるため、この測定値に影響することを考慮してください。さらに、Snowflakeで等価性を持たない要素は、 SnowConvert が処理できても(頻繁にそれらを削除したりコメントしたりすることによって)、翻訳が関数的に等価なコードを表していないため、変換率も悪化します。たとえば、インデックスのコード(Snowflakeに同等のものがない)が多い場合、サポートされていない要素のソースコードが全体的なワークロードのかなりの部分を占める可能性があるため、変換率が非常に悪化する可能性があります。

  • コードユニットの変換率、 完全に 変換されたコードユニットと識別されたコードユニットの間のパーセント。

  • コードユニットの変換率: 識別されたオブジェクトの合計数と比較した、完全に変換されたデータベースオブジェクトのパーセント。

  • 評価レポートデータ: SC が分析結果を表示する方法は以下のとおりです。

    • 「0」はゼロ値を表します。

    • 「-」はコードユニットが存在しないことを意味します。

    • 「N/A」は、サポートされていない機能または存在しないSnowflake同等の機能を示します。

​評価レポート(docx)

評価レポートは、コード移行プロジェクトの包括的な概要を提供します。推定コード変換率や、機能的に同等のSnowflakeコードの達成にどれだけ近づいているかを理解するのに役立つ貴重な洞察が含まれています。

​問題に関するレポート

問題レポートは、移行プロセス中に発生したすべての問題をリストしたファイルです。

​HTML レポート

HTML は、変換の結果をまとめます。このガイドでは、レポートのコンテンツの解釈方法について説明します。

​要素レポート

要素レポートは、移行中に発見された文法要素の詳細な数を提供します。レポートでは、異なるコンテキストで使用される類似の要素を区別するために、複数の列で要素を整理します。たとえば、 SELECT クエリは、 PROCEDURE、 VIEW、スクリプトファイル内など、さまざまな場所に表示できます。このレポートは、要素を詳細に理解し、変換の進捗をモニターするのに役立ちます。

​コードユニット(CU)

SnowConvert は、コードを分析し、レポート用にコードユニットと呼ばれる管理しやすい小さな単位に分割します。コードユニットの定義に関する詳細情報は、「こちら」のドキュメントをご参照ください。

コードユニット親カテゴリ(CUPC)

分析しやすいように、このドキュメントではコードユニットをグループ化して、変換率やカウント数などのメトリクスを示しているセクションがあります。各コードユニットの詳細情報は、コードユニットのメインドキュメントでご覧いただけます。コードユニットがどのようにグループ化されるかについては、 [こちら] のドキュメントをご参照ください。