124 DBMS_SQLPA

DBMS_SQLPAパッケージは、SQLパフォーマンス・アナライザのインタフェースを提供します。

この章では、次の項目について説明します。

DBMS_SQLPAの使用方法
- 概要
- セキュリティ・モデル
DBMS_SQLPAサブプログラムの要約

DBMS_SQLPAの使用方法

概要
セキュリティ・モデル

概要

DBMS_SQLPAパッケージは、システム環境の変更がSQLワークロードのパフォーマンスに与える影響をユーザーが予測する場合に役立つ機能を提供します。このインタフェースを使用すると、2つの異なるバージョンのワークロード・パフォーマンスを作成してから比較し、それらの2つのバージョンの違いを分析して、変更によって影響を受ける可能性があるSQL文を明らかにできます。

このパッケージは、SQLパフォーマンス・アナライザを実装するためのタスク指向のインタフェースを提供します。次に例を示します。

CREATE_ANALYSIS_TASKファンクションを使用して、1つの文またはSQL文の集合に対する分析タスクを作成します。
EXECUTE_ANALYSIS_TASKファンクションおよびプロシージャを使用して、作成した分析タスクを実行します。
REPORT_ANALYSIS_TASKファンクションを使用して、分析タスクの結果を表示します。

セキュリティ・モデル

このパッケージは、PUBLICで使用可能で、独自のセキュリティ・チェックが実行されます。すべての分析タスク・インタフェース（XXX_ANALYSIS_TASK）にはADVISOR権限が必要です。

DBMS_SQLPAサブプログラムの要約

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

サブプログラム	説明
CANCEL_ANALYSIS_TASKプロシージャ	1つ以上のSQL文に対して現在実行中の分析タスクを取り消します。
CREATE_ANALYSIS_TASKファンクション	1つ以上のSQL文を処理および分析するアドバイザ・タスクを作成します。
DROP_ANALYSIS_TASKプロシージャ	SQL分析タスクを削除します。
EXECUTE_ANALYSIS_TASKファンクションおよびプロシージャ	以前に作成した分析タスクを実行します。
INTERRUPT_ANALYSIS_TASKプロシージャ	現在実行中の分析タスクを中断します。
REPORT_ANALYSIS_TASKファンクション	分析タスクの結果を表示します。
RESET_ANALYSIS_TASKプロシージャ	現在実行中の分析タスクを初期状態にリセットします。
RESUME_ANALYSIS_TASKプロシージャ	SQLチューニング・セットを処理するために作成され、以前に中断された分析タスクを再開します。
SET_ANALYSIS_TASK_PARAMETERプロシージャ	SQL分析タスク・パラメータの値を設定します。
SET_ANALYSIS_DEFAULT_PARAMETERプロシージャ	SQL分析タスク・パラメータのデフォルト値を設定します。

CANCEL_ANALYSIS_TASKプロシージャ

このプロシージャは、現在実行中の分析タスクを取り消します。タスクから、すべての中間結果データが削除されます。

構文

DBMS_SQLPA.CANCEL_ANALYSIS_TASK(
 task_name         IN VARCHAR2);

パラメータ

表124-2 CANCEL_ANALYSIS_TASKプロシージャのパラメータ

パラメータ	説明
`task_name`	取り消すタスクの名前。

例

タスクの実行を停止する必要があり、実行済結果の確認が不要な場合のタスクの取消し

EXEC DBMS_SQLPA.CANCEL_ANALYSIS_TASK(:my_task);

CREATE_ANALYSIS_TASKファンクション

このファンクションは、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;

パラメータ

表124-3 CREATE_ANALYSIS_TASKファンクションのパラメータ

