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.

言語: 日本語