3.2 APIを使用した分析タスクの作成

この項では、DBMS_SQLPA.CREATE_ANALYSIS_TASKファンクションを使用してSQLパフォーマンス・アナライザのタスクを作成する方法について説明します。タスクは、SQLパフォーマンス・アナライザの実行時の入力および結果が格納されるデータベース・コンテナです。

ヒント:

操作を進める前に、パフォーマンスの分析に使用するSQLワークロードを本番システムのSQLチューニング・セットに取得して、パフォーマンスの分析を実行するテスト・システムに転送します。詳細は、「SQLワークロードの取得」を参照してください。

分析タスクを作成するには、次の手順に従います。

• 次のパラメータを使用してCREATE_ANALYSIS_TASKファンクションをコールします。

  • task_nameを設定して、SQLパフォーマンス・アナライザのタスクの任意の名前を指定します。

  • sqlset_nameをSQLチューニング・セットの名前に設定します。

  • sqlset_ownerをSQLチューニング・セットの所有者に設定します。デフォルトは現在のスキーマ所有者です。

  • basic_filterを、SQLチューニング・セットからSQLを除外するために使用するSQL述語に設定します。

  • order_byを設定して、SQL文が実行される順番を指定します。

    このパラメータを使用すると、時間制限に達しても、より重要なSQL文が処理され、スキップされないようにすることができます。

  • top_sqlを設定して、除外およびランク付け後にSQL文の上位の番号のみが考慮されるようにします。

  次の例は、ファンクション・コールを示しています。

  VARIABLE t_name VARCHAR2(100);
  EXEC :t_name := DBMS_SQLPA.CREATE_ANALYSIS_TASK(sqlset_name => 'my_sts', -
         task_name => 'my_spa_task');
  

分析タスクが作成されると、「変更前のSQL試行の作成」の説明に従って、SQLチューニング・セットに格納されているSQL文を実行して変更前のパフォーマンス・データを作成できます。

関連項目:

• DBMS_SQLPA.CREATE_ANALYSIS_TASKファンクションの詳細は、『Oracle Database PL/SQLパッケージおよびタイプ・リファレンス』を参照してください