Oracle Cloud Infrastructureドキュメント

自律型AIデータベース・インスタンス間の取得とリプレイ

Autonomous AI Databaseインスタンスから別のAutonomous AI Databaseインスタンスに取得およびリプレイできます。

自律型AIデータベース間の取得- リプレイは、次のステップで構成されます(両方ではなく、ワークロード取得を取り消すか、または終了します)。

(オプション)取得およびリプレイの詳細を通知する情報イベントのサブスクライブ

取得およびリプレイの開始および完了時に通知される情報イベントをサブスクライブします。

ノート

ノート:このステップはオプションです。ワークロードの取得およびリプレイのステータスおよび履歴情報は、DBA_CAPTURE_REPLAY_STATUSビューおよびDBA_CAPTURE_REPLAY_HISTORYビューでも確認できます。詳細は、「DBA_CAPTURE_REPLAY_STATUSビュー」および「DBA_CAPTURE_REPLAY_HISTORYビュー」を参照してください。

情報イベントは、取得およびリプレイの開始時間と終了時間に関する通知を提供し、取得およびリプレイ・レポートにアクセスするためのPAR URLを含みます。

Autonomous AI Database Informationイベントには、次のものが含まれます:

  • WorkloadCaptureBegin: このイベントは、ワークロードの取得が開始されたときにトリガーされます。

  • WorkloadCaptureEnd: このイベントは、ワークロードの取得が正常に完了し、取得ファイルをダウンロードするための事前認証済(PAR) URLを生成したときにトリガーされます。

  • WorkloadReplayBegin: このイベントは、ワークロード・リプレイが開始されたときにトリガーされます。

  • WorkloadReplayEnd: このイベントは、ワークロード・リプレイが正常に完了し、リプレイ・レポートをダウンロードするための事前認証済(PAR) URLを生成したときにトリガーされます。

詳細は、Autonomous AI Databaseの情報イベントを参照してください。

Autonomous AI Databaseインスタンスのワークロードの取得

データベース・リプレイを使用するための最初のステップは、本番ワークロードの取得です。

ノート

ノート: Autonomous AI Databaseインスタンスでワークロードを取得し、別のAutonomous AI Databaseインスタンスでリプレイできます。取得したワークロードは、フル・クローンまたはリフレッシュ可能クローンでリプレイできます。取得およびリプレイのターゲットは、一貫した論理状態である必要があります。そのため、ワークロードを取得するAutonomous AI Databaseインスタンスのリフレッシュ可能クローンまたはフル・クローンをプロビジョニングする必要があります。詳細は、Autonomous AIデータベース・インスタンスのクローニング、移動またはアップグレードを参照してください。

本番システムでワークロードの取得を開始すると、Oracle AI Databaseに転送される外部クライアントからのすべてのリクエストが追跡され、取得ファイルと呼ばれるバイナリ・ファイルに格納されます。

ワークロードの取得では、取得ファイルを含む2つのサブディレクトリcapおよびcapfilesが作成されます。取得ファイルは、トランザクションの詳細、バインド値、SQLテキストなど、クライアント・リクエストに関するすべての関連情報を提供します。これらの取得ファイルは、プラットフォームには依存せず、別のシステムに転送できます。

DBMS_CLOUD_ADMIN.START_WORKLOAD_CAPTUREを実行して、Autonomous AI Databaseインスタンスでワークロードの取得を開始します。

詳細は、Autonomous AIデータベース・インスタンスのクローニング、移動またはアップグレードを参照してください。

Autonomous AI Databaseインスタンスでワークロード取得を開始するには、ADMINユーザーとしてログインしているか、DBMS_CLOUD_ADMINに対するEXECUTE権限を持っている必要があります。

ワークロードの取得を開始する例:

BEGIN
   DBMS_CLOUD_ADMIN.START_WORKLOAD_CAPTURE(
        capture_name => 'test',
        duration     => 60);
   END;
/

これにより、Autonomous AI Databaseインスタンスのワークロード取得が開始されます。

パラメータは次のとおりです。

  • capture_name: ワークロード取得の名前です。

  • duration: ワークロードを取得する必要がある期間(分単位)です。このパラメータはオプション。

詳細は、START_WORKLOAD_CAPTUREプロシージャを参照してください。

ワークロード取得イベント

START_WORKLOAD_CAPTUREの開始時に通知される情報イベントcom.oraclecloud.databaseservice.autonomous.database.informationをサブスクライブできます。詳細は、(オプション)取得およびリプレイの詳細について通知される情報イベントのサブスクライブを参照してください。

ワークロードの取得およびリプレイ・ビュー

ワークロードの取得およびリプレイに関する情報は、DBA_CAPTURE_REPLAY_STATUSビューおよびDBA_CAPTURE_REPLAY_HISTORYビューにあります。詳細は、「DBA_CAPTURE_REPLAY_STATUSビュー」および「DBA_CAPTURE_REPLAY_HISTORYビュー」を参照してください。

