Oracle スキーマ変換用の HTML レポートを表示する

Visual Studio Code 用の PostgreSQL 拡張機能で Oracle から Azure Database for PostgreSQL へのスキーマ変換を実行した後、HTML レポートを使用して記録された結果を確認します。 レポートには、検出、抽出、変換結果、環境の詳細、および変換セッションのオブジェクト レベルレポートへのリンクがまとめられています。

これを使用して、スコープを確認し、注意が必要なオブジェクトを調査し、結果を移行チームと共有します。 変換ワークフローについては、「チュートリアル: Oracle スキーマをAzure Database for PostgreSQLに変換する」を参照してください。

レポートを開く

スキーマ変換が完了すると、HTML レポートが自動的に開きます。 次のいずれかの方法で開くこともできます。

  • [ コンバージョンの概要 ] ページで、[ コンバージョン レポート] を選択します。
  • 移行の出力で、 convert\sessions\<session-id>\reports に移動し、Web ブラウザーで report.html を開きます。

レポートの [変換] 見出しのセッション ID を調べて、表示されているのが意図している実行であることを確認します。 まず [全体の概要] を開き、概要リンクを選択するか、セクション見出しを展開して詳細を表示します。

全体的な概要を読む

概要では、各フェーズの結果が別個に表示されます。

Summary 確認する内容
検出 [抽出]、[除外]、[無効] の数を含む、ソースで検出されたオブジェクト。
抽出 ソースから取得された定義と、失敗件数および除外件数。 抽出された定義は変換されたオブジェクトではありません。
変換 [変換済み] と [未変換] の変換セッションのカウント。
変換率 (%) 変換されたオブジェクトを変換の合計で割り、パーセンテージで表します。

検出、抽出、および変換では、必ずしも同じオブジェクトがカウントされるとは限りません。 たとえば、変換には生成されたスキーマ オブジェクトを含めることができます。 変換率を解釈するときは、検出または抽出の合計ではなく、レポートに表示される変換合計を使用します。 レポートで使用されるカウント ルールと定義を確認するには、[用語集] を展開してください。

[スキーマ レベルの変換] で、各スキーマの数と変換率を確認します。 [ロール] 列では、選択済みスキーマと他の含まれているスキーマは区別されます。 検索スキーマを使用してスキーマを検索するか、名前を選択してオブジェクト型の結果を開きます。

フェーズの合計、変換率、確認するオブジェクトの種類、スキーマ レベルの結果を含む HTML レポートの概要のスクリーンショット。

注意が必要なオブジェクトを特定する

確認すべき上位 5 つのオブジェクト型から始めて、変換されていないオブジェクトを持つ型の中で変換率が最も低い 5 つを確認します。 この一覧は、ビジネス上の重要度の順位付けを示すものではありません。 調査するオブジェクトの種類を選択するか、[ 詳細を表示 ] を選択して完全な オブジェクト型変換 セクションを開きます。

メイン レポートから、変換結果を調査します。

  1. [変換] を展開し、[オブジェクト型の変換] を展開します。
  2. テーブルを絞り込むには、[すべてのオブジェクトの種類] を選択し、1 つ以上の種類を選択して、[完了] を選択します。 次の表は、選択した種類のフィルター処理された合計を示しています。 すべての種類を復元するには、コントロールをもう一度開き、[フィルターのクリア] を選択し、[完了] を選択します。
  3. オブジェクトの種類の名前を選択して、そのオブジェクト レベルのレポートを開きます。
  4. スキーマ名を使用して、そのフィルターが使用可能な場合に、スキーマごとに結果を絞り込みます。 Search nameを使用して、Oracle ソース名または PostgreSQL ターゲット名を見つけます。
  5. [ ソース名 ] や [状態] などの並べ替え可能な列見出しを選択して、行を並べ替えます。 もう一度選択すると、順序が逆になります。
  6. [状態] 列を確認します。ここには、[変換済み] または [未変換] が表示されます。 使用可能な場合は、[ メモ] を選択して、オブジェクトの記録された変換ノートを読み取ります。

ノート パネルはオブジェクトを識別し、変換の変更、検証の失敗、レビューが必要な相違点など、記録された説明が表示されます。 変換されたオブジェクトと、変換されなかったオブジェクトのメモを確認します。