パラメータ	説明
`sql_text`	SQL文のテキスト。
`bind_list`	バインド値のセット。
`parsing_schema`	文をコンパイルできるスキーマの名前。
`task_name`	分析タスク名（オプション）。
`description`	SQL分析タスクの説明（最大256文字）。
`sql_id`	SQL文の識別子。
`plan_hash_value`	SQL実行計画のハッシュ値。
`begin_snap`	スナップショット識別子を開始します。
`end_snap`	スナップショット識別子を終了します。
`sqlset_name`	SQLチューニング・セットの名前。
`basic_filter`	SQLチューニング・セットからSQLをフィルタするためのSQL述語。
`order_by`	選択したSQLのorder-by句。
`top_sql`	フィルタ処理およびランク付け後のTop N SQL。
`sqlset_owner`	SQLチューニング・セットの所有者。現行のスキーマ所有者の場合は`NULL`。

戻り値

ユーザーごとに一意のSQL分析タスク名（2人の異なるユーザーが自分のアドバイザ・タスクに同じ名前を付けることはできます）。

例

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');

DROP_ANALYSIS_TASKプロシージャ

このプロシージャは、SQL分析タスクを削除します。タスクとそのすべての結果データが削除されます。

構文

DBMS_SQLPA.DROP_ANALYSIS_TASK(
 task_name         IN VARCHAR2);

パラメータ

表124-4 DROP_ANALYSIS_TASKプロシージャのパラメータ

パラメータ	説明
`task_name`	削除する分析タスクの名前。

EXECUTE_ANALYSIS_TASKファンクションおよびプロシージャ

このファンクションおよびプロシージャは、以前に作成した分析タスクを実行します。ファンクション・バージョンは、新しい実行名を戻します。

構文

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);

パラメータ

表124-5 EXECUTE_ANALYSIS_TASKファンクションおよびプロシージャのパラメータ

パラメータ	説明
`task_name`	実行するタスクの識別子。
`execution_type`	ファンクションで実行するアクションのタイプ。 `NULL`の場合、デフォルト値は`DEFAULT_EXECUTION_TYPE`パラメータの値に設定されます。有効な値は、次のとおりです。 `[TEST]` `EXECUTE`: すべてのSQL文をテスト実行し、実行計画および実行の統計情報を収集します。生成される計画および統計情報は、アドバイザ・フレームワークに格納されます。これがデフォルトです。 `EXPLAIN` `PLAN`: SQLワークロード内のすべての文に対してEXPLAIN PLANを生成します。これは、`EXPLAIN` `PLAN`コマンドに類似しています。生成される計画は、タスクに関連付けられているアドバイザ・フレームワークに格納されます。 `COMPARE` `[PERFORMANCE]`: 2つのバージョンのSQLパフォーマンス・データを分析および比較します。パフォーマンス・データを生成するには、SQL文のテスト実行またはそのEXPLAIN PLANの生成を行います。このオプションは、2つの実行タイプ`EXPLAIN_PLAN`または`TEST_EXECUTE`が、タスクにすでに存在する場合に使用します。 `CONVERT SQLSET`: SQLチューニング・セットに取得されている統計情報を読み取り、タスク実行のモデルとして使用します。試用に対する有効なデータがすでにSQLチューニング・セットに存在する場合は、このオプションを使用してSQL文の実行を省略できます。
`execution_name`	実行を修飾して識別するための名前。指定されていない場合は、アドバイザによって生成され、ファンクションによって戻されます。
`execution_params`	指定した実行のパラメータ（名前、値）のリスト。実行パラメータは、指定した実行に対してのみ影響します。これらのパラメータは、（SET_ANALYSIS_DEFAULT_PARAMETERプロシージャを使用して設定された）タスクに格納されているパラメータの値より優先されます。
`execution_desc`	実行について説明する256文字の長さの文字列。

使用上の注意