Autonomous AI Databaseインスタンスでのワークロード取得の取消し

DBMS_CLOUD_ADMIN.CANCEL_WORKLOAD_CAPTUREを実行して、Autonomous AI Databaseインスタンスの現在のワークロード取得を取り消します。

ワークロードの取得を取り消すには、ADMINユーザーとしてログインしているか、DBMS_CLOUD_ADMINに対するEXECUTE権限を持っている必要があります。

例:

BEGIN
    DBMS_CLOUD_ADMIN.CANCEL_WORKLOAD_CAPTURE;
END;
/

これにより、現在のワークロード取得が取り消され、リフレッシュ可能クローンでリフレッシュが実行されます。

DBA_CAPTURE_REPLAY_STATUSビューを問い合せて、ワークロードの取消しステータスを確認できます。

詳細は、「DBA_CAPTURE_REPLAY_STATUSビュー」を参照してください。

詳細は、CANCEL_WORKLOAD_CAPTUREプロシージャを参照してください。

Autonomous AI Databaseインスタンスでのワークロード取得の終了

DBMS_CLOUD_ADMIN.FINISH_WORKLOAD_CAPTUREを実行して、Autonomous AI Databaseインスタンスでワークロードの取得を完了します。

自律型AIデータベース・インスタンスでワークロードの取得を終了する例:

BEGIN
    DBMS_CLOUD_ADMIN.FINISH_WORKLOAD_CAPTURE;
END;
/

このプロシージャを実行するには、ADMINユーザーとしてログインしているか、DBMS_CLOUD_ADMINに対するEXECUTE権限を持っている必要があります。このプロシージャを実行すると、ワークロード取得ファイルがZipファイルとしてオブジェクト・ストアにアップロードされます。

詳細は、FINISH_WORKLOAD_CAPTUREプロシージャを参照してください。

ワークロード取得イベント

情報イベントcom.oraclecloud.databaseservice.autonomous.database.informationをサブスクライブして、次のようなワークロード取得について通知できます。

  • FINISH_WORKLOAD_CAPTUREの完了。

  • オブジェクト・ストア内の取得およびレポートにアクセスするためのPAR URLを含むcaptureDownloadURLフィールド。取得およびレポートは、PAR URLの生成日から7日間有効です。

詳細は、(オプション)取得およびリプレイの詳細について通知される情報イベントのサブスクライブを参照してください。

ワークロードの取得およびリプレイ・ビュー

DBA_CAPTURE_REPLAY_STATUSビューを問い合せて、完了したワークロード取得のステータスを確認できます。詳細は、「DBA_CAPTURE_REPLAY_STATUSビュー」を参照してください。

ワークロードの取得およびリプレイに関する情報は、DBA_CAPTURE_REPLAY_HISTORYビューにあります。詳細は、DBA_CAPTURE_REPLAY_HISTORYビューを参照してください。

DBA_WORKLOAD_CAPTURESビューのID列、NAME列、START_TIME列およびEND_TIME列を問い合せて、ワークロード取得の詳細を取得できます。詳細は、DBA_WORKLOAD_CAPTURESを参照してください。

ワークロード・リプレイ用のリフレッシュ可能クローンの準備

ワークロード・リプレイ用にリフレッシュ可能クローンを準備するステップを示します。

ノート

ノート:このステップは、フル・クローンでワークロードをリプレイする場合には適用されません。

ワークロード取得をリプレイするリフレッシュ可能クローンを準備するには、2つのオプションがあります。DBMS_CLOUD_ADMIN.PREPARE_REPLAYを実行して、ワークロード・リプレイ用にリフレッシュ可能クローンを自動的に準備できます。このプロシージャは、リフレッシュ可能クローンを取得の開始時間にリフレッシュし、リフレッシュ可能クローンを切断します。また、リフレッシュ可能クローンを手動で準備してワークロード取得をリプレイすることもできます。

ワークロード・リプレイ用のリフレッシュ可能クローンの自動準備

ワークロード・リプレイ用にリフレッシュ可能クローンを自動的に準備する例:

