217 UTL_SPADV

UTL_SPADVパッケージは、Oracle Streamsパッケージ・セットの1つであり、分散データベース環境におけるOracle Streamsコンポーネントの統計を収集して分析するためのサブプログラムを提供しています。このパッケージでは、統計の収集にOracle Streamsパフォーマンス・アドバイザを使用します。

関連項目:

このパッケージおよびOracle Streamsパフォーマンス・アドバイザの詳細は、『Oracle Streams概要および管理』を参照してください。

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

UTL_SPADVサブプログラムの要約

UTL_SPADVサブプログラムの要約

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

サブプログラム	説明
COLLECT_STATSプロシージャ	Oracle Streamsパフォーマンス・アドバイザを使用して、分散データベース環境におけるOracle Streamsのコンポーネントおよびサブコンポーネントに関する統計を収集します。
SHOW_STATSプロシージャ	`COLLECT_STATS`プロシージャを使用して収集した統計が含まれる出力を生成します。

COLLECT_STATSプロシージャ

このプロシージャは、Oracle Streamsパフォーマンス・アドバイザを使用して、分散データベース環境におけるOracle Streamsのコンポーネントおよびサブコンポーネントに関する統計を収集します。

注意:

このプロシージャはコミットします。

関連項目:

Oracle Streamsパフォーマンス・アドバイザの詳細は、『Oracle Streams概要および管理』を参照してください。

構文

UTL_SPADV.COLLECT_STATS(
   interval                      IN NUMBER  DEFAULT 60,
   num_runs                      IN NUMBER  DEFAULT 10,
   comp_stat_table             IN VARCHAR2  DEFAULT 'STREAMS$_ADVISOR_COMP_STAT',
   path_stat_table             IN VARCHAR2  DEFAULT 'STREAMS$_ADVISOR_PATH_STAT',
   top_event_threshold           IN NUMBER  DEFAULT 15,
   bottleneck_idle_threshold     IN NUMBER  DEFAULT 50,
   bottleneck_flowctrl_threshold IN NUMBER  DEFAULT 50);

パラメータ

表217-2 COLLECT_STATSプロシージャのパラメータ

パラメータ	説明
`interval`	Oracle Streamsパフォーマンス・アドバイザが連続して2回実行される間の時間（秒）。
`num_runs`	このプロシージャによってOracle Streamsパフォーマンス・アドバイザが実行される回数。
`comp_stat_table`	Oracle Streamsのコンポーネントおよびサブコンポーネントに関して収集した統計を格納する表の名前。表の名前を`[schema_name.]object_name`の形式で指定します。スキーマを指定しない場合は、現行のユーザー名がデフォルトで使用されます。このプロシージャは、指定された表が存在しない場合、その表を作成します。デフォルトの表である`STREAMS$_ADVISOR_COMP_STAT`を使用することをお薦めします。このパラメータの詳細は、「使用上の注意」を参照してください。
`path_stat_table`	ストリーム・パスに関して収集した統計を格納する表の名前。表の名前を`[schema_name.]object_name`の形式で指定します。スキーマを指定しない場合は、現行のユーザー名がデフォルトで使用されます。このプロシージャは、指定された表が存在しない場合、その表を作成します。デフォルトの表である`STREAMS$_ADVISOR_PATH_STAT`を使用することをお薦めします。このパラメータの詳細は、「使用上の注意」を参照してください。
`top_event_threshold`	上位待機イベント統計を収集するかどうかを決定する割合。このプロシージャで待機イベント統計を収集するには、待機イベントの割合が、このパラメータに指定された値を超える必要があります。たとえば、`15`を指定した場合は、15%よりも大きい値の待機イベントのみが収集されます。
`bottleneck_idle_threshold`	Oracle Streamsのコンポーネント・セッションで、その`IDLE`の割合に基づくボトルネック分析が可能かどうかを決定する割合。 Oracle Streamsのコンポーネント・セッションでボトルネック分析を可能にするには、`IDLE`の割合が、このパラメータに指定された値以下である必要があります。たとえば、`50`を指定した場合は、アイドル状態が時間の50%以下であるコンポーネントのみでボトルネック分析が可能になります。
`bottleneck_flowctrl_threshold`	Oracle Streamsのコンポーネント・セッションで、その`FLOW` `CONTROL`の割合に基づくボトルネック分析が可能かどうかを決定する割合。 Oracle Streamsのコンポーネント・セッションでボトルネック分析を可能にするには、`FLOW` `CONTROL`の割合が、このパラメータに指定された値以下である必要があります。たとえば、`50`を指定した場合は、フロー制御のための一時停止が時間の50%以下であるコンポーネントのみでボトルネック分析が可能になります。

使用上の注意

path_stat_tableパラメータで指定した表には、ストリーム・パス統計が格納されます。この表では、comp_stat_tableパラメータで指定した表に格納されているコンポーネントとサブコンポーネントの統計も連結されます。このパッケージのSHOW_STATSプロシージャでは、path_stat_tableパラメータで指定した表に格納されている統計のみが表示されます。

SHOW_STATSプロシージャ

このプロシージャは、COLLECT_STATSプロシージャを使用して収集した統計が含まれる出力を生成します。

出力は、分析用にスプレッドシートにインポートできる形式に構成されます。

