Conversion オブジェクト エクスプローラーを使用して、Oracle から PostgreSQL への変換結果を確認および絞り込みます。 エクスプローラーには、ソース オブジェクトが、対応するターゲット名、型、および状態と併せて表示されます。 各オブジェクトでは、ソースとターゲットの比較画面が表示され、変換内容を説明したり、生成された PostgreSQL ファイルの変更をサポートしたりする Copilot アクションを使用できます。
完了した変換からエクスプローラーを開く手順については、チュートリアルで変換されたオブジェクトを確認して絞り込むを参照してください。
オブジェクトの検索と検査
結果テーブルの上にあるフィルターを使用して、確認するオブジェクトを絞り込みます。
| 状態 | Purpose |
|---|---|
| ソース オブジェクト名でフィルター処理する | Oracle ソース名でオブジェクトを検索します。 |
| すべてのスキーマ | 結果をソース スキーマに絞り込みます。 |
| すべてのソース オブジェクトの種類 | Oracle オブジェクトの種類で結果を絞り込みます。 |
| すべてのステータス | 変換で利用可能なステータスで結果を絞り込みます。 |
スキーマ、ソースの種類、およびソース オブジェクトをまとめて読み取り、Oracle オブジェクトを識別します。 ターゲット オブジェクトとターゲットの種類を比較し、その PostgreSQL マッピングを理解します。 [状態] 列にはオブジェクトの変換結果が表示され、[アクション] は Ask と Fix を提供します。
結果が複数のページにまたがる場合は、表の下にあるページ コントロールを使用します。
パッケージとその他の複数ステートメント オブジェクトを確認する
パッケージとその他の一部のソース オブジェクトは、複数の PostgreSQL ステートメントを生成できます。 関連付けられたエントリを確認するには、変換を単一の PostgreSQL ステートメントとして扱うのではなく、親オブジェクトを展開します。
パッケージメンバーを確認する
パッケージ階層を使用して、個々のメンバーとそれぞれに対応する PostgreSQL の同等項目を確認します。
- メイン テーブルの上にあるスキーマとソース オブジェクト名フィルターを使用して、パッケージを見つけます。
- パッケージの横にあるシェブロンを選択して、メンバー エントリを展開します。
- Oracle ソースの種類や PostgreSQL ターゲットの種類を含む、各メンバーのソースとターゲットのマッピングを確認します。
- 検査するメンバーを選択し、そのソースとターゲットの比較と [変換メモ] を確認してください。
メンバーを個別に確認して、各メンバーに対して行われた変更を理解します。 パッケージ レベルのビューはメンバーを見つけるのに役立ちますが、生成された定義の確認に代わるものではありません。
ソース オブジェクトの種類でメンバーをフィルター処理する
メンバーが多いパッケージの場合は、展開されたパッケージ内のオブジェクト型フィルターを使用して、一度に 1 つの Oracle ソース メンバーの種類に焦点を当てます。 このフィルターでは、PostgreSQL ターゲットの種類ではなく、メンバーの Oracle ソースの種類が使用されます。
2 つのオブジェクト型フィルターは、異なる目的で使用されます。
| 場所で絞り込む | フィルターする内容 |
|---|---|
| メイン テーブルの上にある すべてのソース オブジェクトの種類 | メインの結果一覧のソース オブジェクト。 |
| 展開されたパッケージ内のオブジェクト型フィルター | Oracle ソースの種類別のそのパッケージのメンバー。 |
1 つのメンバーの種類を確認した後、メンバー型フィルターを変更または削除して、残りのメンバーを確認します。
階層の展開と折りたたみ
確認するレベルで expand-all コントロールと collapse-all コントロールを使用します。
| Level | Purpose |
|---|---|
| Explorer | エクスプローラー全体で展開可能なオブジェクトをまとめて展開または折りたたみます。 |
| Package | そのパッケージ内のメンバーをまとめて展開または折りたたみします。 |
展開可能オブジェクトのシェブロンは、そのオブジェクトの展開または折りたたみのみを行う場合に使用します。
定義を比較し、変換に関するメモを確認する
オブジェクトを選択して、その差分ビューを開きます。 Oracle 定義が左側に表示され、生成された PostgreSQL 定義が右側に表示されます。 比較を確認して、名前、型、パラメーター、およびデータベース固有のコンストラクトの変更を理解します。
定義と併せて、[変換メモ] パネルを確認します。 メモには、変換に関するコンテキストと、注意が必要な違いがあります。 変換されたオブジェクトと、修正が必要なオブジェクトを確認します。
Copilot に変換の説明を依頼する
オブジェクトに対して Ask を選択すると、GitHub Copilot にその変換内容と依存関係の説明を求めることができます。 説明と差分ビューと変換に関するメモを使用して、PostgreSQL 定義と Oracle ソースの関係を理解します。
変更を加える前に、定義とアプリケーションの要件に照らしてCopilotの説明を確認してください。
オブジェクトを修正し、変更をコンパイルする
修正を選択すると、オブジェクトの詳細を含むCopilot プロンプトが開きます。 Copilotはそのコンテキストを基に、PostgreSQL ファイルに変更を加えるのを支援します。 コンパイルする前に、結果の編集内容を確認してください。
デプロイ前に生成されたファイルを編集できます。 手動コンパイルの場合は、非運用データベースを使用し、必要なスキーマと依存関係が使用可能であることを確認します。 そのデータベースを準備する必要がある場合は、 セットアップ エクスペリエンスを参照してください。
その非運用データベース内のオブジェクトを修正して手動でコンパイルするには:
- 変更するオブジェクトの [修正] を選択します。
- Copilotと協力して、必要な修正を行い、更新された PostgreSQL 定義を確認します。
- 編集した PostgreSQL ファイルを SQL エディターで開きます。
- SQL エディターを非運用環境の PostgreSQL サーバーに接続します。
- 変換されたスキーマがデプロイされているサーバー上のデータベースに接続します。 エディターのアクティブなデータベースを確認します。
- SQL のスキーマ参照を確認し、実行する完全なステートメントまたはステートメント群を選択します。
- SQL エディターで再生ボタンを選択して、選択したステートメントを実行し、オブジェクトをコンパイルします。 [PostgreSQL クエリの実行] を使用して、選択範囲を実行することもできます。
- 実行出力を確認します。 報告されたエラーを修正し、必要に応じて更新された定義を再実行してください。
SQL エディターの [PostgreSQL クエリの実行] コマンドは、選択されているテキストを実行します。 テキストが選択されていない場合は、エディター内の内容全体を実行します。 変換された複数のメンバーの定義がファイルに含まれている場合は、関連のない定義を意図せず実行しないように、完全なステートメントを選択します。
ファイルを編集し、データベースでコンパイルする手順は別です。 実行結果を使用して、更新された定義が適用されたかどうかを判断します。 運用環境へのデプロイを行う前に、生成されたデプロイ SQL にテスト済みの修正が含まれていることを確認します。オブジェクトごとのファイルを編集することで、deploy.sql が更新されるとは考えないでください。
エディターを接続し、データベースを選択して SQL を実行する手順については、「 クエリ エディターと IntelliSense」を参照してください。
コンパイルを超えて検証する
コンパイルが成功しても、変換されたオブジェクトが Oracle ソースと同じように動作することを保証するものではありません。 運用環境のデプロイの前に、変換されたスキーマを使用して、データ処理、ビジネス ロジック、依存関係、およびアプリケーションの動作を個別にテストします。