SQLパフォーマンス・アナライザのタスクは、リセットせずに複数回実行できます。たとえば、SQLワークロードに対して変更の影響分析を実行するためにタスクが作成された場合は、システム環境を変更する前に、作成されたタスクを実行して、パフォーマンス分析の資料として使用されるワークロードのバージョンを構築する必要があります。変更が行われた後で、変更後バージョンのワークロードを構築するには、2回目の実行が必要になります。最後に、両方のバージョンのワークロードのパフォーマンスをアドバイザで分析および比較するために、タスクの3回目の実行が必要になります。

例

1. 変更の影響を分析する目的でのタスクの作成

EXEC :tname := DBMS_SQLPA.CREATE_TUNING_TASK(
    sqlset_name     => 'my_sts');

2. ベースラインの作成または変更前の実行

EXEC DBMS_SQLPA.EXECUTE_TUNING_TASK(
    task_name       => :tname,
    execution_type  => 'test execute',     execution_name  => 'before_change');

3. 変更の実行

...

4. 変更後バージョンのワークロード・パフォーマンスの作成

EXEC DBMS_SQLPA.EXECUTE_TUNING_TASK(
   task_name          => :tname, -
   execution_type     => 'test execute ',
   execution_name     => 'after_change')

5. 2つのバージョンのワークロードの比較

デフォルトでは、最後の2回の実行結果を常に比較します。 SQLパフォーマンス・アナライザは、比較用のデフォルトのメトリックとしてelapsed_timeを使用します。ここでは、デフォルトのメトリックをbuffer_getsに変更しています。

EXEC DBMS_SQLPA.SET_TUNING_TASK_PARAMETER(
   :tname,'comparison_metric', 'buffer_gets');
EXEC DBMS_SQLPA.EXECUTE_TUNING_TASK(
   task_name         => :tname, -
   execution_type    => 'test execute', -
   execution_name    => 'after_change');

比較する2つの実行、および使用する比較メトリックを明示的に指定する場合は、次のコールを使用します。

EXEC DBMS_SQLPA.EXECUTE_TUNING_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'));

INTERRUPT_ANALYSIS_TASKプロシージャ

このプロシージャは、現在実行中の分析タスクを中断します。タスクから、すべての中間結果データが削除されるわけではありません。

構文

DBMS_SQLPA.INTERRUPT_ANALYSIS_TASK(
   task_name         IN VARCHAR2);

パラメータ

表124-6 INTERRUPT_ANALYSIS_TASKプロシージャのパラメータ

パラメータ	説明
`task_name`	中断する分析タスクの識別子。

例

EXEC DBMS_SQLPA.INTERRUPT_ANALYSIS_TASK(:my_task);

REPORT_ANALYSIS_TASKファンクション

このファンクションは、分析タスクの結果を表示します。

構文

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,
   task_owner      IN    VARCHAR2  := NULL,
   execution_name  IN  VARCHAR2    := NULL))
RETURN CLOB;

パラメータ

表124-7 REPORT_ANALYSIS_TASKファンクションのパラメータ

パラメータ	説明
`task_name`	レポートするタスクの名前。
`type`	作成するレポートのタイプ。設定可能な値は、`TEXT`（デフォルト）、`HTML`および`XML`です。
`level`	レポートの詳細なレベル。 `BASIC`: 現時点ではTYPICALと同じ。 `TYPICAL`（デフォルト）: 分析対象の各文に関する情報（変更やエラーなど）を表示します。 `ALL`: すべてのSQLの詳細。 `IMPROVED`: 改善されたSQLのみ。 `REGRESSED`: 回帰されたSQLのみ。 `CHANGED`: パフォーマンスが変更されたSQLのみ。 `UNCHANGED`: パフォーマンスが変更されていないSQLのみ。 `CHANGED_PLANS`: 計画が変更されたSQLのみ。 `UNCHANGED_PLANS`: 計画が変更されていないSQLのみ。 `ERRORS`: エラーが発生したSQLのみ。
`section`	オプションで、レポートを単一のセクションに制限できます（すべてのセクションに関するレポートの場合は、`ALL`を指定します）。 `SUMMARY`（デフォルト）: ワークロードのサマリーのみ。 `SECTION_ALL`: SQLに関するサマリーおよび詳細。
`object_id`	チューニング・セット（STS）の特定のSQLを表すアドバイザ・フレームワーク・オブジェクトの識別子。
`top_sql`	レポート生成の対象となる、STS内のSQL文の数。
`task_owner`	関連する分析タスクの所有者。デフォルトは、現行のスキーマ所有者です。
`execution_name`	使用するタスク実行の名前。`NULL`の場合は、最後のタスク実行に関するレポートが生成されます。