注意:

このプロシージャはコミットしません。

関連項目:

Oracle Streamsパフォーマンス・アドバイザの詳細は、『Oracle Streams概要および管理』を参照してください。

構文

UTL_SPADV.SHOW_STATS(
   path_stat_table IN VARCHAR2  DEFAULT 'STREAMS$_ADVISOR_PATH_STAT',
   path_id         IN NUMBER    DEFAULT NULL,
   bgn_run_id      IN NUMBER    DEFAULT -1,
   end_run_id      IN NUMBER    DEFAULT -10,
   show_path_id    IN BOOLEAN   DEFAULT TRUE,
   show_run_id     IN BOOLEAN   DEFAULT TRUE,
   show_run_time   IN BOOLEAN   DEFAULT TRUE,
   show_cca_mode   IN BOOLEAN   DEFAULT TRUE,
   show_setting    IN BOOLEAN   DEFAULT FALSE,
   show_stat       IN BOOLEAN   DEFAULT TRUE,
   show_sess       IN BOOLEAN   DEFAULT FALSE,
   show_legend     IN BOOLEAN   DEFAULT TRUE);

パラメータ

表217-3 SHOW_STATSプロシージャのパラメータ

パラメータ	説明
`path_stat_table`	ストリーム・パス統計が含まれている表の名前。この表は、`COLLECT_STATS`プロシージャの`path_stat_table`パラメータに指定されています。表の名前を`[schema_name.]object_name`の形式で指定します。スキーマを指定しない場合は、現行のユーザー名がデフォルトで使用されます。
`path_id`	ストリーム・パスのID。 `NULL`以外に設定すると、指定したストリーム・パスのみの出力が表示されます。 `NULL`に設定すると、すべてのアクティブなストリーム・パスの出力が表示されます。
`bgn_run_id`	実行の範囲で表示する場合のOracle Streamsパフォーマンス・アドバイザの最初の実行ID。このパラメータの詳細は、「使用上の注意」を参照してください。
`end_run_id`	実行の範囲で表示する場合のOracle Streamsパフォーマンス・アドバイザの最後の実行ID。このパラメータの詳細は、「使用上の注意」を参照してください。
`show_path_id`	`TRUE`に設定すると、各ストリーム・パスのパスIDが出力に含まれます。 `FALSE`に設定すると、各ストリーム・パスのパスIDは出力に含まれません。
`show_run_id`	`TRUE`に設定すると、Oracle Streamsパフォーマンス・アドバイザの実行IDが出力に含まれます。 `FALSE`に設定すると、Oracle Streamsパフォーマンス・アドバイザの実行IDは出力に含まれません。
`show_run_time`	`TRUE`に設定すると、Oracle Streamsパフォーマンス・アドバイザの実行時間が出力に含まれます。 `FALSE`に設定すると、Oracle Streamsパフォーマンス・アドバイザの実行時間は出力に含まれません。
`show_cca_mode`	`TRUE`に設定すると、取得と適用の複合による最適化に関連する情報がパスの出力に含まれます。 `FALSE`に設定すると、取得と適用の複合による最適化に関連する情報はパスの出力に含まれません。
`show_setting`	`TRUE`に設定すると、しきい値パラメータの設定が出力に含まれます。しきい値パラメータとは、`COLLECT_STATS`プロシージャの`top_event_threshold`、`bottleneck_idle_threshold`および`bottleneck_flowctrl_threshold`パラメータです。 `FALSE`に設定すると、しきい値パラメータの設定は出力に含まれません。
`show_stat`	`TRUE`に設定すると、コンポーネントレベルおよびサブコンポーネントレベルの統計が出力に含まれます。この場合のコンポーネントには、取得プロセス、キュー、伝播の送信者、伝播の受信者、適用プロセスがあります。サブコンポーネントとは、取得プロセスと適用プロセスのサブコンポーネントです。 `FALSE`に設定すると、コンポーネントレベルおよびサブコンポーネントレベルの統計は出力に含まれません。
`show_sess`	`TRUE`に設定すると、セッションレベルの統計が出力に含まれます。セッションレベルの統計には、`IDLE`統計、`FLOW` `CONTROL`統計および`EVENT`統計があります。 `FALSE`に設定すると、セッションレベルの統計は出力に含まれません。
`show_legend`	`TRUE`に設定すると、凡例が出力に含まれます。凡例は、出力で使用される略語を説明します。 `FALSE`に設定すると、凡例は出力に含まれません。

使用上の注意

表示するOracle Streamsパフォーマンス・アドバイザの実行の範囲を指定するには、bgn_run_idとend_run_idの両方を使用してください。正の値を指定すると、先の実行から順に統計が表示されます。負の値を指定すると、後の実行からさかのぼって統計が表示されます。

たとえば、bgn_run_idを1に設定し、end_run_idを10に設定すると、最初の10個のOracle Streamsパフォーマンス・アドバイザの実行の統計が表示されます。

一方、bgn_run_idを-1に設定し、end_run_idを-10に設定すると、最後の10個のOracle Streamsパフォーマンス・アドバイザの実行の統計が表示されます。

関連項目:

取得と適用の複合による最適化の詳細は、『Oracle Streams概要および管理』を参照してください。