SnowConvert: レポート¶

用語集¶

このセクションでは、 SnowConvert によって生成される複数のレポートドキュメントで使用される概念について説明します。

• 変換問題の合計数 は、変換処理中に発生した変換問題の合計数です。変換問題とは、ファイルI/O、メモリ管理、または処理できなかった異常な状況に関連する変換処理中に発生したエラーのことです。これらは未処理のコード例外であり、重大な問題とみなされます。

• 解析エラーの合計数 は、コード分析処理中に発生した解析エラーの合計数です。構文解析エラーは、パーサー（ソースコードファイルを読み込むコンポーネント）が予期しない何かに遭遇したときに発生します。これは通常、構文エラーを意味します。構文エラーとは、パーサーが期待していた SQL 文法仕様と一致しないファイル内のコード要素を指します。そのほかに、これらのエラーは、パーサーがまだ特定の文法をサポートする準備ができていないために発生することもあります。解析エラーも重大な問題です。この数値が移行作業負荷の大きさに比べて大きい場合は、入力コードの修正をお勧めします。

• 警告の合計数 は、指定された入力に対して SnowConvert が生成した警告の合計数です。警告は、特定の要素の翻訳がほぼ関数的に等価であるにもかかわらず、ユーザーの介入が必要になるような場合に挿入されます。ターゲットプラットフォームで実行したときに、コードが何らかの機能差を示した場合にレビューできる情報を提供することを意図しているため、重大度は低くなっています。

• コード行の合計数（LOC） は、変換ツールで処理された、コメントや空白行を除いたソースコードファイルのテキスト行の合計数です。

• 識別されたオブジェクト は、一般的には TABLES、 VIEWS、 PROCEDURES を意味します。これらのオブジェクトは、通常データベース方言 DDL の「ルート」要素であり、他の「より小さな」定義を含むことができるため、トップレベルに分類されます。トップレベルのオブジェクトは、 SQL の方言によって異なります（Oracle、Teradata、 SqlServer など）。SnowConvert がサポートする各 SQL の方言にあるトップレベルオブジェクトの詳細情報については、ドキュメントの このリンク をご確認ください。解析エラーにより、 SnowConvert はトップレベルのオブジェクトをすべて正しくカウント できない ことがあります。

• 未認識要素 は、 SnowConvert が処理できなかった解析エラーのある DML、 DDL、制御ステートメントなどのコード要素（またはその一部）です。

• 未認識要素のコード行数 は、すべての未認識要素にあるコード行の合計数です。これは、 SnowConvert が処理 できなかった コードの量を示す良いインジケーターです。

• 完全に変換されたオブジェクト は、サブパートのいずれにおいてもエラーなく完全に変換されたトップレベルオブジェクトの数です。展開の準備は整っているとみなされます。

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

• オブジェクト変換率 は、 完全に 変換されたオブジェクトと識別されたオブジェクトの間の割合です。

評価レポート（docx）¶

評価レポートは、コード変換率の見積もりや、ユーザーが機能的に等価なSnowflakeコードを達成するまでの距離を見積もるための、その他多くの有用な情報をまとめた文書です。

トップレベルコードユニットレポート¶

トップレベルコードユニットレポートは、ソースコードに存在する主なオブジェクトの概要を提供します。これらのトップレベルのオブジェクトは、変換の状態に関する有用な情報を持っており、変換の後に次のステップをどうすべきかを決定するために使用することができます。

問題レポート¶

問題レポートは、移行プロセス中に発生したすべての問題についての情報を含んでいるファイルです。

HTML レポート¶

HTML レポートは、変換による結果の一般概要を説明しています。このドキュメントは、レポートの内容の読み方の手引きとなります。

要素レポート¶

要素レポートには、移行プロセス中に見つかった文法要素の数が要約されて表示されます。要約は複数列ベースで行われるため、同じ文法要素が異なる文脈に属する場合は区別されます。たとえば、 SELECT クエリは、 PROCEDURE の一部であったり、 VIEW の一部であったり、スクリプトファイルの一部であったりします。このレポートを使用すると、要素を微妙なニュアンスで見ることができ、全体的な変換ステータスを確認できるようになります。