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

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

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

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

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

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プロシージャを参照してください。

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

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

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

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

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

例:

BEGIN
    DBMS_CLOUD_ADMIN.CANCEL_WORKLOAD_CAPTURE;
END;
/

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

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

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

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

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

プロシージャ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;
/

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ビューを参照してください。