戻り値

必要なレポートが含まれているCLOB。

例

-- 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', 'FINDINGS', 5) from dual;

RESET_ANALYSIS_TASKプロシージャ

このプロシージャは、現在実行されていない分析タスクに対してコールされ、その分析タスクを再実行できるように準備します。すべての中間結果データは削除されます。

構文

DBMS_SQLPA.RESET_ANALYSIS_TASK(
 task_name         IN VARCHAR2);

パラメータ

表124-8 RESET_ANALYSIS_TASKプロシージャのパラメータ

パラメータ	説明
`task_name`	リセットする分析タスクの識別子。

例

-- reset and re-execute a task
EXEC DBMS_SQLPA.RESET_ANALYSIS_TASK(:sts_task);

-- re-execute the task
EXEC DBMS_SQLPA.EXECUTE_ANALYSIS_TASK(:sts_task);

RESUME_ANALYSIS_TASKプロシージャ

このプロシージャは、以前に中断されたか、または（致命的なエラーによって）FAILEDになったタスクの実行を再開します。

構文

DBMS_SQLPA.RESUME_ANALYSIS_TASK(
 task_name         IN VARCHAR2,
 basic_filter      IN VARCHAR2 := NULL);

パラメータ

表124-9 RESUME_ANALYSIS_TASKプロシージャのパラメータ

パラメータ	説明
`task_name`	再開する分析タスクの識別子。
`basic_filter`	SQLチューニング・セットからSQLをフィルタするためのSQL述語。このフィルタは、CREATE_ANALYSIS_TASKファンクションのコール時に、指定された基本フィルタ（パラメータ`basic_filter`）と組み合されて適用されます。

使用上の注意

単一のSQL分析タスク（SQLチューニング・セットではなく、1つのSQL文を分析するために作成されたタスク）の再開はサポートされていません。

例

-- Interrupt the task
EXEC DBMS_SQLPA.INTERRUPT_ANALYSIS_TASK(:conc_task);

-- Once a task is interrupted, we can elect to reset it, resume it, or check
-- out its results and then decide.  For this example we will just resume.

EXEC DBMS_SQLPA.RESUME_ANALYSIS_TASK(:conc_task);

SET_ANALYSIS_TASK_PARAMETERプロシージャ

このプロシージャは、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);

パラメータ

表124-10 SET_ANALYSIS_TASK_PARAMETERプロシージャのパラメータ

パラメータ説明

task_name

実行するタスクの識別子。

parameter

設定するパラメータの名前。このプロシージャによって設定可能な分析パラメータは、次のとおりです。

