この記事では、Oracle を使用して、Visual Studio Codeのスキーマ変換機能をAzure Database for PostgreSQLする場合の既知の制限事項、サポートされていないオブジェクト、および移行に関する考慮事項をまとめています。
プラットフォームサポートの制限事項
- ARM64: Windowsまたは Linux ではサポートされていません。
スキーマ変換には PostgreSQL 15 以降が必要です。 macOS 13 以降を含むサポートされているオペレーティング システムについては、 チュートリアルの前提条件を参照してください。
サポートされていないオブジェクトと部分的にサポートされているオブジェクト
以下のセクションでは、サポートされていないオブジェクト、部分的な変換、および手動レビューが必要な機能について説明します。 個々のオブジェクトの結果は、ソース定義、依存関係、およびターゲットの前提条件によって異なります。
検出、抽出、変換、デプロイは異なる段階を表します。 オブジェクトが検出された場合でも、抽出から除外されたり、抽出されても変換されなかったりすることがあります。 ソース スコープの検出結果、変換結果とメモの HTML 変換レポートとConversion オブジェクト エクスプローラー、展開結果のセットアップ エクスペリエンス レポートを確認します。
Oracle システムと組み込みスキーマは抽出または変換されません。 これには、 SYS、 SYSTEM、 XDB、 MDSYS、 CTXSYS、 WMSYSなどのスキーマが含まれます。
Important
変換された結果だけでは、コンパイルの成功、完全な実装、デプロイへの組み込み、または同等のランタイム動作は確立されません。 コンパイルでは、データやアプリケーションの動作ではなく、構文と構造がチェックされます。 Converted オブジェクトと Not converted オブジェクトの両方を確認し、運用環境で使用する前に個別のランタイム テストを完了します。
プレースホルダーの出力
ツールでオブジェクトを完全に変換できない場合は、ベスト エフォートまたはプレースホルダー DDL が生成される可能性があります。 一部のオブジェクトには、使用可能な PostgreSQL 定義がありません。
プレースホルダーは、元のビジネス ロジックを実装しません。 たとえば、本体でエラーが発生する生成されたルーチンが、[変換済み] として表示されることがあります。 状態だけに依存するのではなく、生成された定義と変換に関するメモを調べます。
プレースホルダーに依存するオブジェクトは、手動で変更する必要がある場合や、生成されたデプロイ スクリプトから省略される場合があります。 デプロイの前に、Conversion オブジェクト エクスプローラーでこれらの依存関係を確認してください。
手動での完了が必要になるケースは次のとおりです。
- 自律トランザクション。
PRAGMA AUTONOMOUS_TRANSACTIONを使用するルーチンの変換は、dblinkに依存します。 必要な拡張機能の不足、またはサポートされていないトランザクション ロジックにより、完全な変換が妨げられる可能性があります。 - 未解決の参照。 依存関係が不足しているか未解決の場合、変換またはコンパイルを完全に実行できないことがあります。
- トランザクション制御文。
ROLLBACK TO SAVEPOINTなどのコンストラクトは、常に正常に変換されるわけではありません。 - ラップ済みPL/SQL。 ソース本体は変換に使用できません。 詳細については、Wrapped PL/SQL を参照してください。
プログラム可能なオブジェクト
| オブジェクトの種類 | 制限事項 | 何をすべきか |
|---|---|---|
| パッケージ本体 | 変換されたパッケージ定義は、呼び出し間で同等の状態の初期化や永続化を確立しません。 | アプリケーションで想定される動作に照らして、呼び出し、トランザクション、セッション間で共有状態をテストします。 |
PRAGMA AUTONOMOUS_TRANSACTION を使用するルーチン |
変換では、 dblinkを介して別の接続を使用できます。 生成された接続処理とトランザクション ロジックを確認する必要があります。 |
変換前に必要な拡張機能をインストールしてください。 接続とセッション のコンテキスト、データの可視性、コミット、ロールバック、エラー処理をテストします。 |
| トリガー(システム イベント) | 生成されたトリガーをコンパイルしても、同等の Oracle データベースまたはセッション イベント処理は確立されません。 |
LOGON、LOGOFF、STARTUP、SHUTDOWN、および SERVERERROR のトリガーを明示的に確認します。 ターゲット イベント、スコープ、アクセス許可を検証し、ターゲットでサポートされていないロジックを再実装します。 |
| トリガー (クロスエディション) | 通常の PostgreSQL トリガーへのマッピングには、Oracleエディションのスコープの喪失についてのレビューが必要です。 | 単一のエディションを変換して、ターゲットのトリガーが起動するタイミングを確認し、リリース プロセスでバージョンのロールアウトを処理します。 |
| 本文を入力 | 型本体は抽出可能ですが、抽出されても、それらのメソッドの完全な PostgreSQL 実装が保証されるわけではありません。 | 型メソッドとその依存関係について、生成された定義を確認します。 不足しているロジックを手動で実装してください。 |
| Java ソース、Java ストアド プロシージャ、Java クラス | 抽出されません。 Azure Database for PostgreSQL フレキシブル サーバーでは、データベース内で Java を実行できません。 | PL/pgSQL でロジックを書き換えるか、アプリケーション レイヤーにロジックを移動してください。 |
外部 C ライブラリ (CREATE LIBRARY) |
抽出されません。 | PL/pgSQL でロジックを書き換えるか、アプリケーション レイヤーにロジックを移動してください。 |
| wrap された PL/SQL | ボディを読み取ることはできません。 生成された出力には、元の実装ではなくプレースホルダーを含めることができます。 詳細については、Wrapped PL/SQL を参照してください。 | 変換を開始する前に、元のラップされていないソースを取得するか、不足している PostgreSQL ロジックを手動で実装してください。 |
wrap された PL/SQL
このツールは、Oracle wrap ユーティリティまたは DBMS_DDL.WRAPを使用して、ラップされた (難読化された) 形式で格納されている PL/SQL ユニットの実装を読み取ることはできません。 使用可能なメタデータを使用して、プレースホルダー (呼び出し時にエラーを発生させるルーチンなど) を生成する場合があります。 この出力では、元のビジネス ロジックは再構築されません。
状態が変換済みの場合でも、ラップされた単位を Conversion オブジェクト エクスプローラーで確認します。 生成された定義、変換メモ、依存関係を調べて、不足している実装を特定します。 プレースホルダーは、依存オブジェクトが変換またはデプロイされることを保証するものではありません。
変換を開始する前に、元のラップされていないソースを取得してください。 変換が既に完了している場合は、不足している PostgreSQL ロジックを手動で実装して検証します。 完了した変換の再実行はサポートされていません。
データとストレージ オブジェクト
| オブジェクトの種類 | 制限事項 | 何をすべきか |
|---|---|---|
ユーザー定義演算子 (CREATE OPERATOR) |
変換は保証されず、プレースホルダー出力が生成される可能性があります。 | 生成されたオペレーターを確認し、テストします。 |
| インデックス (ビットマップ、ビットマップ結合、グローバル パーティション分割、またはドメイン) | 抽出されていません。 PostgreSQL では、Oracle ビットマップまたはドメイン インデックスは使用されません。 | インデックス固有の機能に対するアプリケーションの依存関係を確認し、適切なターゲット インデックスを選択し、クエリの動作とパフォーマンスをテストします。 |
マテリアライズド・ビュー・ログ (MLOG$) |
抽出されていません。 | 更新スケジュールやデータの鮮度要件など、ターゲットの具体化されたビューの更新戦略を定義してテストします。 |
| 外部テーブル | 抽出されていません。 Azure Database for PostgreSQL フレキシブル サーバーではサーバー ファイルシステムにアクセスできないため、file_fdwは使用できません。 |
クライアント側の \copy または COPY ... FROM STDIN、azure_storage 拡張子を使うか、またはご使用のアプリケーションから、テーブルにファイルを読み込みます。 |
| Advanced Queuing (AQ) テーブル | 抽出されていません。 Oracle Advanced Queuing は、アプリケーション ロジックを処理します。 | アプリケーション キュー、PostgreSQL 拡張機能、または Azure メッセージング サービスを使用してそれを再設計します。 |
| ブロックチェーン テーブル | 未抽出。 | 整合性要件をアプリケーション層に再実装します。 |
| クラスターとハッシュ クラスター | 抽出されません。 | プレーン テーブルまたはパーティション テーブルとして再作成します。 |
ディレクトリ オブジェクト (CREATE DIRECTORY) |
抽出されていません。 | アプリケーション層のファイル アクセスを処理します。 |
ユーザー定義インデックスの種類 (CREATE INDEXTYPE) |
抽出されていません。 | 存在する場合は、PostgreSQL 拡張機能インデックスを使用してアクセス方法を再作成します。 |
| データベース リンク | 変換されていません。 詳細については、「データベースリンク」を参照してください。 | 外部データ ラッパーを使用して再作成します。 |
| Synonym | 一部のシノニム (パッケージ、プロシージャ、またはシーケンスを参照するものを含む) は変換されない場合があります。 | ターゲット マッピングを確認し、適切な PostgreSQL オブジェクトを参照するように依存 SQL を更新します。 |
アプリケーションコンテキスト (CREATE CONTEXT、DBMS_SESSION.SET_CONTEXT) |
抽出されていません。 | コンテキストを PostgreSQL セッション設定にマップし、 current_setting()で読み取ります。 |
| 分析ビュー、属性ディメンション、階層、OLAP ディメンション、データ マイニング モデル、マテリアライズド・ゾーン・マップ | 抽出されていません。 これらは PostgreSQL ターゲットを持っていません。 | 必要な出力をビューまたは関数として再構築するか、削除してください。 |
LOB ストレージ句、登録済み XML スキーマ (DBMS_XMLSCHEMA.REGISTERSCHEMA)、および XML スキーマ バインド インデックス |
抽出されていません。 | ターゲットでストレージまたは検証の要件を見直します。 |
| Resource Managerプランとコンシューマー グループ、SQL プロファイル、SQL プラン ベースライン、エディション、SQL 翻訳プロファイル、情報ライフサイクル管理ポリシー、ロックダウン プロファイル、ワークスペース マネージャー オブジェクト | 抽出されていません。 これらは、Oracleインスタンス、オプティマイザー、またはライフサイクル成果物であり、対象外です。 | アプリケーション レイヤーまたはインフラストラクチャ レイヤーでそれらを再作成するか、Azure Database for PostgreSQL 上から削除します。 |
データベース リンク
このツールは、プライベート データベース リンクとパブリック データベース リンク (CREATE DATABASE LINK、 CREATE PUBLIC DATABASE LINK) を自動的に変換しません。 データベース リンクには、PostgreSQL に直接変換されない資格情報とリモート エンドポイント情報が格納されます。
postgres_fdwやoracle_fdwなどの PostgreSQL 外部データ ラッパーを使用してターゲット上でこれらのリンクを再作成するか、アプリケーション レベルの接続にリファクターします。 Oracle ソースで @link への参照を検索し、シノニムとビュー内の参照を含むすべての依存関係を見つけられるようにします。
セキュリティおよび ID オブジェクト
セキュリティ オブジェクトと ID オブジェクトの自動変換はサポートされていません。 変換されたスキーマ DDL とは別に、ユーザー、ロール、特権、およびデータ保護ポリシーを計画および検証します。 Oracle ソース インベントリを使用して、必要なアクセス制御を識別します。 検出リストまたは抽出されたメタデータでは、変換のサポートが確立されたり、アクセス制御がターゲットで構成されていることを確認したりすることはありません。
| オブジェクトの種類 | 制限事項 | 何をすべきか |
|---|---|---|
| User | 自動変換はサポートされていません。 | Azure 上でログインを個別にプロビジョニングします。 各ユーザーを PostgreSQL ロールとして再作成し、そのアクセス権を本番稼働を開始する前に検証します。 |
| Role | 自動変換はサポートされていません。 | ターゲット上で各ロールを再作成してください。 |
| システム特権 | 自動変換はサポートされていません。 | 必要なアクセス権を PostgreSQL 特権にマップし、適切な GRANT ステートメントを適用します。 |
| ロールのメンバーシップ | 自動変換はサポートされていません。 |
GRANT <role> TO <role> ステートメントとして再作成します。 |
| オブジェクト権限と付与 | ソース許可メタデータでは、同等のターゲット アクセス許可は構成されません。 | ソース インベントリから許可を再作成し、検証します。 |
行レベルのセキュリティと仮想プライベート データベース (DBMS_RLS) |
変換されていません。 | PostgreSQL 行レベルのセキュリティ ポリシーとしてポリシーを再作成します。 |
| Oracle Label Security | 変換されません。 | ターゲットのデータ アクセス境界を再設計します。 |
データの秘匿化 (DBMS_REDACT) |
変換されませんでした。 | ターゲットに対して、アプリケーション レイヤーまたは PostgreSQL と同等の機能を使用してマスクを再適用します。 |
プロファイル、パスワード ポリシー、統合またはきめ細かい監査ポリシー (DBMS_FGA、 AUDIT POLICY) |
自動変換はサポートされていません。 | 同等の Azure サーバー パラメーターと監査を構成し、それらを Infrastructure as Code として管理します。 |
Important
行レベルのセキュリティ、Virtual Private Database、Oracle Label Security、またはデータ秘匿化保護がない場合、Oracle でフィルタリングまたはマスクされた行または値が公開される可能性があります。 運用トラフィックをターゲットにルーティングする前に、同等の保護を実装し、有効にアクセスできることを確認します。
Scheduler オブジェクト
Oracle スケジューラ オブジェクトの自動変換はサポートされていません。 スケジューリングとオーケストレーションは別々に行います。 Discovery に表示されるオブジェクトがあっても、変換がサポートされることにはなりません。
| オブジェクトの種類 | 制限事項 | 何をすべきか |
|---|---|---|
DBMS_SCHEDULER ジョブとスケジュール |
自動変換はサポートされていません。 |
pg_cron を使用してターゲットでスケジュールを再作成するか、Azure Logic Apps や Azure Functions などの外部スケジューラを使用します。 |
レガシ DBMS_JOB ジョブ |
自動変換はサポートされていません。 |
pg_cronまたはアプリケーション スケジューラを使用してスケジュールを再作成します。 |
| プログラム、チェーン、資格情報、ファイル 監視、ジョブ クラス、グループ、ウィンドウ、およびイベント ベースのジョブ | 自動変換はサポートされていません。 | 外部スケジューラでオーケストレーションをリビルドします。 |
機能レベルのギャップ
オブジェクト型ではなく Oracle の機能を次に示します。 有効な PostgreSQL DDL の作成以外の変更が必要な場合があります。 変換結果に機能レベルの違いが個別のオブジェクトとして表示されない可能性があるため、ソース インベントリと変換された定義を確認してください。
| 特徴 | 制限事項 | 何をすべきか |
|---|---|---|
| ハイブリッド パーティション テーブル (Oracle 19.3 以降) | 通常のテーブルとして変換され、外部パーティションは失われます。 | ソース内のハイブリッド パーティション テーブルを特定し、外部データを個別に読み込みます。 |
| エディションビューとクロスエディショニング・トリガー | PostgreSQL ビューまたはトリガー定義だけでは、同等のエディションベースの動作は確立されません。 | 1 つのエディションを変換し、バージョンのロールアウト中にオブジェクトの可視性とトリガーの動作を検証します。 |
| 不変テーブル (Oracle 19.11 以降) | 検出されず、PostgreSQL に相当するものはありません。 | アプリケーション レイヤーまたはトリガーで要件を適用します。 |
| フラッシュバック データ アーカイブ | テンポラル履歴はモデル化されていません。 | ターゲット上で履歴テーブル パターンまたはテンポラル拡張を使用します。 |
フラッシュバッククエリ (AS OF TIMESTAMP, AS OF SCN) |
変換されていません。 | 行の履歴バージョンを読み取るクエリを書き換える。 |
| Oracle シャーディング | モデル化されておらず、PostgreSQLで単一データベースに相当するものはありません。 | 配布戦略を再設計します。 |
BFILE および SecureFile LOB の詳細 |
外部ファイルの内容と LOB ストレージの動作には、個別の移行計画が必要です。 | Oracle 固有の LOB 機能に対する外部ファイル参照と依存関係を確認します。 ターゲットのストレージとアクセス パターンを計画し、テストします。 |
ID 列、仮想列と生成列、非表示列、グローバル一時テーブルが変換された場合でも、アプリケーションを使用してそれらの定義と動作を検証します。 値の生成、列の可視性、一時的なデータの有効期間、およびトランザクションの動作を確認します。 プライベート一時テーブルは実行時にのみ存在するため、ソース インベントリには表示されません。
運用上の境界
移行を計画するときは、次の制約に留意してください。
- スキーマ変換では、行データは移行されません。 スキーマ変換とは別に、データ移行とデータ検証を計画します。
- 変換の再実行はサポートされていません。 変換オブジェクト エクスプローラーを使用して、生成された PostgreSQL 定義を確認して修正します。 編集した定義を手動でコンパイルし、デプロイする予定の修正がデプロイ SQL に含まれていることを確認します。
- スクラッチ スキーマが再作成されます。 選択した Oracle スキーマに対応する既存のスクラッチ スキーマは、
DROP SCHEMA ... CASCADEで削除され、再作成されます。 保持する必要があるオブジェクトやデータがない空または専用の未使用のスクラッチ データベースを使用します。 スクラッチ データベースの準備を参照してください。 - デプロイは別の操作です。 セットアップ ファイルを生成しても、Azure Database for PostgreSQL移行先サーバーに対して実行されることはありません。 セットアップ エクスペリエンスの説明に従って、手順を確認し、生成されたスクリプトを実行し、展開とオブジェクト検証の結果を検査します。
ヘルプを取得する
制限が発生した場合:
- オブジェクト定義と変換メモについては、変換オブジェクト エクスプローラーを確認してください。 オブジェクトの変換を理解するには Ask を使用し、その PostgreSQL ファイルに Copilot 支援の変更を加えるには Fix を使用します。
- 代替実装については、PostgreSQL のドキュメントを参照してください。
- Oracle から Azure Database for PostgreSQL への移行パターンのベスト プラクティスを確認します。
- 本番環境にデプロイする前に、非本番環境でテストします。