DBMS_SQLPAパッケージは、SQLパフォーマンス・アナライザを実装するためのインタフェースを提供します。
この章では、次の項目について説明します。
概要
セキュリティ・モデル
DBMS_SQLPA
パッケージは、システム環境の変更がSQLワークロードのパフォーマンスに与える影響をユーザーが予測する場合に役立つ機能を提供します。このインタフェースを使用すると、2つの異なるバージョンのワークロード・パフォーマンスを作成してから比較し、それらの2つのバージョンの違いを分析して、変更によって影響を受ける可能性があるSQL文を明らかにできます。
このパッケージは、SQLパフォーマンス・アナライザを実装するためのタスク指向のインタフェースを提供します。次に例を示します。
CREATE_ANALYSIS_TASKファンクションを使用して、1つの文またはSQL文の集合に対する分析タスクを作成します。
EXECUTE_ANALYSIS_TASKファンクションおよびプロシージャを使用して、作成した分析タスクを実行します。
REPORT_ANALYSIS_TASKファンクションを使用して、分析タスクの結果を表示します。
表139-1 DBMS_SQLPAパッケージのサブプログラム
サブプログラム | 説明 |
---|---|
|
1つ以上のSQL文に対して現在実行中の分析タスクを取り消します。 |
|
1つ以上のSQL文を処理および分析するアドバイザ・タスクを作成します。 |
|
SQL分析タスクを削除します。 |
EXECUTE_ANALYSIS_TASKファンクションおよびプロシージャ |
以前に作成した分析タスクを実行します。 |
|
現在実行中の分析タスクを中断します。 |
|
分析タスクの結果を表示します。 |
|
現在実行中の分析タスクを初期状態にリセットします。 |
|
SQLチューニング・セットを処理するために作成され、以前に中断された分析タスクを再開します。 |
SET_ANALYSIS_TASK_PARAMETERプロシージャ |
SQL分析タスク・パラメータの値を設定します。 |
SET_ANALYSIS_DEFAULT_PARAMETERプロシージャ |
SQL分析タスク・パラメータのデフォルト値を設定します。 |
このファンクションは、1つ以上のSQL文を処理および分析するアドバイザ・タスクを作成します。このファンクションを様々な形式で使用して次の操作ができます。
テキストを指定して、単一の文に対する分析タスクを作成する。
識別子を指定して、カーソル・キャッシュ内の単一の文に対する分析タスクを作成する。
スナップショット識別子の範囲を指定して、ワークロード・リポジトリ内の単一文に対する分析タスクを作成する。
SQLチューニング・セットに対する分析タスクを作成する。
すべての場合において、このファンクションは、アドバイザ・タスクの作成とそのパラメータの設定を行います。
構文
SQLテキスト形式。この形式のファンクションは、テキストを指定して、単一の文の診断を準備する場合にコールします。
DBMS_SQLPA.CREATE_ANALYSIS_TASK( sql_text IN CLOB, bind_list IN sql_binds := NULL, parsing_schema IN VARCHAR2 := NULL, task_name IN VARCHAR2 := NULL, description IN VARCHAR2 := NULL) RETURN VARCHAR2;
SQL ID形式。この形式のファンクションは、識別子を指定して、カーソル・キャッシュ内の単一の文に対する分析を準備する場合にコールします。
DBMS_SQLPA.CREATE_ANALYSIS_TASK( sql_id IN VARCHAR2, plan_hash_value IN NUMBER := NULL, task_name IN VARCHAR2 := NULL, description IN VARCHAR2 := NULL) RETURN VARCHAR2;
ワークロード・リポジトリ形式。この形式のファンクションは、スナップショット識別子の範囲を指定して、ワークロード・リポジトリ内の単一の文に対する分析を準備する場合にコールします。
DBMS_SQLPA.CREATE_ANALYSIS_TASK( begin_snap IN NUMBER, end_snap IN NUMBER, sql_id IN VARCHAR2, plan_hash_value IN NUMBER := NULL, task_name IN VARCHAR2 := NULL, description IN VARCHAR2 := NULL) RETURN VARCHAR2;
SQLSET形式。この形式のファンクションは、SQLチューニング・セットの診断を準備する場合にコールします。
DBMS_SQLPA.CREATE_ANALYSIS_TASK( sqlset_name IN VARCHAR2, basic_filter IN VARCHAR2 := NULL, order_by IN VARCHAR2 := NULL, top_sql IN VARCHAR2 := NULL, task_name IN VARCHAR2 := NULL, description IN VARCHAR2 := NULL sqlset_owner IN VARCHAR2 := NULL) RETURN VARCHAR2;
パラメータ
表139-3 CREATE_ANALYSIS_TASKファンクションのパラメータ
パラメータ | 説明 |
---|---|
|
SQL文のテキスト。 |
|
バインド値のセット。 |
|
文をコンパイルできるスキーマの名前。 |
|
分析タスク名(オプション)。 |
|
SQL分析タスクの説明(最大256文字)。 |
|
SQL文の識別子。 |
|
SQL実行計画のハッシュ値。 |
|
スナップショット識別子を開始します。 |
|
スナップショット識別子を終了します。 |
|
SQLチューニング・セットの名前。 |
|
SQLチューニング・セットからSQLをフィルタするためのSQL述語。 |
|
選択したSQLのorder-by句。 |
|
フィルタ処理およびランク付け後のTop N SQL。 |
|
SQLチューニング・セットの所有者。現行のスキーマ所有者の場合は |
例
variable stmt_task VARCHAR2(64); variable sts_task VARCHAR2(64); -- Sql text format EXEC :stmt_task := DBMS_SQLPA.CREATE_ANALYSIS_TASK( sql_text => 'select quantity_sold from sales s, times t where s.time_id = t.time_id and s.time_id = TO_DATE(''24-NOV-00'')'); -- Sql id format (cursor cache) EXEC :stmt_task := DBMS_SQLPA.CREATE_ANALYSIS_TASK( sql_id => 'ay1m3ssvtrh24'); -- Workload repository format exec :stmt_task := DBMS_SQLPA.CREATE_ANALYSIS_TASK( begin_snap => 1, end_snap => 2, sql_id => 'ay1m3ssvtrh24'); -- Sql tuning set format (first we need to load an STS, then analyze it) EXEC :sts_task := DBMS_SQLPA.CREATE_ANALYSIS_TASK( - sqlset_name => 'my_workload', - order_by => 'BUFFER_GETS', - description => 'process workload ordered by buffer gets');
このファンクションおよびプロシージャは、以前に作成した分析タスクを実行します。ファンクション・バージョンは、新しい実行名を戻します。
構文
DBMS_SQLPA.EXECUTE_ANALYSIS_TASK( task_name IN VARCHAR2, execution_type IN VARCHAR2 := 'test execute', execution_name IN VARCHAR2 := NULL, execution_params IN dbms_advisor.argList := NULL, execution_desc IN VARCHAR2 := NULL) RETURN VARCHAR2;
DBMS_SQLPA.EXECUTE_ANALYSIS_TASK( task_name IN VARCHAR2, execution_type IN VARCHAR2 := 'test execute', execution_name IN VARCHAR2 := NULL, execution_params IN dbms_advisor.argList := NULL, execution_desc IN VARCHAR2 := NULL);
パラメータ
表139-5 EXECUTE_ANALYSIS_TASKファンクションおよびプロシージャのパラメータ
パラメータ | 説明 |
---|---|
|
実行するタスクの識別子。 |
|
ファンクションで実行するアクションのタイプ。
|
|
実行を修飾して識別するための名前。指定されていない場合は、アドバイザによって生成され、ファンクションによって戻されます。 |
|
指定した実行のパラメータ(名前、値)のリスト。実行パラメータは、指定した実行に対してのみ影響します。これらのパラメータは、(SET_ANALYSIS_DEFAULT_PARAMETERプロシージャを使用して設定された)タスクに格納されているパラメータの値より優先されます。 |
|
実行について説明する256文字の長さの文字列。 |
使用上の注意
SQLパフォーマンス・アナライザのタスクは、リセットせずに複数回実行できます。たとえば、SQLワークロードに対して変更の影響分析を実行するためにタスクが作成された場合は、システム環境を変更する前に、作成されたタスクを実行して、パフォーマンス分析の資料として使用されるワークロードのバージョンを構築する必要があります。変更が行われた後で、変更後バージョンのワークロードを構築するには、2回目の実行が必要になります。最後に、両方のバージョンのワークロードのパフォーマンスをアドバイザで分析および比較するために、タスクの3回目の実行が必要になります。
例
1. 変更の影響を分析する目的でのタスクの作成
EXEC :tname := DBMS_SQLPA.CREATE_ANALYSIS_TASK( sqlset_name => 'my_sts');
2. ベースラインの作成または変更前の実行
EXEC DBMS_SQLPA.EXECUTE_ANALYSIS_TASK( task_name => :tname, execution_type => 'test execute', execution_name => 'before_change');
3. 変更の実行
...
4. 変更後バージョンのワークロード・パフォーマンスの作成
EXEC DBMS_SQLPA.EXECUTE_ANALYSIS_TASK( task_name => :tname, - execution_type => 'test execute', execution_name => 'after_change')
5. 2つのバージョンのワークロードの比較
デフォルトでは、最後の2回の実行結果を常に比較します。SQLパフォーマンス・アナライザは、比較用のデフォルトのメトリックとしてelapsed_time
を使用します。ここでは、デフォルトのメトリックをbuffer_gets
に変更しています。
EXEC DBMS_SQLPA.SET_ANALYSIS_TASK_PARAMETER( :tname,'comparison_metric', 'buffer_gets'); EXEC DBMS_SQLPA.EXECUTE_ANALYSIS_TASK( task_name => :tname, - execution_type => 'compare performance', - execution_name => 'after_change');
比較する2つの実行、および使用する比較メトリックを明示的に指定する場合は、次のコールを使用します。
EXEC DBMS_SQLPA.EXECUTE_ANALYSIS_TASK( task_name => :tname, - execution_type => 'compare performance', execution_params => dbms_advisor.arglist( 'execution_name1', 'before_change', 'execution_name2', 'after_change', 'comparion_metric', 'buffer_gets'));
このプロシージャは、分析タスクの結果を表示します。
構文
DBMS_SQLPA.REPORT_ANALYSIS_TASK( task_name IN VARCHAR2, type IN VARCHAR2 := 'TEXT', level IN VARCHAR2 := 'TYPICAL', section IN VARCHAR2 := 'SUMMARY', object_id IN NUMBER := NULL, top_sql IN NUMBER := 100, execution_name IN VARCHAR2 := NULL, task_owner IN VARCHAR2 := NULL, order_by IN VARCHAR2 := NULL) RETURN CLOB;
パラメータ
表139-7 REPORT_ANALYSIS_TASKファンクションのパラメータ
パラメータ | 説明 |
---|---|
|
レポートするタスクの名前。 |
|
作成するレポートのタイプ。設定可能な値は、 |
|
レポートの詳細なレベル。
|
|
オプションで、レポートを単一のセクションに制限できます(すべてのセクションに関するレポートの場合は、
|
|
チューニング・セット(STS)の特定のSQLを表すアドバイザ・フレームワーク・オブジェクトの識別子。 |
|
レポート生成の対象となる、STS内のSQL文の数。 |
|
使用するタスク実行の名前。 |
|
関連する分析タスクの所有者。デフォルトは、現行のスキーマ所有者です。 |
|
レポート(要約および本文)でSQL文をソートする方法。有効な値は、次のとおりです。
|
使用上の注意
ACTIVE
レポートは、Enterprise Managerと類似した豊富な対話型ユーザー・インタフェースを備えていますが、EMのインストールは必要ありません。レポート・ファイルはHTML
形式で作成されるため、最近のほとんどのブラウザで解釈可能です。アクティブ・レポートに機能を付与するコードは、最初に表示したときにWebブラウザにより透過的にダウンロードされるため、表示には外部接続が必要です。
例
-- Get the whole report for the single statement case. SELECT DBMS_SQLPA.REPORT_ANALYSIS_TASK(:stmt_task) from dual; -- Show me the summary for the sts case. SELECT DBMS_SQLPA.REPORT_ANALYSIS_TASK(:sts_task, 'TEXT', 'TYPICAL', 'SUMMARY') FROM DUAL; -- Show me the findings for the statement I'm interested in. SELECT DBMS_SQLPA.REPORT_ANALYSIS_TASK(:sts_task, 'TEXT', 'TYPICAL', 'ALL', 5) from dual;
このプロシージャは、現在実行されていない分析タスクに対してコールされ、その分析タスクを再実行できるように準備します。すべての中間結果データは削除されます。
このプロシージャは、以前に中断されたか、または(致命的なエラーによって)FAILED
になったタスクの実行を再開します。
パラメータ
表139-9 RESUME_ANALYSIS_TASKプロシージャのパラメータ
パラメータ | 説明 |
---|---|
|
再開する分析タスクの識別子。 |
|
SQLチューニング・セットからSQLをフィルタするためのSQL述語。このフィルタは、CREATE_ANALYSIS_TASKファンクションのコール時に、指定された基本フィルタ(パラメータ |
このプロシージャは、SQL分析タスク・パラメータの値を設定します。
構文
この形式のプロシージャは、VARCHAR2
タイプのSQL分析パラメータの値を更新します。
DBMS_SQLPA.SET_ANALYSIS_TASK_PARAMETER( task_name IN VARCHAR2, parameter IN VARCHAR2, value IN VARCHAR2);
この形式のプロシージャは、NUMBER
タイプのSQL分析パラメータの値を更新します。
DBMS_SQLPA.SET_ANALYSIS_TASK_PARAMETER( task_name IN VARCHAR2, parameter IN VARCHAR2, value IN NUMBER);
パラメータ
表139-10 SET_ANALYSIS_TASK_PARAMETERプロシージャのパラメータ
パラメータ | 説明 |
---|---|
|
実行するタスクの識別子。 |
|
設定するパラメータの名前。このプロシージャによって設定可能な分析パラメータは、次のとおりです。
|
|
|
|
指定したパラメータの新しい値。 |
このプロシージャは、SQL分析タスク・パラメータのデフォルト値を設定します。
構文
この形式のプロシージャは、VARCHAR2
タイプのアナライザ・パラメータのデフォルト値を更新します。
DBMS_SQLPA.SET_ANALYSIS_DEFAULT_PARAMETER( parameter IN VARCHAR2, value IN VARCHAR2);
この形式のプロシージャは、NUMBER
タイプのアナライザ・パラメータのデフォルト
値を更新します。
DBMS_SQLPA.SET_ANALYSIS_DEFAULT_PARAMETER( parameter IN VARCHAR2, value IN NUMBER);
パラメータ
表139-11 SET_ANALYSIS_DEFAULT_PARAMETERプロシージャのパラメータ
パラメータ | 説明 |
---|---|
|
設定するパラメータの名前。このプロシージャによって設定可能な分析パラメータは、次のとおりです。
|
|
|
|
指定したパラメータの新しい値。 |