APPLY_CAPTURED_COMPILENV: SQL文で取得されたコンパイル環境をアドバイザで使用できるかどうかを示します。デフォルトは0（NO）です。
BASIC_FILTER: SQLチューニング・セットの基本フィルタ。
COMPARISON_METRIC: パフォーマンスの比較で使用する実行統計の式を指定します（例: buffer_gets、cpu_time + buffer_gets * 10）。
DATABASE_LINK: PUBLICデータベース・リンクのグローバル名に設定できます。設定した場合、SPAでは、SQL文をリモート・データベースに送信してリモートで処理することによって、すべてのTEST EXECUTEおよびEXPLAIN PLAN操作に対してデータベース・リンクが使用されます。この場合でも、分析結果はローカル・データベースに格納されます。
DAYS_TO_EXPIRE: タスクが削除されるまでの日数。
DEFAULT_EXECUTION_TYPE: EXECUTE_ANALYSIS_TASKファンクションおよびプロシージャによって何も指定されていない場合、タスクの実行タイプはデフォルトでこのタイプに設定されます。
EXECUTION_DAYS_TO_EXPIRE: （タスクが削除されることなく）タスクの実行が削除されるまでの日数。
EXECUTION_NAME1: 分析する最初のタスク実行の名前。
EXECUTION_NAME2: 分析する2番目のタスク実行の名前。
LOCAL_TIME_LIMIT: 文単位のタイムアウト（秒）。
PLAN_FILTER: SQLチューニング・セットの計画フィルタ（設定可能な値については、SELECT_SQLSETを参照してください）。
RANK_MEASURE1: SQLチューニング・セットの最初のランキング・メジャー。
RANK_MEASURE2: SQLチューニング・セットの2番目の設定可能なランキング・メジャー。
RANK_MEASURE3: SQLチューニング・セットの3番目の設定可能なランキング・メジャー。
RESUME_FILTER: SQLチューニング・セットのBASIC_FILTER以外の追加フィルタ。
SQL_IMPACT_THRESHOLD: SQLに対する変更の影響のしきい値。前述のパラメータ同じ（ただし、SQL文レベル）。
SQL_LIMIT: チューニングするSQL文の最大数。
SQL_PERCENTAGE: SQLチューニング・セットの文のパーセント・フィルタ。
TIME_LIMIT: グローバル・タイムアウト（秒）。
WORKLOAD_IMPACT_THRESHOLD: ワークロードに対するSQL文の影響のしきい値。ワークロードに対する変更の影響がこのしきい値の絶対値より低い文は無視され、改善および回帰は考慮されません。

value

指定したパラメータの新しい値。

SET_ANALYSIS_DEFAULT_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);

パラメータ

表124-11 SET_ANALYSIS_DEFAULT_PARAMETERプロシージャのパラメータ

パラメータ説明

パラメータ	説明
`parameter`	設定するパラメータの名前。このプロシージャによって設定可能な分析パラメータは、次のとおりです。 `APPLY_CAPTURED_COMPILENV`: SQL文で取得されたコンパイル環境をアドバイザで使用できるかどうかを示します。デフォルトは0（`NO`）です。 `BASIC_FILTER`: SQLチューニング・セットの基本フィルタ。 `COMPARISON_METRIC`: パフォーマンスの比較で使用する実行統計の式を指定します（例: `buffer_gets`、`cpu_time` + `buffer_gets` * 10）。 `DATABASE_LINK`: `PUBLIC`データベース・リンクのグローバル名に設定できます。設定した場合、SPAでは、SQL文をリモート・データベースに送信してリモートで処理することによって、すべての`TEST EXECUTE`および`EXPLAIN PLAN`操作に対してデータベース・リンクが使用されます。この場合でも、分析結果はローカル・データベースに格納されます。 `DAYS_TO_EXPIRE`: タスクが削除されるまでの日数。 `DEFAULT_EXECUTION_TYPE`: EXECUTE_ANALYSIS_TASKファンクションおよびプロシージャによって何も指定されていない場合、タスクの実行タイプはデフォルトでこのタイプに設定されます。 `EXECUTION_DAYS_TO_EXPIRE`: （タスクが削除されることなく）タスクの実行が削除されるまでの日数。 `EXECUTION_NAME1`: 分析する最初のタスク実行の名前。 `EXECUTION_NAME2`: 分析する2番目のタスク実行の名前。 `LOCAL_TIME_LIMIT`: 文単位のタイムアウト（秒）。 `PLAN_FILTER`: SQLチューニング・セットの計画フィルタ（設定可能な値については、`SELECT_SQLSET`を参照してください）。 `RANK_MEASURE1`: SQLチューニング・セットの最初のランキング・メジャー。 `RANK_MEASURE2`: SQLチューニング・セットの2番目の設定可能なランキング・メジャー。 `RANK_MEASURE3`: SQLチューニング・セットの3番目の設定可能なランキング・メジャー。 `RESUME_FILTER`: SQLチューニング・セットの`BASIC_FILTER`以外の追加フィルタ。 `SQL_IMPACT_THRESHOLD`: SQLに対する変更の影響のしきい値。前述のパラメータ同じ（ただし、SQL文レベル）。 `SQL_LIMIT`: チューニングするSQL文の最大数。 `SQL_PERCENTAGE`: SQLチューニング・セットの文のパーセント・フィルタ。 `TIME_LIMIT`: グローバル・タイムアウト（秒）。 `WORKLOAD_IMPACT_THRESHOLD`: ワークロードに対するSQL文の影響のしきい値。ワークロードに対する変更の影響がこのしきい値の絶対値より低い文は無視され、改善および回帰は考慮されません。
`value`	指定したパラメータの新しい値。

