Known issues, limitations, and notes#

これらは、次の既知の問題、制限、および注意事項です。

Migration Portal#

ラップされたオブジェクト#

移行ポータルは、ラップされたオブジェクトを評価できません。抽出されたDDLにそれらを含める場合、それらは移行ポータルにロードされず、評価されるオブジェクトの数に含まれません。ラップされたオブジェクトを評価し、 EDB Postgres Advanced Serverに移行する場合は、移行ポータルにアップロードするDDLファイルにオブジェクトのラップされていないバージョンを含めます。これを行うことをお勧めします。スキーマ抽出を実行する前に、Oracleデータベース内のラップされたバージョンをクリアテキストバージョンに置き換えることです。スキーマ抽出を実行した後、オブジェクトをラップされたバージョンに置き換えることができます。

削除されたオブジェクト#

一部のサポートされていないOracleオブジェクトは、移行ポータルがソースDDLファイルを評価するときに削除されます。これらの削除されたオブジェクトは変換手順から除外され、移行ポータル評価で削除されたとしてフラグが立てられません。

次のオブジェクトは、スキーマ評価中に削除されます。

MATERIALIZED VIEWS に関連するオブジェクトたとえば、MVIEW をサポートするように作成されたバックエンドTABLE またはINDEX ステートメント
Queues 関連オブジェクト
Nested Tables 関連オブジェクト
XMLType Tables 関連オブジェクト
SYSTEM Schemas に依存する型
PRIMARY KEY およびUNIQUE コンストレインに関連するインデックス
サポートされていないシステムGRANT 特権

EDBは、 CREATE DATABASE LINK 、CREATE PUBLIC DATABASE LINK 、DROP PUBLIC DATABASE LINK 、およびEXEMPT ACCESS POLICY システム権限の付与のみをサポートしています。他のGRANT ステートメントはサポートされておらず、 DDLファイルから削除されます。

ファイルエンコード#

