Oracle トランスポータブル表領域を使用した移行

Oracle ホームのオーナーとしてソースホストにログインします。

ORACLE_HOME および ORACLE_SID 環境変数がソースデータベースを指していることを確認してください。

管理者としてデータベースにログインし、タイムゾーンバージョン、DB 文字セット、および各国語文字セットがターゲットデータベースと同じであることを確認します。

SELECT * FROM V$TIMEZONE_FILE;
SELECT * FROM NLS_DATABASE_PARAMETERS 
  WHERE PARAMETER IN ('NLS_CHARACTERSET','NLS_NCHAR_CHARACTERSET');

Oracle Support ノート 2471245.1 の説明に従って、トランスポータブル表領域ユーティリティを設定します。

セットアップには、ソースホスト上の xtt.properties ファイルの編集が含まれます。次のサンプル xtt.properties ファイルは、/dsk1/backups ディレクトリ内の 3 つの表領域のバックアップを指定しています。これらは、ターゲット DB インスタンスにトランスポートする予定の表領域です。また、エンディアンネスを自動的に変換するソースプラットフォーム ID も指定します。

#linux system 
platformid=13
#list of tablespaces to transport
tablespaces=TBS1,TBS2,TBS3
#location where backup will be generated
src_scratch_location=/dsk1/backups
#RMAN command for performing backup
usermantransport=1

表領域が読み取り専用モードの場合は、ALTER TABLESPACE 権限を持つユーザーとしてソースデータベースにログインし、表領域を読み取り/書き込みモードにします。それ以外の場合は、次のステップに進みます。

次の例ではtbs1、tbs2、tbs3 を読み取り/書き込みモードにします。

ALTER TABLESPACE tbs1 READ WRITE;
ALTER TABLESPACE tbs2 READ WRITE;
ALTER TABLESPACE tbs3 READ WRITE;

xttdriver.pl スクリプトを使用して表領域をバックアップします。オプションで、--debug を指定してデバッグモードでスクリプトを実行できます。

export TMPDIR=location_of_log_files
cd location_of_xttdriver.pl
$ORACLE_HOME/perl/bin/perl xttdriver.pl --backup

SQL*Plus または Oracle SQL Developer を起動し、RDS for Oracle DB インスタンスにログインします。

Amazon RDS プロシージャ rdsadmin.rdsadmin_s3_tasks.download_from_s3 を使用して、Amazon S3 バケットからターゲット DB インスタンスにバックアップをダウンロードします。次の例では、mys3bucket という名前の Amazon S3 バケットから DATA_PUMP_DIR ディレクトリにファイルをすべてダウンロードします。

EXEC UTL_FILE.FREMOVE ('DATA_PUMP_DIR', 'res.txt');
SELECT rdsadmin.rdsadmin_s3_tasks.download_from_s3(
  p_bucket_name    =>  'mys3bucket',
  p_directory_name =>  'DATA_PUMP_DIR') 
AS TASK_ID FROM DUAL;

SELECT ステートメントでは、データ型 VARCHAR2 のタスクの ID が返ります。詳細については、「Amazon S3 バケットから Oracle DB インスタンスにファイルをダウンロードする」を参照してください。

Oracle SQL クライアントを起動し、ターゲット RDS for Oracle DB インスタンスにマスターユーザーとしてログインします。

インポートする表領域とバックアップを含むディレクトリを指定して、rdsadmin.rdsadmin_transport_util.import_xtts_tablespaces プロシージャを実行します。

以下の例では、表領域TBS1、TBS2、および TBS3 をディレクトリ DATA_PUMP_DIR からインポートします。ソースプラットフォームは AIX ベースのシステム (64 ビット) で、プラットフォーム ID は 6 です。プラットフォーム ID は、V$TRANSPORTABLE_PLATFORM をクエリすることで確認できます。

VAR task_id CLOB

BEGIN
  :task_id:=rdsadmin.rdsadmin_transport_util.import_xtts_tablespaces(
        'TBS1,TBS2,TBS3',
        'DATA_PUMP_DIR',
        p_platform_id => 6);
END;
/

PRINT task_id

(オプション) テーブル rdsadmin.rds_xtts_operation_info にクエリを実行して進行状況を監視します。xtts_operation_state 列には、EXECUTING、COMPLETED、または FAILED という値が表示されます。

SELECT * FROM rdsadmin.rds_xtts_operation_info;

前のステップのタスク ID を使用して、完了したインポートのログを表示します。

SELECT * FROM TABLE(rdsadmin.rds_file_util.read_text_file('BDUMP', 'dbtask-'||'&task_id'||'.log'));

インポートが正常に完了したことを確認してから、次の手順に進みます。

Oracle SQL クライアントを起動し、ターゲット RDS for Oracle DB インスタンスにマスターユーザーとしてログインします。

インポートする表領域とバックアップを含むディレクトリを指定して、rdsadmin.rdsadmin_transport_util.import_xtts_tablespaces プロシージャを実行します。

以下の例では、表領域TBS1、TBS2、および TBS3 をディレクトリ DATA_PUMP_DIR からインポートします。

BEGIN
  :task_id:=rdsadmin.rdsadmin_transport_util.import_xtts_tablespaces('TBS1,TBS2,TBS3','DATA_PUMP_DIR');
END;
/
PRINT task_id

(オプション) テーブル rdsadmin.rds_xtts_operation_info にクエリを実行して進行状況を監視します。xtts_operation_state 列には、EXECUTING、COMPLETED、または FAILED という値が表示されます。

SELECT * FROM rdsadmin.rds_xtts_operation_info;

前のステップのタスク ID を使用して、完了したインポートのログを表示します。

SELECT * FROM TABLE(rdsadmin.rds_file_util.read_text_file('BDUMP', 'dbtask-'||'&task_id'||'.log'));