ソース名とターゲット名、変換状態、選択したオブジェクトの変換ノートを含むフィルター処理されたオブジェクトの結果のスクリーンショット。

Von Bedeutung

[変換済み] の結果が示されていること自体は、コンパイルの成功、デプロイへの組み込み、または同等のランタイム動作が確立されていることを意味するものではありません。 コンパイル検証では、データやアプリケーションの動作ではなく、構文と構造がチェックされます。 運用環境で使用する前に、個別のランタイム テストを完了します。

パッケージ メンバーを確認する

メイン レポートに戻り、[ 変換 ] と [ パッケージの変換 ] を展開して、パッケージ レベルとメンバー レベルの結果を確認します。 スキーマ名とフィルター パッケージを使用してパッケージを検索します。 次の表は、 パッケージの状態、メンバー数、変換されたメンバー数と変換されていないメンバー数、およびメンバー変換率を示しています。

パッケージ名を選択すると、そのメンバーのレポートが開きます。 ソース名、ソースの種類、ターゲット名、ターゲットの種類、変更、状態、およびメモを確認して、個々のメンバーが PostgreSQL にどのようにマップされるかを理解します。

パッケージは、そのメンバーの一部が [変換済み] の場合でも、[未変換] になることがあります。 パッケージ数、パッケージ本体数、およびメンバー数は、さまざまな母集団を表します。 メンバーの合計をオブジェクト型の合計に追加しないでください。 n/a のレートは、0% 変換率ではなく、その計算のオブジェクトまたはメンバーがないことを意味します。

検出と抽出の調査

変換結果に予期されるオブジェクトがない場合は、メイン レポートに戻り、前のフェーズを確認します。

  1. Discovery を展開します。 [サポート対象オブジェクトの種類] と [サポート対象外のオブジェクトの種類] を確認し、オブジェクトの種類の名前を選択して検出の詳細を開きます。
  2. 該当する [抽出] グループ、[除外] グループ、および [無効] グループを確認します。 スキーマとテキスト フィルターを使用してオブジェクトを検索し、提供されている場合は、その除外または無効の理由を確認します。
  3. 記録されたソース アクセスとスキーマの依存関係について、[ソースのアクセス許可] と [依存スキーマ] を確認します。 依存関係参照カウントはオブジェクト数ではありません。
  4. [抽出] を展開して、[抽出済み]、[失敗]、[除外]、および [無効] のカウント数を確認します。 [抽出されたオブジェクトを種類別に展開] を展開して、オブジェクトの種類別に Oracle から取得した定義を確認します。

[除外済み] オブジェクトは抽出から省略されました。このステータスは、PostgreSQL に代替が存在することを示すものではありません。 抽出の [失敗] の数は、変換フェーズの [未変換] の数ではなく、取得できなかった定義を表します。

環境とサポート情報を確認する

残りのセクションを使用して、実行のコンテキストを理解し、フォローアップ作業の計画を立てます。

セクション 確認する内容
環境 ソースの詳細、 ターゲット 変換データベース、 スキーマ変換で使用される拡張機能、 LLM の設定。
次の手順 - セットアップ セットアップ前のターゲット接続、アクセス許可、スキーマ、拡張機能の前提条件に関するガイダンス。
References パブリック ドキュメント、オブジェクト マッピング CSV、およびレポートの場所へのリンク。
用語集 状態、コンバージョン率、パッケージとメンバー数、およびその他のレポート用語の定義。

[参照] で、ソース オブジェクトとターゲット オブジェクトの名前と種類、記録された状態、および必要なアクションの object_mapping_summary.csv を開きます。 マッピング エントリはレポート オブジェクトの合計とは異なる場合があるため、変換率の分母として CSV 行数を使用しないでください。

[次の手順 - セットアップ] を準備のガイダンスとして使用してください。 レポート自体は配置スクリプトではありません。

レポートを共有する

変換結果を移動または共有するときに、レポート ディレクトリ全体を指定します。

レポート ディレクトリには、データベース名とスキーマ名、オブジェクト名、環境の詳細、変換に関するメモを含めることができます。 共有する前に内容を確認し、組織のデータ処理要件に従い、共有するものから資格情報またはシークレットを削除します。