BEGIN
 DBMS_CLOUD_ADMIN.PREPARE_REPLAY (
    capture_name    'test'
END;
/

このプロシージャを実行するには、ADMINユーザーとしてログインしているか、DBMS_CLOUD_ADMINに対するEXECUTE権限を持っている必要があります。

DBMS_CLOUD_ADMIN.PREPARE_REPLAYは次のことを行います。

  • リフレッシュ可能クローンを取得開始タイムスタンプにリフレッシュします。

  • リフレッシュ可能クローンを切断します。

オプションで、この時点で取得をリプレイする前に、リフレッシュ可能クローンを変更できます。たとえば、パラメータ値を変更し、特定の機能をオン/オフにして、リプレイへの影響を確認します。

ワークロード・リプレイ用のリフレッシュ可能クローンの手動準備

DBMS_CLOUD_ADMIN.PREPARE_REPLAYを実行してリフレッシュ可能クローンを自動的に準備する場合、これらの手動リフレッシュ可能クローン・ステップは必要ありません。

ワークロード・リプレイを手動で準備するには、次のステップを実行します。

  1. DBA_WORKLOAD_CAPTURESビューを問い合せて、取得開始タイムスタンプを検索します。詳細は、DBA_WORKLOAD_CAPTURESを参照してください。

  2. リフレッシュ可能クローンを取得開始タイムスタンプにリフレッシュします。詳細は、Autonomous AI Databaseでのリフレッシュ可能クローンのリフレッシュを参照してください。

  3. リフレッシュ可能クローンを手動で切断します。詳細は、ソース・データベースからのリフレッシュ可能クローンの切断を参照してください。

  4. オプションで、取得をリプレイする前に、リフレッシュ可能クローンを変更できます。たとえば、パラメータ値を変更し、特定の機能をオン/オフにして、リプレイへの影響を確認します。

自律型AIデータベース・インスタンスでのワークロードのリプレイ

ワークロード取得の完了後、テスト・システムでリプレイできます。Oracleは、ワークロードの取得中に記録されたアクションを、本番システムの同じタイミング、同時実行性およびトランザクションの依存関係でリプレイします。

データベースでワークロード・リプレイを開始するには、プロシージャDBMS_CLOUD_ADMIN.REPLAY_WORKLOADを実行します。DBMS_CLOUD_ADMIN.REPLAY_WORKLOADを実行するには、ADMINユーザーとしてログインするか、DBMS_CLOUD_ADMINに対するEXECUTE権限を持っている必要があります。

取得したワークロードは、リフレッシュ可能クローンまたはワークロードの取得元のAutonomous AI Databaseインスタンスのフル・クローンでリプレイできます。取得ターゲットおよびリプレイ・ターゲットは、一貫性のある論理状態である必要があります。

リフレッシュ可能クローンでのワークロードのリプレイ

次の例では、オブジェクト・ストレージから取得ファイルをダウンロードし、取得したワークロードをリプレイして、リプレイ・レポートをオブジェクト・ストレージにアップロードします。

BEGIN
  DBMS_CLOUD_ADMIN.REPLAY_WORKLOAD(
      capture_name => 'CAP_TEST1');
END;
/

CAPTURE_NAMEパラメータは、ワークロード取得の名前を指定します。このパラメータは必須です。

フル・クローンでのワークロードのリプレイ

次の例では、オブジェクト・ストレージから取得ファイルをダウンロードし、取得したワークロードをクローンでリプレイし、リプレイ・レポートをオブジェクト・ストレージにアップロードします。

BEGIN
  DBMS_CLOUD_ADMIN.REPLAY_WORKLOAD(
       capture_name                => 'CAP_TEST1',
       capture_source_tenancy_ocid => 'OCID1.TENANCY.REGION1..ID1',
       capture_source_db_name      => 'ADWFINANCE');
END;
/

ノート

ノート:同じ取得名の取得が複数ある場合、REPLAY_WORKLOADプロシージャは最新の取得を使用します。Oracleでは、リプレイする取得の混乱を防ぐために、取得ごとに一意の取得名を使用することをお薦めします。

CAPTURE_NAMEパラメータは、ワークロード取得の名前を指定します。このパラメータは必須です。

CAPTURE_SOURCE_TENANCY_OCIDパラメータは、ワークロード取得のソース・テナンシのOCIDを指定します。フル・クローンでワークロード取得を実行する場合、このパラメータは必須です。

CAPTURE_SOURCE_DB_NAMEパラメータは、ワークロード取得のソース・データベース名を指定します。フル・クローンでワークロード取得を実行する場合、このパラメータは必須です。

詳細は、REPLAY_WORKLOADプロシージャを参照してください。

ワークロード・リプレイ・イベント

情報イベントcom.oraclecloud.databaseservice.autonomous.database.informationをサブスクライブし、次のことを通知します

  • REPLAY_WORKLOADの開始および完了。

  • リプレイ・レポートをダウンロードするためのオブジェクト・ストア・リンク。このイベントは、replayDownloadURLフィールドのレポートにアクセスするためのPAR URLを提供します。レポートは、PAR URLの生成時から7日間有効です。

詳細は、Autonomous AI Databaseの情報イベントを参照してください。

ワークロードの取得およびリプレイ・ビュー

DBA_CAPTURE_REPLAY_STATUSビューを問い合せて、ワークロードのリプレイ・ステータスを確認できます。

詳細は、「DBA_CAPTURE_REPLAY_STATUSビュー」を参照してください。

ワークロードの取得およびリプレイに関する情報は、DBA_CAPTURE_REPLAY_HISTORYビューにあります。詳細は、DBA_CAPTURE_REPLAY_HISTORYビューを参照してください。