トランスポータブル表領域を使用したデータの変換

トピック

例

次の例に、表領域をトランスポートする手順を示します。この例では、次に示すデータファイルおよび表領域が存在することを前提としています。

タスク1: 表領域が自己完結型であることの確認

表領域のセットが自己完結型かどうかを判断するには、Oracle提供のパッケージDBMS_TTSでTRANSPORT_SET_CHECKプロシージャを起動します。たとえば:

EXECUTE DBMS_TTS.TRANSPORT_SET_CHECK('sales_1,sales_2', TRUE);

パッケージは、すべての依存オブジェクト(索引、制約、パーティションなど)が、転送される表領域のセット内に完全に存在することを検証します。転送の成功を妨げるクロステーブルスペースの依存関係はありません。

SELECT * FROM TRANSPORT_SET_VIOLATIONS;

タスク2: バックアップの作成

このタスクでは、このステップに必要な前提条件がすべて完了していることを前提としています。詳細は、ソース・データベース・ホスト環境の準備を参照してください。

• プロジェクト・ディレクトリに移動し、tts-backup-env.txtパラメータ・ファイルを開きます。必要に応じて、パラメータ・ファイルに入力を指定します。たとえば:

  [DEFAULT]
  ...
  
  PROJECT_NAME=tts_project
  DATABASE_NAME=orclpdb1
  TABLESPACES=sales_1,sales_2
  SCHEMAS=SALES
  ...
  
  HOSTNAME=<host>
  LSNR_PORT=1521
  DB_SVC_NAME=tts_db
  ORAHOME=/opt/oracle/product/19c/dbhome_1
  DBUSER=USER
  DB_VERSION=19c
  
  ...
  
  TTS_BACKUP_URL=https://objectstorage.region.oraclecloud.com/n/namespace/b/tts_data_bucket
  TTS_BUNDLE_URL=https://objectstorage.region.oraclecloud.com/n/namespace/b/tts_bucket
  OCI_INSTALLER_PATH=/home/oracle/opc_installer/oci_installer/oci_install.jar
  CONFIG_FILE=/home/oracle/OCI_CONFIG/config
  COMPARTMENT_OCID=ocid1.compartment.oc1..xxxxx
  OCI_PROXY_HOST=proxy.company.com
  OCI_PROXY_PORT=80
  
  ...

• パラメータ・ファイルを構成したら、オプションでtts-backup.pyスクリプトの予行演習を実行できます。予行演習を実行すると、ソース・データベース・ホストが適切に構成され、トランスポータブル表領域操作の準備ができていることを検証できます。このプロセスでは、欠落している前提条件をチェックし、指定されたストレージ宛先への接続を検証し、すべての必須パラメータが正しく設定されていることを確認します。実際のバックアップを開始する前にドライ・ランを実行すると、事前に潜在的な問題を特定して解決できるため、トランスポータブル表領域操作中のエラーのリスクが軽減されます。

  次のコマンドを実行して、スクリプトのドライ・ランを実行します。

  $ python3 /u01/tts_project/tts-backup.py --DBPASSWORD=xxx --DRY_RUN=TRUE

• ドライ・ランを完了し、発生したエラーを解決した後、tts-backup.pyスクリプトを実行してソース・データベースのバックアップを開始します。

  $ python3 /u01/tts_project/tts-backup.py --DBPASSWORD=xxx

  この例では、トランスポータブル表領域バックアップ・ユーティリティのPythonスクリプトを実行して、ソース・データベースをバックアップします。FINAL_BACKUPパラメータの値に応じて、バックアップは増分または非増分のいずれかになります。

  Project_Directoryパラメータは、トランスポータブル表領域バックアップ・ユーティリティ(tts-backup.py)およびパラメータ・ファイル(tts-backup-env.txt)が格納されるディレクトリへのフルパスを指定します。

  バックアップを実行するデータベース・ユーザーの--DBPASSWORDパスワード。

  --TDE_WALLET_STORE_PASSWORDは、Transparent Data Encryption (TDE)ウォレットのパスワードを指定します。これは、表領域が暗号化されている場合にのみ必要です。

  ノート
  
  コマンドを実行する前に、tts-backup-env.txtファイルが正しい入力(OCIオブジェクト・ストレージの詳細、バケットURL、データベース・パラメータなど)で構成されていることを確認してください。tts-backup.pyスクリプトは、入力を検証し、ソース・データベースでチェックを実行し、バックアップ・プロセスを開始します。FINAL_BACKUPがTRUEに設定されている場合、スクリプトはData Pumpエクスポート・ユーティリティを使用して表領域およびスキーマ・メタデータをエクスポートします。