parameter

設定するパラメータの名前。このプロシージャによって設定可能な分析パラメータは、次のとおりです。

APPLY_CAPTURED_COMPILENV: SQL文で取得されたコンパイル環境をアドバイザで使用できるかどうかを示します。デフォルトは0（NO）です。
BASIC_FILTER: SQLチューニング・セットの基本フィルタ。
COMPARISON_METRIC: パフォーマンスの比較で使用する実行統計の式を指定します（例: buffer_gets、cpu_time + buffer_gets * 10）。
DATABASE_LINK: PUBLICデータベース・リンクのグローバル名に設定できます。設定した場合、SPAでは、SQL文をリモート・データベースに送信してリモートで処理することによって、すべてのTEST EXECUTEおよびEXPLAIN PLAN操作に対してデータベース・リンクが使用されます。この場合でも、分析結果はローカル・データベースに格納されます。
DAYS_TO_EXPIRE: タスクが削除されるまでの日数。
DEFAULT_EXECUTION_TYPE: EXECUTE_ANALYSIS_TASKファンクションおよびプロシージャによって何も指定されていない場合、タスクの実行タイプはデフォルトでこのタイプに設定されます。
EXECUTION_DAYS_TO_EXPIRE: （タスクが削除されることなく）タスクの実行が削除されるまでの日数。
EXECUTION_NAME1: 分析する最初のタスク実行の名前。
EXECUTION_NAME2: 分析する2番目のタスク実行の名前。
LOCAL_TIME_LIMIT: 文単位のタイムアウト（秒）。
PLAN_FILTER: SQLチューニング・セットの計画フィルタ（設定可能な値については、SELECT_SQLSETを参照してください）。
RANK_MEASURE1: SQLチューニング・セットの最初のランキング・メジャー。
RANK_MEASURE2: SQLチューニング・セットの2番目の設定可能なランキング・メジャー。
RANK_MEASURE3: SQLチューニング・セットの3番目の設定可能なランキング・メジャー。
RESUME_FILTER: SQLチューニング・セットのBASIC_FILTER以外の追加フィルタ。
SQL_IMPACT_THRESHOLD: SQLに対する変更の影響のしきい値。前述のパラメータ同じ（ただし、SQL文レベル）。
SQL_LIMIT: チューニングするSQL文の最大数。
SQL_PERCENTAGE: SQLチューニング・セットの文のパーセント・フィルタ。
TIME_LIMIT: グローバル・タイムアウト（秒）。
WORKLOAD_IMPACT_THRESHOLD: ワークロードに対するSQL文の影響のしきい値。ワークロードに対する変更の影響がこのしきい値の絶対値より低い文は無視され、改善および回帰は考慮されません。

value

指定したパラメータの新しい値。