Known issues, limitations, and notes ==================================== これらは、次の既知の問題、制限、および注意事項です。 - :ref:`Migration Portal 4.0.0 release notes ` - :ref:`EDB DDLエクストラクタを使用したスキーマの抽出 ` - :ref:`Extracting schemas using Oracle Data Pump utilities ` Migration Portal ---------------- ラップされたオブジェクト ^^^^^^^^^^^^^^^^^^^^^^^^ Migration Portalは、ラップされたオブジェクトを評価できません。抽出されたDDLにそれらを含める場合、それらはMigration Portalにロードされず、評価されるオブジェクトの数に含まれません。ラップされたオブジェクトを評価し、 EDB Postgres Advanced Serverに移行する場合は、Migration PortalにアップロードするDDLファイルにオブジェクトのラップされていないバージョンを含めます。これを行うことをお勧めします。スキーマ抽出を実行する前に、Oracleデータベース内のラップされたバージョンをクリアテキストバージョンに置き換えることです。スキーマ抽出を実行した後、オブジェクトをラップされたバージョンに置き換えることができます。 ファイルエンコード ^^^^^^^^^^^^^^^^^^ Migration Portalは、 ``.SQL`` 出力ファイルをUTF-8エンコード形式にすることをお勧めします。非UTF-8エンコードを使用して\ ``.SQL`` ファイルをアップロードする場合、 UTF-8と互換性のないすべての文字は、出力DDLで置換文字 \`� に変換されます。 .. Tip:: Linuxではiconvユーティリティ、またはWindowsLibIconvユーティリティを使用して、抽出したファイルをUTF-8形式に手動で変換できます。たとえば、データベースキャラクタセットがLatin-1 ISO-8859-1である場合、次のように、抽出したファイルをUTF-8形式に変換できます。`iconv -f iso-8859-1 -t UTF-8 sample.sql > sample_utf8.sql` ALTERステートメント ^^^^^^^^^^^^^^^^^^^ ``ALTER PROFILE DEFAULT`` 、\ ``ALTER TABLE`` 、および\ ``ALTER TRIGGER`` を除き、Migration PortalはDDL内の他の\ ``ALTER`` ステートメントを処理しません。 ユーザー、ロール、プロファイル、および付与 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 付与 ^^^^ Migration Portalは、抽出およびアップロードされたスキーマのOracleユーザーの評価と移行をサポートするようになりました。プロジェクトに関連付けられているスキーマのすべてのユーザー、ロール、およびプロファイルは、Migration Portalビューの\ ``GLOBAL_OBJECTS`` 擬似スキーマの下にグループ化されます。現在、システム特権、オブジェクト特権、およびロールの付与は、ユーザーオブジェクトのDDLに含まれています。同様に、ロールへのシステム特権およびオブジェクト特権の付与は、ロールオブジェクトのDDLに含まれます。 付与は現在ユーザーとロールオブジェクトにアタッチされているため、ユーザーに権限が付与されている1つ以上のオブジェクトに障害が発生すると、ユーザーオブジェクト自分自身は評価に不合格になります。この問題を解決するには、個々のステートメントのSQL単一行コメント\ ``--`` または連続するgrantステートメントのSQL複数行コメント\ ``/ ** /`` を使用して、障害が発生したオブジェクトのgrantステートメントをコメントアウトし、オブジェクトの再評価ができます。実行されます。失敗したgrantステートメントに対応する障害のあるオブジェクトが修復された後、以前に失敗したgrantステートメントのコメントを外し、ユーザーオブジェクトを再評価できます。 RESOURCEロールの付与は、被付与者と同じ名前を共有するスキーマのCREATEおよびUSAGE特権を付与することと同じです。 RESOURCEロールを付与する場合は、最初にユーザーまたはロールと同じ名前でスキーマを作成する必要があります。それ以外の場合、「スキーマは存在しません」エラーが発生します。 特権 ^^^^ スキーマをターゲットEDB Postgres Advanced Serverデータベースに移行するには、移行の実行に使用されるターゲットデータベースユーザーに次の特権が必要です。 - ``SUPERUSER`` プロファイルを移行する - ユーザーとロールを移行するための\ ``SUPERUSER`` または\ ``CREATE ROLE`` パスワード ^^^^^^^^^^ ユーザーを移行する際、Migration Portalはユーザーのパスワードを移行しません。ユーザーは、パスワードなしでターゲットEDB Postgres Advanced Serverデータベースに作成されます。ユーザーをパスワードで構成することが望ましいまたは必要な場合、これはユーザーが移行された後、ターゲットデータベースで手動で行うことができます。 プロファイル ^^^^^^^^^^^^ Migration Portalは、スキーマユーザーに割り当てられた非\ ``DEFAULT`` プロファイルを移行します。 Oracleプロファイルには、パスワードとリソース制限の両方が含まれます。 EDB Postgres Advanced Serverは、Oracleパスワード関連の制限のみをサポートしています。リソース制限はプロファイルで抽出されますが、Migration Portalはパスワード制限のみをアップロード、評価、および移行します。また、\ ``DEFAULT`` プロファイルは、Oracleデータベースで新しい制限値でオーバーライドされる場合があります。 EDB DDLエクストラクタは、Oracleデータベースでオーバーライドされる\ ``DEFAULT`` プロファイルの\ ``ALTER PROFILE`` ステートメントを抽出し、Migration PortalはこれらのステートメントをターゲットEDB Postgres Advanced Serverデータベースに適用しようとします。スキーマを既存のユーザーとデータベースを含むEDB Postgres Advanced Serverインスタンスに移行する場合、 DDLをターゲットデータベースに移行する前に、必要に応じて\ ``ALTER PROFILE DEFAULT`` ステートメントの設定を検証および更新することをお勧めします。 .. Note:: バージョン4.3.0以降、Migration Portalは、ユーザー、ロール、プロファイル、および付与の評価をサポートしています。ただし、Migration Portalの4.3.0より前のバージョンを使用して作成されたプロジェクトの場合、この機能はサポートされていません。ユーザー、ロール、プロファイル、および付与を評価するには、最新バージョンのEDB DDLエクストラクタを使用し、新しいプロジェクトを作成します。 Oracleのデフォルトの場合を使用する ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Oracleのデフォルトの大文字小文字機能を使用するオプションは、OracleデータベースからEDB Postgres Advanced Serverデータベースにスキーマを移行するときに、すべてのデータベースオブジェクトのOracleのデフォルトの大文字命名規則を保持します。 EDB DDLエクストラクタおよびOracle Data Pumpユーティリティは、 PL/ SQLの本文内で参照されているオブジェクト名を除き、Oracleのデフォルトの大文字小文字つまりオブジェクト名の大文字または大文字と小文字が区別されるオブジェクト名のそれぞれの大文字と小文字ですべてのDDLを抽出しますDDLの作成時にユーザーが明示的に二重引用符で囲まれない限り、オブジェクト。 したがって、Migration Portalは、この機能のソーススキーマファイルからすべての二重引用符を保持し、さらに、Migration Portalは以下に二重引用符を適用します。 - ビューおよびマテリアライズドビューの\ ``SELECT`` ステートメント内の列名。 - チェック制約内のカラム名。 - トリガーヘッダー内のテーブル名と列名。 Oracle大文字小文字を使用するオプションが選択されていない場合、Migration Portalのデフォルト動作は、すべてのオブジェクトが小文字EDB Postgres Advanced Serverのデフォルトの大文字または引用符で囲まれた大文字と小文字の混合を使用してオブジェクト名が指定されている場合は大文字と小文字が混合で作成されることですソースDDLで 。 useOraCase機能を使用して、以下のソースDDLとターゲットDDLを見つけます。 .. code:: sql - - 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の大文字と小文字を保持するために二重引用符で囲まれている大文字であるのに対し、障害が発生したオブジェクトでは二重引用符なしで参照されるという事実によって発生します。例 .. code:: sql 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 ; エラーは次のように表示されます。 edb_notranlate_2 上記の例では、テーブル名とその列名は\ ``CREATE TABLE`` ステートメントで引用符で囲まれた大文字の名前で指定されています。ただし、 ``CREATE OR REPLACE PROCEDURE`` ステートメントでは、テーブルとその列は、引用符で囲まれていない小文字の識別子を使用して参照されます。 - ``%type`` を使用して定義された変数は、前述の\ ``table.column-name`` が\ ``employees.employee_id%type`` のように小文字であるのに対し、実際のテーブルのテーブル名と列名は二重引用符で囲まれた大文字であるため、コードオブジェクトで失敗します。例 .. code:: sql 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; エラーは次のように表示されます。 .. code:: sql syntax error at or near "%" (line 3, char 37) - テーブルの列データ型にTYPE参照がある場合、大文字と小文字の違いが原因で失敗します。例 .. code:: sql 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 ); エラーは次のように表示されます。 .. code:: sql type "user_type" does not exist LINE 4: "MY_NAME" user_type ^ SQL state: 42704 Character: 58 EDB DDLエクストラクタ --------------------- - EDB DDLエクストラクタスクリプトは、 ``Flashback`` を使用して復元されたオブジェクトで、 ``BIN$b54+4XlEYwPgUAB/AQBWwA==$0`` のような名前が残っているオブジェクトを抽出しません。これらのオブジェクトを抽出する場合は、オブジェクトの名前を変更し、抽出プロセスを再実行する必要があります。 - EDB DDLエクストラクタは、\ ``nologging`` テーブルを通常のテーブルとして抽出します。これらのテーブルがEDB Postgres Advanced Serverに移行されると、WALログファイルが作成されます。 - EDB DDLエクストラクタは、\ ``VALID`` ステータスでのみオブジェクトを抽出します。Migration Portalで評価する\ ``INVALID`` ステータスを持つオブジェクトについては、最初に\ ``VALID`` に更新します。 - EDB DDLエクストラクタは、Oracleのラップ機能を使用して難読化されたオブジェクトを抽出しません。そのため、これらのオブジェクトは、Migration Portalによって評価されるDDLのセットには含まれません。これらのオブジェクトを評価し、 EDB Postgres Advanced Serverに移行する場合は、オブジェクトのラップされたバージョンを非ラップバージョンに置き換えます。詳細については、 :ref:`ラップされたオブジェクト <ラップされたオブジェクト>` を参照してください。 - EDB DDLエクストラクタは、グローバル一時テーブルを作成して、スキーマ名とその依存関係情報を保存します。これらのテーブルは、抽出が成功した最後に削除されます。 - PostgreSQLがサポートしていないため、EDB DDLエクストラクタスクリプトは、名前が\ ``PG_`` で始まるスキーマを抽出しません。これらのスキーマを抽出する場合は、抽出前にスキーマの名前を変更する必要があります。 - EDB DDLエクストラクタは、プロファイル、ロール、および付与の情報を自動的に抽出します。 - EDB DDLエクストラクタは、現在Oracle 11gからの\ ``ROLES`` 、\ ``SYSTEM GRANTS ON ROLES`` 、\ ``OBJECT GRANTS ON ROLES`` 、および\ ``ROLE GRANTS`` の抽出をサポートしていません。この動作により、エラーメッセージがこれらのオブジェクトタイプに対応するセクションの抽出されたファイルに書き込まれます。これらのエラーは、Migration Portalによるこれらのファイルの評価において問題を発生させることはありません。 - EDB DDLエクストラクタスクリプトは、抽出されたファイルの依存オブジェクトセクションに\ ``object "OBJECT_NAME" of type SYNONYM not found in schema "PUBLIC"`` エラーをログに記録する場合があります。これは、OracleデータベースがコンテナデータベースであるOracleマルチテナント環境から依存オブジェクトを抽出するオプションをユーザーが選択した場合にのみ発生します。 Oracle Data Pumpユーティリティ ------------------------------ - Oracleの引用演算子\ ``IDENTIFIED BY VALUES q'[:1]'`` などと\ ``IDENTIFIED BY`` 句を使用してデータベースリンクを作成する場合、Migration PortalはSQLファイルの解析に失敗する場合があります。ファイルを正常に解析するには、実際のパスワード、たとえば、\ ``IDENTIFIED BY my_password`` を使用してみてください。 - Oracle Data Pumpユーティリティによって生成されたDDLには、 ``ALTER FUNCTION`` 、\ ``ALTER PACKAGE`` 、\ ``ALTER TYPE`` などの\ ``ALTER STATEMENTS`` が含まれる場合があります。これらはMigration Portalによって処理されません。 - Oracle Data Pumpがスキーマモードで実行される場合、つまり、 ``expdp`` コマンドの実行時に\ ``SCHEMAS`` パラメーターが使用される場合、プロファイルとロールは抽出されません。エクスポートされるスキーマユーザーにプロファイルが割り当てられている場合、プロファイルはエクスポートされた\ ``impdp`` ファイルの一部ではないため、Migration Portalでのスキーマユーザーオブジェクトの評価は失敗します。この問題を修正するには、ユーザーオブジェクトターゲットDDLのプロファイルの割り当てを削除し、ユーザー作成オブジェクトを再評価します。 - スキーマモードで\ ``impdp`` または\ ``expdp`` を使用してOracle 11gから\ ``ROLES`` 、\ ``SYSTEM GRANTS ON ROLES`` 、\ ``OBJECT GRANTS ON ROLES`` 、および\ ``ROLE GRANTS`` を抽出しようとしているときに、いくつかのエラーが表示される場合があります。回避策は、 ``full=y`` オプションを使用することです。これは、エラーなしですべてのスキーマとこれらのオブジェクトタイプを抽出します。