• スクリプトが正常に完了すると、ソース・データベースからOCIオブジェクト・ストレージ・バケットに表領域データ・バックアップがアップロードされます。バックアップは、選択したバックアップ・タイプに応じて、増分または非増分のいずれかになります。非増分バックアップは、特定の時点のすべての表領域データで構成され、リストア操作の完全バックアップを提供します。増分バックアップは、ベースラインとして機能するレベル0のバックアップと、前回のバックアップ以降の変更を含む1つ以上の後続の増分(レベル1)バックアップで構成されます。ただし、増分バックアップからリストアする場合は、データの一貫性を確保するために、レベル0のバックアップと後続のすべての増分バックアップを順番に適用する必要があります。

  また、スクリプトでは、必要なメタデータおよびウォレット・ファイル(該当する場合)を含む圧縮トランスポータブル表領域メタデータ・バンドルが作成され、OCIオブジェクト・ストレージ・メタデータ・バケットにアップロードされます。

  非増分バックアップのURLの例:

  https://swiftobjectstorage.region.oraclecloud.com/v1/dwcsdev/tts_bucket/orclpdb1_bkp.tgz

  増分バックアップのURLの例:

  各URLには、メタデータ・バンドル名に増分バックアップ・レベルが含まれます(例: level_0、 ⁇ level_1、 ⁇ final_bkp)。これにより、リストア・プロセス中に各バックアップ・セットを迅速に識別して参照できます。level 0バックアップから始めて、後続の各バックアップから最終バックアップまで、各増分バックアップを順番に適用してください。

  https://swiftobjectstorage.region.oraclecloud.com/v1/dwcsdev/tts_bucket/orclpdb1_level_0.tgz

  https://swiftobjectstorage.region.oraclecloud.com/v1/dwcsdev/tts_bucket/orclpdb1_level_1.tgz

  …

  https://swiftobjectstorage.region.oraclecloud.com/v1/dwcsdev/tts_bucket/orclpdb1_final_bkp.tgz

ターゲットAutonomous AI Databaseでトランスポータブル表領域をリストアするプロセスは、ソース・データベースからの表領域バックアップが増分か非増分かによって異なります。

ソース・データベースの非増分表領域バックアップを使用したリストア

非増分(完全)ソース表領域バックアップでは、メタデータ・バンドルには、ソース・データベースの完全な表領域バックアップと、表領域およびスキーマ・メタデータのData Pumpエクスポートが含まれます。Autonomous AI Databaseのプロビジョニング中に、「拡張オプション」の下の「移行」セクションの「表領域zipファイルのオブジェクト・ストレージ・バケットURI」テキスト・ボックスにメタデータ・バンドルURLを指定して、ソース表領域バックアップから表領域をインポートします。プロビジョニング・プロセスでは、表領域のバックアップがリストアされ、表領域およびスキーマ・メタデータがデータベースにインポートされます。

たとえば:

図adb_transportable_tablespace_migration.pngの説明

Autonomous AI Databaseをプロビジョニングする詳細なステップは、Autonomous AI Databaseインスタンスのプロビジョニングを参照してください。

ソース・データベースの増分表領域バックアップを使用したリストア

レベル0のバックアップを使用してAutonomous AI Databaseをプロビジョニングします:

まず、レベル0の表領域を使用してAutonomous AI Databaseをプロビジョニングし、ソース・データベースをバックアップします。この操作により、データベースがプロビジョニングされ、データベースの初期レベル0のバックアップがリストアされます。詳細は、Autonomous AI Databaseインスタンスのプロビジョニングを参照してください。

後続の増分(レベル1)バックアップを適用します。

データベースがプロビジョニングされ、ソース表領域のレベル0のバックアップがリストアされたら、増分(レベル1)バックアップを順番に適用します。

増分バックアップを使用してターゲットAutonomous AI Databaseを更新するステップ:

• 必要に応じて、次の前提条件ステップを実行します:

  • 「クラウド」の横にあるをクリックして、Oracle Cloud Infrastructure Consoleを開きます。

  • Oracle Cloud Infrastructureの左側のナビゲーション・メニューから、「Oracle Database」をクリックし、「Autonomous AI Database」をクリックします。

  • 「自律型AIデータベース」ページで、「表示名」列の下のリンクから自律型AIデータベースを選択します。

    ターゲットAutonomous AI Databaseでソース・データベースから後続の増分表領域バックアップを適用するには、次のステップに従います:

    • 「他のアクション」ドロップダウン・リストで、「データの移行」を選択します。

      「データの移行」ページが表示されます。

      ノート
      
      「データの移行」オプションは、プロビジョニング中にレベル0のインポートが完了し、プロビジョニング後にトランスポータブル表領域操作を完了するために追加の増分表領域バックアップ・インポートが必要なデータベースでのみ使用できます。

    • 「データの移行」ページで、「トランスポータブル表領域のインポート」トグルを有効にします。トグルを有効にすると、「表領域zipのオブジェクト・ストレージ・バケットURI」ファイル・フィールドが表示されます。トランスポータブル表領域のメタデータ・バンドルURLをこのフィールドに入力します。

      トランスポータブル表領域メタデータ・バンドルURLはOCIオブジェクト・ストレージからダウンロードする必要があるため、リソース・プリンシパルを使用してOCIオブジェクト・ストレージへのアクセスを許可する動的グループおよびポリシーを設定する必要があります。ターゲットAutonomous AI Databaseでトランスポータブル表領域メタデータ・バンドルを安全にダウンロードするには、リソース・プリンシパルの構成が必要です。詳細は「前提条件」を参照してください。

      たとえば、ソース・データベースからレベル1の表領域バックアップを適用するには、ソース・データベースからレベル1の表領域バックアップに適切なURLを指定します。

      
      
      図adb_transportable_tablespaces_level1_restore.pngの説明
      

      ...

      同様に、ソース・データベースから最終的な表領域バックアップを適用する場合は、適切なURLを指定します。たとえば:

      
      
      図adb_transportable_tablespace_restore_final.pngの説明
      

    • 「移行」をクリックします。

      データベース・ライフサイクルの状態が「トランスポート」に変わります。リストアが完了すると、ライフサイクル状態が「使用可能」に変わります。