移行ポータルは、 .SQL 出力ファイルをUTF-8エンコード形式にすることをお勧めします。非UTF-8エンコードを使用して.SQL ファイルをアップロードする場合、 UTF-8と互換性のないすべての文字は、出力DDLで置換文字 `� に変換されます。

Tip

Linuxではiconvユーティリティ、またはWindowsではLibIconvユーティリティを使用して、抽出したファイルをUTF-8形式に手動で変換できます。たとえば、データベースキャラクタセットがLatin-1 ISO-8859-1である場合、次のように、抽出したファイルをUTF-8形式に変換できます。

iconv -f iso-8859-1 -t UTF-8 sample.sql > sample_utf8.sql

ホワイトラベルエラー#

移行ポータルの新しいバージョンがリリースされると、移行ポータルを開くことができない問題が発生する場合があります。 White label Error Page またはその他のエラーのようなエラーにより、移行ポータルを使用できません。ブラウザーに保存されているキャッシュデータがこのエラーの原因となります。これが発生した場合は、ブラウザ履歴からキャッシュデータをクリアするか、シークレット/プライベートウィンドウを使用して移行ポータルにアクセスします。

ALTERステートメント#

ALTER PROFILE DEFAULT 、ALTER TABLE 、およびALTER TRIGGER を除き、移行ポータルはDDL内の他のALTER ステートメントを処理しません。

ユーザー、ロール、プロファイル、および付与#

付与#

移行ポータルは、抽出およびアップロードされたスキーマのOracleユーザーの評価と移行をサポートするようになりました。プロジェクトに関連付けられているスキーマのすべてのユーザー、ロール、およびプロファイルは、移行ポータルビューのGLOBAL_OBJECTS 擬似スキーマの下にグループ化されます。現在、システム特権、オブジェクト特権、およびロールの付与は、ユーザーオブジェクトのDDLに含まれています。同様に、ロールへのシステム特権およびオブジェクト特権の付与は、ロールオブジェクトのDDLに含まれます。

付与は現在ユーザーとロールオブジェクトにアタッチされているため、ユーザーに権限が付与されている1つ以上のオブジェクトに障害が発生すると、ユーザーオブジェクト自分自身は評価に不合格になります。この問題を解決するには、個々のステートメントのSQL単一行コメント-- または連続するgrantステートメントのSQL複数行コメント/ ** / を使用して、障害が発生したオブジェクトのgrantステートメントをコメントアウトし、オブジェクトの再評価ができます。実行されます。失敗したgrantステートメントに対応する障害のあるオブジェクトが修復された後、以前に失敗したgrantステートメントのコメントを外し、ユーザーオブジェクトを再評価できます。

RESOURCEロールの付与は、被付与者と同じ名前を共有するスキーマのCREATEおよびUSAGE特権を付与することと同じです。 RESOURCEロールを付与する場合は、最初にユーザーまたはロールと同じ名前でスキーマを作成する必要があります。それ以外の場合、「スキーマは存在しません」エラーが発生します。

特権#

スキーマをターゲットEDB Postgres Advanced Serverデータベースに移行するには、移行の実行に使用されるターゲットデータベースユーザーに次の特権が必要です。

SUPERUSER プロファイルを移行する
ユーザーとロールを移行するためのSUPERUSER またはCREATE ROLE

パスワード#

ユーザーを移行する際、移行ポータルはユーザーのパスワードを移行しません。ユーザーは、パスワードなしでターゲットEDB Postgres Advanced Serverデータベースに作成されます。ユーザーをパスワードで構成することが望ましいまたは必要な場合、これはユーザーが移行された後、ターゲットデータベースで手動で行うことができます。

プロファイル#

移行ポータルは、スキーマユーザーに割り当てられた非DEFAULT プロファイルを移行します。 Oracleプロファイルには、パスワードとリソース制限の両方が含まれます。 EDB Postgres Advanced Serverは、Oracleパスワード関連の制限のみをサポートしています。リソース制限はプロファイルで抽出されますが、移行ポータルはパスワード制限のみをアップロード、評価、および移行します。また、DEFAULT プロファイルは、Oracleデータベースで新しい制限値でオーバーライドされる場合があります。 EDB DDLエクストラクタは、 OracleデータベースでオーバーライドされるDEFAULT プロファイルのALTER PROFILE ステートメントを抽出し、移行ポータルはこれらのステートメントをターゲットEDB Postgres Advanced Serverデータベースに適用しようとします。スキーマを既存のユーザーとデータベースを含むEDB Postgres Advanced Serverインスタンスに移行する場合、 DDLをターゲットデータベースに移行する前に、必要に応じてALTER PROFILE DEFAULT ステートメントの設定を検証および更新することをお勧めします。

注釈

バージョン4.3.0以降、移行ポータルは、ユーザー、ロール、プロファイル、および付与の評価をサポートしています。ただし、移行ポータルの4.3.0より前のバージョンを使用して作成されたプロジェクトの場合、この機能はサポートされていません。ユーザー、ロール、プロファイル、および付与を評価するには、最新バージョンのEDB DDLエクストラクタを使用し、新しいプロジェクトを作成します。

Oracleのデフォルトの場合を使用する#

Oracleのデフォルトの大文字小文字機能を使用するオプションは、OracleデータベースからEDB Postgres Advanced Serverデータベースにスキーマを移行するときに、すべてのデータベースオブジェクトのOracleのデフォルトの大文字命名規則を保持します。

EDB DDLエクストラクタおよびOracle Data Pumpユーティリティは、 PL/ SQLの本文内で参照されているオブジェクト名を除き、Oracleのデフォルトの大文字小文字つまりオブジェクト名の大文字または大文字と小文字が区別されるオブジェクト名のそれぞれの大文字と小文字ですべてのDDLを抽出しますDDLの作成時にユーザーが明示的に二重引用符で囲まれない限り、オブジェクト。

したがって、移行ポータルは、この機能のソーススキーマファイルからすべての二重引用符を保持し、さらに、移行ポータルは以下に二重引用符を適用します。

ビューおよびマテリアライズドビューのSELECT ステートメント内の列名。
チェック制約内のカラム名。
トリガーヘッダー内のテーブル名と列名。

Oracle大文字小文字を使用するオプションが選択されていない場合、移行ポータルのデフォルト動作は、すべてのオブジェクトが小文字EDB Postgres Advanced Serverのデフォルトの大文字または引用符で囲まれた大文字と小文字の混合を使用してオブジェクト名が指定されている場合は大文字と小文字が混合で作成されることですソースDDLで。

useOraCase機能を使用して、以下のソースDDLとターゲットDDLを見つけます。

- - Source DDL
CREATE TABLE "RHS_SANITY"."DEPT"
   (    "DEPTNO" NUMBER(2,0),
    "DNAME" VARCHAR2(14),
    "LOC" VARCHAR2(14),
     CONSTRAINT "DEPTDEPTNO_PK" PRIMARY KEY ("DEPTNO")
  USING INDEX  ENABLE,
     CONSTRAINT "DEPTDNAME_UK" UNIQUE ("DNAME")
  USING INDEX  ENABLE
   ) ;

- - Target DDL
CREATE TABLE "RHS_SANITY"."DEPT"
   (    "DEPTNO" NUMBER(2,0),
    "DNAME" VARCHAR2(14),
    "LOC" VARCHAR2(14),
     CONSTRAINT "DEPTDEPTNO_PK" PRIMARY KEY ("DEPTNO")
  USING INDEX  ENABLE,
     CONSTRAINT "DEPTDNAME_UK" UNIQUE ("DNAME")
  USING INDEX  ENABLE
   ) ;

Oracleのデフォルトのケースを使用している間、他のプロジェクトと比べて互換性率が低下する場合があります。次に、この互換性率の低下の原因と考えられる理由を示します。

最も一般的な理由は、オブジェクト/リレーションが存在しないことです。このシナリオは、テーブル/オブジェクトがOracleの大文字と小文字を保持するために二重引用符で囲まれている大文字であるのに対し、障害が発生したオブジェクトでは二重引用符なしで参照されるという事実によって発生します。例

CREATE TABLE "HR"."EMP"
   (   "EMPNO" NUMBER(4,0),
       "ENAME" VARCHAR2(10),
       "JOB" CLOB,
       "MGR" NUMBER(4,0),
       "HIREDATE" DATE,
       "SAL" NUMBER(7,2),
       "COMM" NUMBER(7,2),
       "DEPTNO" NUMBER(2,0),
     CONSTRAINT "PK_EMP" PRIMARY KEY ("EMPNO")
  USING INDEX  ENABLE
   ) ;

CREATE OR REPLACE  PROCEDURE "HR"."PROC"
IS
 CURSOR emp_cur IS SELECT hiredate, CAST(hiredate AS timestamp(6)) AS timestamped FROM emp;
 REC emp_cur%rowtype;
BEGIN
   OPEN emp_cur;
   LOOP
   FETCH emp_cur INTO rec;
     EXIT WHEN emp_cur%NOTFOUND ;
            DBMS_OUTPUT.PUT_LINE(rec.hiredate ||  ||rec.timestamped);
         END LOOP;
    CLOSE EMP_CUR;
   END ;

エラーは次のように表示されます。

relation "emp" does not exist

上記の例では、テーブル名とその列名はCREATE TABLE ステートメントで引用符で囲まれた大文字の名前で指定されています。ただし、 CREATE OR REPLACE PROCEDURE ステートメントでは、テーブルとその列は、引用符で囲まれていない小文字の識別子を使用して参照されます。

%type を使用して定義された変数は、前述のtable.column-name がemployees.employee_id%type のように小文字であるのに対し、実際のテーブルのテーブル名と列名は二重引用符で囲まれた大文字であるため、コードオブジェクトで失敗します。例

CREATE TABLE "HR"."EMPLOYEES"
   (    "EMPLOYEE_ID" NUMBER(6,0),
        "FIRST_NAME" VARCHAR2(20),
        "LAST_NAME" VARCHAR2(25) CONSTRAINT "EMP_LAST_NAME_NN" NOT NULL ENABLE,
        "EMAIL" VARCHAR2(25) CONSTRAINT "EMP_EMAIL_NN" NOT NULL ENABLE,
        "PHONE_NUMBER" VARCHAR2(20),
        "HIRE_DATE" DATE CONSTRAINT "EMP_HIRE_DATE_NN" NOT NULL ENABLE,
        "JOB_ID" VARCHAR2(10) CONSTRAINT "EMP_JOB_NN" NOT NULL ENABLE,
        "SALARY" NUMBER(8,2),
        "COMMISSION_PCT" NUMBER(2,2),
        "MANAGER_ID" NUMBER(6,0),
        "DEPARTMENT_ID" NUMBER(4,0),
         CONSTRAINT "EMP_SALARY_MIN" CHECK ("SALARY" > 0) ENABLE,
         CONSTRAINT "EMP_EMP_ID_PK" PRIMARY KEY ("EMPLOYEE_ID")
  USING INDEX  ENABLE,
         CONSTRAINT "EMP_EMAIL_UK" UNIQUE ("EMAIL")
  USING INDEX  ENABLE
   ) ;
CREATE OR REPLACE  PROCEDURE "HR"."PKG" AS
-- declare variables for data fetched from cursor
  empid       employees.employee_id%TYPE; -- variable for employee_id
  hiredate    employees.hire_date%TYPE;   -- variable for hire_date
  firstname   employees.first_name%TYPE;  -- variable for first_name
  lastname    employees.last_name%TYPE;   -- variable for last_name
  rowcount    NUMBER;
  bonusamount NUMBER;
  yearsworked NUMBER;
-- declare the cursor with a parameter
  CURSOR cursor1 (thismonth NUMBER)IS
    SELECT employee_id, first_name, last_name, hire_date FROM employees
       WHERE EXTRACT(MONTH FROM hire_date) = thismonth;
BEGIN
  null;
END;

エラーは次のように表示されます。

syntax error at or near "%" (line 3, char 37)

テーブルの列データ型にTYPE参照がある場合、大文字と小文字の違いが原因で失敗します。例

CREATE OR REPLACE TYPE "HR"."USER_TYPE" IS OBJECT(
    "ID" NUMBER,
    "NAME" VARCHAR2(256)
);

CREATE TABLE "HR"."MY_TABLE"
(
    "ID" NUMBER,
    "MY_NAME" user_type
);

エラーは次のように表示されます。

type "user_type" does not exist
LINE 4:     "MY_NAME" user_type
              ^
SQL state: 42704
Character: 58

不完全なオブジェクト定義#

移行ポータルでソーススキーマを評価しているときに、まれに、ソースDDLに予約語が含まれている場合、変換されたオブジェクト定義が不完全です。

オブジェクト定義の一部が欠落しているか、ステートメントの実際の最後に到達する前に定義が終了する問題が発生した場合は、 EDB Postgres Advanced Serverによって予約されているキーワードを使用している可能性があります。たとえば、TABLE 定義で列名としてCONSTRAINT を使用し、VIEW またはMVIEW 定義で参照すると、移行ポータルはそのDDLステートメントを突然終了し、正常に評価または変換せずに次の定義にスキップする場合があります。

この問題をワークアラウンドには、次のいずれかのことができます。

Oracleデータベースの列名を変更し、 DDLを再抽出して移行ポータルにアップロードします。
抽出したDDLファイルの列名を変更し、移行ポータルにアップロードします。

EDB DDLエクストラクタ#

一般的な制限事項#

EDB DDLエクストラクタスクリプトは、 Flashback を使用して復元されたオブジェクトで、 BIN$b54+4XlEYwPgUAB/AQBWwA==$0 のような名前が残っているオブジェクトを抽出しません。これらのオブジェクトを抽出する場合は、オブジェクトの名前を変更し、抽出プロセスを再実行する必要があります。
EDB DDLエクストラクタは、nologging テーブルを通常のテーブルとして抽出します。これらのテーブルがEDB Postgres Advanced Serverに移行されると、WALログファイルが作成されます。
EDB DDLエクストラクタは、VALID ステータスでのみオブジェクトを抽出します。移行ポータルで評価するINVALID ステータスを持つオブジェクトについては、最初にVALID に更新します。
EDB DDLエクストラクタは、 Oracleのラップ機能を使用して難読化されたオブジェクトを抽出しません。そのため、これらのオブジェクトは、移行ポータルによって評価されるDDLのセットには含まれません。これらのオブジェクトを評価し、 EDB Postgres Advanced Serverに移行する場合は、オブジェクトのラップされたバージョンを非ラップバージョンに置き換えます。詳細については、ラップされたオブジェクトを参照してください。
EDB DDLエクストラクタは、グローバル一時テーブルを作成して、スキーマ名とその依存関係情報を保存します。これらのテーブルは、抽出が成功した最後に削除されます。
PostgreSQLがサポートしていないため、EDB DDLエクストラクタスクリプトは、名前がPG_ で始まるスキーマを抽出しません。これらのスキーマを抽出する場合は、抽出前にスキーマの名前を変更する必要があります。
EDB DDLエクストラクタは、プロファイル、ロール、および付与の情報を自動的に抽出します。
EDB DDLエクストラクタは、現在Oracle 11gからのROLES 、SYSTEM GRANTS ON ROLES 、OBJECT GRANTS ON ROLES 、およびROLE GRANTS の抽出をサポートしていません。この動作により、エラーメッセージがこれらのオブジェクトタイプに対応するセクションの抽出されたファイルに書き込まれます。これらのエラーは、移行ポータルによるこれらのファイルの評価において問題を発生させることはありません。
EDB DDLエクストラクタスクリプトは、抽出されたファイルの依存オブジェクトセクションにobject "OBJECT_NAME" of type SYNONYM not found in schema "PUBLIC" エラーをログに記録する場合があります。これは、OracleデータベースがコンテナデータベースであるOracleマルチテナント環境から依存オブジェクトを抽出するオプションをユーザーが選択した場合にのみ発生します。

「スナップショットが古すぎます」エラー#

EDB DDLエクストラクタは、データベースサーバーがUNDOテーブルスペースで適切に処理できない大量のトランザクションを生成すると、実行時にエラー「ORA-01555: snapshot too old」を表示します。

データベースサーバーが高いレートでUNDOトランザクションを生成すると、サーバーがUNDOデータを保存するための領域が不足する場合があります。 UNDOテーブルスペースは循環バッファとして実装されているため、古いUNDOデータブロックの上書きを開始します。このエラーを解決し、EDB DDLエクストラクタを再実行して、エラーなしでDDLを抽出します。

このエラーをワークアラウンドには、 UNDO_RETENTION パラメーターの割り当て領域を増やします。

最初に、元に戻す操作用に現在割り当てられている合計領域と現在の空き領域を確認します。

UNDO_RETENTION パラメーターの既存の値を確認します。

SELECT value FROM v$parameter WHERE name = undo_retention;

次の2つのクエリーの結果を加算して、UNDOテーブルスペースの使用可能な合計領域を確認します。

SELECT SUM(bytes)/1024/1024 free_mb FROM dba_undo_extents WHERE status=EXPIRED;

SELECT dfs.tablespace_name, SUM(dfs.bytes) / 1024 / 1024 AS free_mb FROM
dba_free_space dfs
JOIN dba_tablespaces dt ON dfs.tablespace_name = dt.tablespace_name
WHERE dt.contents = UNDO GROUP BY dfs.tablespace_name; 2 3 4

次に、環境が必要なMB数を決定し、割り当てられた記憶領域を増やします。

使用ピーク時間にトランザクションによって生成されたUNDOデータの量を監視します。

SELECT SUM(undoblks * 8192)/1024/1024 AS undo_mbs FROM v$undostat;

注釈

この値は、10分間隔で消費されたUNDOブロックの数を反映していますMBに変換!!!

ご使用の環境がUNDOテーブルスペースに必要な合計MB数を計算します。たとえば、トランザクションボリュームが1分ごとにX MBのUNDOデータを生成し、要件がY分間データを保持することである場合

UNDO領域MB = X MB/分×Y (分)

必要なMB単位の領域に応じて、UNDO_RETENTION パラメーターを更新します。この例では、記憶領域を2400 MBに増加します。

ALTER SYSTEM SET UNDO_RETENTION = 2400;
__OUTPUT__
System altered.

Oracle Data Pumpユーティリティ#

Oracleの引用演算子IDENTIFIED BY VALUES q'[:1]' などとIDENTIFIED BY 句を使用してデータベースリンクを作成する場合、移行ポータルはSQLファイルの解析に失敗する場合があります。ファイルを正常に解析するには、実際のパスワード、たとえば、IDENTIFIED BY my_password を使用してみてください。
Oracle Data Pumpユーティリティによって生成されたDDLには、移行ポータルによって処理されないALTER FUNCTION 、ALTER PACKAGE 、ALTER TYPE などのALTER STATEMENTS が含まれる場合があります。
Oracle Data Pumpがスキーマモードで実行される場合、つまり、 expdp コマンドの実行時にSCHEMAS パラメーターが使用される場合、プロファイルとロールは抽出されません。エクスポートされるスキーマユーザーにプロファイルが割り当てられている場合、プロファイルはエクスポートされたimpdp ファイルの一部ではないため、移行ポータルでのスキーマユーザーオブジェクトの評価は失敗します。この問題を修正するには、ユーザーオブジェクトターゲットDDLのプロファイルの割り当てを削除し、ユーザー作成オブジェクトを再評価します。
スキーマモードでimpdp またはexpdp を使用してOracle 11gからROLES 、SYSTEM GRANTS ON ROLES 、OBJECT GRANTS ON ROLES 、およびROLE GRANTS を抽出しようとしているときに、いくつかのエラーが表示される場合があります。回避策は、 full=y オプションを使用することです。これは、エラーなしですべてのスキーマとこれらのオブジェクトタイプを抽出します。

AIコパイロット#

AI Copilotは、DDLの移行中に発生する問題を支援するように設計されたツールです。このツールは問題の解決に非常に役立ちますが、生成AIテクノロジーは不正確または無関係な応答を生成する場合があることを理解することが重要です。推奨されるソリューションの精度と品質は、 How to create good prompts に大きく影響されます。

提案されたソリューションを運用環境に適用する前に、制御されたテスト環境でソリューションをテストして、提案された修正が特定の移行要件と一致することを確認することを強くお勧めします。

この最初のリリースでは、AIコパイロットの応答時間が予想よりも遅くなる場合があります。

Known issues, limitations, and notes

目次

Known issues, limitations, and notes#

Migration Portal#

ラップされたオブジェクト#

削除されたオブジェクト#

ファイルエンコード#

ホワイトラベルエラー#

ALTERステートメント#

ユーザー、ロール、プロファイル、および付与#

付与#

特権#

パスワード#

プロファイル#

Oracleのデフォルトの場合を使用する#

不完全なオブジェクト定義#

EDB DDLエクストラクタ#

一般的な制限事項#

「スナップショットが古すぎます」エラー#

Oracle Data Pumpユーティリティ#

AIコパイロット#