インポートが正常に完了したことを確認してから、次の手順に進みます。

シングル AZ DB インスタンスの DB スナップショットの作成 の指示に従って DB スナップショットを手動で作成します。

Oracle SQL クライアントを起動し、ターゲット DB インスタンスにマスターユーザーとしてログインします。

トランスポートされた表領域にスキーマを所有するユーザーがまだ存在しない場合は、それらのユーザーを作成します。

CREATE USER tbs_owner IDENTIFIED BY password;

ダンプファイルの名前とディレクトリの場所を指定して、メタデータをインポートします。

BEGIN
  rdsadmin.rdsadmin_transport_util.import_xtts_metadata('xttdump.dmp','DATA_PUMP_DIR');
END;
/

(オプション) トランスポータブル表領域の履歴テーブルにクエリを実行して、メタデータインポートのステータスを確認します。

SELECT * FROM rdsadmin.rds_xtts_operation_info;

このオペレーションが完了すると、表領域は読み取り専用モードになります。

(オプション) ログファイルを表示します。

次の例では、BDUMP ディレクトリの内容を一覧表示し、インポートログをクエリします。

SELECT * FROM TABLE(rdsadmin.rds_file_util.listdir(p_directory => 'BDUMP'));

SELECT * FROM TABLE(rdsadmin.rds_file_util.read_text_file(
  p_directory => 'BDUMP',
  p_filename => 'rds-xtts-import_xtts_metadata-2023-05-22.01-52-35.560858000.log'));

SQL*Plus または SQL Developer を起動し、ターゲット DB インスタンスにマスターユーザーとしてログインします。

rdsadmin.rdsadmin_rman_util.validate_tablespace プロシージャを使用して表領域を検証します。

SET SERVEROUTPUT ON
BEGIN
    rdsadmin.rdsadmin_rman_util.validate_tablespace(
        p_tablespace_name     => 'TBS1',
        p_validation_type     => 'PHYSICAL+LOGICAL',
        p_rman_to_dbms_output => TRUE);
    rdsadmin.rdsadmin_rman_util.validate_tablespace(
        p_tablespace_name     => 'TBS2',
        p_validation_type     => 'PHYSICAL+LOGICAL',
        p_rman_to_dbms_output => TRUE);
    rdsadmin.rdsadmin_rman_util.validate_tablespace(
        p_tablespace_name     => 'TBS3',
        p_validation_type     => 'PHYSICAL+LOGICAL',
        p_rman_to_dbms_output => TRUE);
END;
/

表領域を読み取り/書き込みモードにします。

ALTER TABLESPACE TBS1 READ WRITE;
ALTER TABLESPACE TBS2 READ WRITE;
ALTER TABLESPACE TBS3 READ WRITE;

次のように DATA_PUMP_DIR の古いバックアップを削除します。

1. rdsadmin.rdsadmin_file_util.listdir を実行してバックアップファイルを一覧表示します。

   SELECT * FROM TABLE(rdsadmin.rds_file_util.listdir(p_directory => 'DATA_PUMP_DIR'));

2. UTL_FILE.FREMOVE を呼び出して、バックアップを 1 つずつ削除します。

   EXEC UTL_FILE.FREMOVE ('DATA_PUMP_DIR', 'backup_filename');

表領域をインポートしたが、これらの表領域のメタデータをインポートしなかった場合は、孤立したデータファイルを次のように削除できます。

1. 削除する必要のある孤立したデータファイルを一覧表示します。次の例では、rdsadmin.rdsadmin_transport_util.list_xtts_orphan_files プロシージャを呼び出します。

   SQL> SELECT * FROM TABLE(rdsadmin.rdsadmin_transport_util.list_xtts_orphan_files);
   
   FILENAME       FILESIZE
   -------------- ---------
   datafile_7.dbf 104865792
   datafile_8.dbf 104865792

2. rdsadmin.rdsadmin_transport_util.cleanup_incomplete_xtts_import プロシージャを実行して、孤立したファイルを削除します。

   BEGIN
     rdsadmin.rdsadmin_transport_util.cleanup_incomplete_xtts_import('DATA_PUMP_DIR');
   END;
   /

   クリーンアップ操作により、BDUMP ディレクトリに名前形式 rds-xtts-delete_xtts_orphaned_files-YYYY-MM-DD.HH24-MI-SS.FF.log を使用するログファイルが生成されます。

3. 前のステップで生成されたログファイルを読み込みます。次の例ではログ rds-xtts-delete_xtts_orphaned_files-2023-06-01.09-33-11.868894000.log を読み取ります。

   SELECT * 
   FROM TABLE(rdsadmin.rds_file_util.read_text_file(
          p_directory => 'BDUMP',
          p_filename  => 'rds-xtts-delete_xtts_orphaned_files-2023-06-01.09-33-11.868894000.log'));
   
   TEXT
   --------------------------------------------------------------------------------
   orphan transported datafile datafile_7.dbf deleted.
   orphan transported datafile datafile_8.dbf deleted.

表領域をインポートし、これらの表領域のメタデータをインポートしたものの、互換性エラーやその他の Oracle Data Pump の問題が発生した場合は、次のように部分的にトランスポートされたデータファイルをクリーンアップします。

1. DBA_TABLESPACES クエリを実行して、部分的にトランスポートされたデータファイルを含む表領域を一覧表示します。

   SQL> SELECT TABLESPACE_NAME FROM DBA_TABLESPACES WHERE PLUGGED_IN='YES';
   
   TABLESPACE_NAME
   --------------------------------------------------------------------------------
   TBS_3

2. 表領域と部分的にトランスポートされたデータファイルを削除します。

   DROP TABLESPACE TBS_3 INCLUDING CONTENTS AND DATAFILES;