DBMS_AWRAPP

機械翻訳について

44 DBMS_AWRAPP_ADMIN

DBMS_AWRAPP_ADMINには、APPMAPを作成および削除するためのサブプログラムが含まれています。

この章のトピックは、次のとおりです:

44.1 DBMS_AWRAPP_ADMINの使用

アプリケーション固有のAWR (自動ワークロード・リポジトリ)は、個々のアプリケーションにスコープ指定されたパフォーマンス・データを取得および分析します。

アプリケーション・レベルの高使用SQL文がデータベース全体の上位SQL間でランク付けされない場合は、標準のAWRレポートに表示されないことがあります。したがって、アプリケーション固有のAWRレポートの生成は、次の場合に特に役立ちます。

アプリケーションの正確な上位SQL統計により、問題をより迅速に検出して解決
コンテキストに富んだ共有パフォーマンス・データによるコラボレーションの強化
ベースラインを使用して、変更を検証し、上位SQLパフォーマンスを継続的に監視します
アプリケーションごとの正確なリソース属性によるレポートとコスト追跡をサポート

アプリケーション固有のAWRを使用すると、パフォーマンスに関するターゲット・レンズが提供されます。

アプリケーション固有のAWRレポートを生成するようにデータベースを設定するには、次のステップを実行します。

ステップ1: アプリケーション固有のAWRスナップショットの有効化

ENABLE_AWRAPP_SNAPSHOTプロシージャは、AWRスナップショット内のアプリケーション固有データの収集を有効にします。これは、適切な権限(通常はDBA)を持つユーザーが実行する必要があります。

begin 
DBMS_WORKLOAD_REPOSITORY.ENABLE_AWRAPP_SNAPSHOT;
end; 
/

ステップ2: 追跡するアプリケーションの指定

この機能を有効にしたら、指定した表または構成に名前を挿入して、追跡するアプリケーションを定義します。 DBMS_AWRAPP_ADMIN.CREATE_APPMAPプロシージャを使用して、アプリケーション識別子を定義し、それを特定のアプリケーション・プログラムに関連付けます。アプリケーション識別子は、関連するプログラムの論理グループとして機能します。このステップにより、AWRは指定されたアプリケーションのデータのみを収集します。

/* define MY_APPMAP_1 with module like '%payroll%', action like '%payroll%', client_info like '%payroll%', and client_identifier like '%payroll%'. */
begin
   DBMS_AWRAPP_ADMIN.CREATE_APPMAP(
        appmap_name           =>  'MY_APPMAP_1' ,
        module_pat            =>  '%payroll%' ,
        action_pat            =>  '%payroll%' ,
        client_info_pat       =>  '%payroll%' ,
        client_identifier_pat =>  '%payroll%' );
end;
/

ステップ3: アプリケーションの追跡の開始

指定されたAPPMAPのアプリケーション・パフォーマンスの追跡を開始するには、DBMS_WORKLOAD_REPOSITORY.INCLUDE_APPMAPを使用します。この手順により、AWRがアプリケーションのパフォーマンス・データの収集を開始し、データが通常のシステム全体のAWRスナップショットに含まれることが保証されます。

begin
   DBMS_WORKLOAD_REPOSITORY.INCLUDE_APPMAP(APPMAP_NAME =>  'MY_APPMAP_1' );
   DBMS_WORKLOAD_REPOSITORY.INCLUDE_APPMAP(APPMAP_NAME =>  'MY_APPMAP_2' );
end;
/

アプリケーションを追跡した後、アプリケーション固有のAWRレポートを生成します。ステップ4で使用したAWRスナップショットは、ステップ1から3の完了後に収集する必要があります。

ステップ4: レポートの生成

AWRアプリケーション・レポートは、DBMS_AWRAPP.GENERATE_AWRAPP_REPORTを使用して生成されます。

spool awr_application_report.html
select dbms_awrapp.generate_awrapp_report(2171, 4, 5, '1', 'html') from dual;
spool off

ステップ5: レポートの分析

レポートには、選択した時間間隔で収集されたアプリケーション固有のSQLパフォーマンス・データが取得されます。

次のデータ・ディクショナリ・ビューを使用して、アプリケーション・スナップショットのパフォーマンス・データを取得できます。

DBA_AWRAPP_APPMAP_CONTROL - ワークロード・リポジトリの制御情報(アプリケーション・パフォーマンス追跡ステータス)を表示します。
DBA_AWRAPP_APPMAP_DEF - データベース内のすべてのアプリケーション・マップに関する情報を表示します。
DBA_AWRAPP_INFO (またはAWR_PDB_AWRAPP_INFO) - AWRアプリケーション・スナップショットとワークロード・リポジトリ内のそのアプリケーション・マップ間のマッピングを表示します。
DBA_AWRAPP_SQLSTAT (またはAWR_PDB_AWRAPP_SQLSTAT) - ワークロード・リポジトリで取得されたアプリケーションに固有のSQL統計に関する情報を表示します。
DBMS_AWRAPP_ADMIN.DROP_AWRAPP - 指定されたAPPMAP定義をデータベースから削除します
DBMS_WORKLOAD_REPOSITORY.EXCLUDE_APPMAP - AWR内の指定されたアプリケーションのパフォーマンス追跡を停止します。

44.2 DBMS_AWRAPP_ADMINサブプログラムの要約

DBMS_AWRAPP_ADMINは、CREATE_APPMAPプロシージャおよびDROP_APPMAPプロシージャを使用します。

表44-1 DBMS_AWRAPP_ADMINパッケージのサブプログラム

サブプログラム	説明
CREATE_APPMAPプロシージャ	APPMAPを作成します。
DROP_APPMAPプロシージャ	APPMAPを削除します。

44.2.1 CREATE_APPMAPプロシージャ

このプロシージャは、APPMAPを作成します。

パラメータのパターンは、PL/SQLの'LIKE'操作としてパターン・マッチングを実行するために使用されます。文字 '\\'はエスケープ文字として扱われます。ワイルドカード文字('%', '_')をパターレンに含めることができます。

構文

DBMS_AWRAPP_ADMIN.CREATE_APPMAP(
   dbid                  IN NUMBER   DEFAULT NULL,
   appmap_name           IN VARCHAR2,
   module_pat            IN VARCHAR2 DEFAULT '%',
   action_pat            IN VARCHAR2 DEFAULT '%',
   client_info_pat       IN VARCHAR2 DEFAULT '%',
   client_identifier_pat IN VARCHAR2 DEFAULT '%');

パラメータ

表44-2 CREATE_APPMAPプロシージャのパラメータ

パラメータ	説明
`db_id`	データベース識別子。デフォルトはローカルDBIDです。
`appmap_name`	APPMAP名。
`module_pat`	モジュール・パターン。
`action_pat`	アクション・パターン。
`client_info_pat`	クライアント情報パターン。
`client_identifier_pat`	クライアント識別子パターン

44.2.2 DROP_APPMAPプロシージャ

この手順では、APPMAPを削除します。

構文

DBMS_AWRAPP_ADMIN.DROP_APPMAP(
   dbid                  IN NUMBER   DEFAULT NULL,
   appmap_name           IN VARCHAR2);

パラメータ

表44-3 DROP_APPMAPプロシージャのパラメータ

パラメータ	説明
`db_id`	データベース識別子。デフォルトはローカルDBIDです。
`appmap_name`	APPMAP名。