105 DBMS_RESOURCE_MANAGER

DBMS_RESOURCE_MANAGERパッケージは、プラン、コンシューマ・グループおよびプラン・ディレクティブをメンテナンスします。また、プラン・スキーマへの変更内容をグループ化する方法も提供します。

関連項目: データベース・リソース・マネージャの使用方法の詳細は、『Oracle Database管理者ガイド』を参照してください。

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

• DBMS_RESOURCE_MANAGERの使用方法

  • 推奨されないサブプログラム

  • セキュリティ・モデル

  • 定数

• DBMS_RESOURCE_MANAGERサブプログラムの要約

---

DBMS_RESOURCE_MANAGERの使用方法

• 推奨されないサブプログラム

• セキュリティ・モデル

• 定数

---

推奨されないサブプログラム

注意: 新しいアプリケーションでは、これらのプロシージャを使用しないことをお薦めします。これらのプロシージャは、下位互換性を維持する目的のみでサポートされています。

Oracle Database 11gでは、次のサブプログラムの使用は推奨されていません。

• SET_INITIAL_CONSUMER_GROUPプロシージャ

---

セキュリティ・モデル

実行者には、このプロシージャを実行するためのADMINISTER_RESOURCE_MANAGERシステム権限が必要です。 この権限の付与および取消しを行うプロシージャは、DBMS_RESOURCE_MANAGER_PRIVSパッケージに含まれています（第106章「DBMS_RESOURCE_MANAGER_PRIVS」を参照）。

---

定数

表105-1 DBMS_RESOURCE_MANAGERの定数

定数	定義
CLIENT_MACHINE	CONSTANT VARCHAR2(30):= 'CLIENT_MACHINE';
CLIENT_OS_USER	CONSTANT VARCHAR2(30):= 'CLIENT_OS_USER';
CLIENT_PROGRAM	CONSTANT VARCHAR2(30):= 'CLIENT_PROGRAM';
MODULE_NAME	CONSTANT VARCHAR2(30):= 'MODULE_NAME';
MODULE_NAME_ACTION	CONSTANT VARCHAR2(30):= 'MODULE_NAME_ACTION';
ORACLE_USER	CONSTANT VARCHAR2(30):= 'ORACLE_USER'
SERVICE_MODULE	CONSTANT VARCHAR2(30):= 'SERVICE_MODULE';
SERVICE_MODULE_ACTION	CONSTANT VARCHAR2(30):= 'SERVICE_MODULE_ACTION';
SERVICE_NAME	CONSTANT VARCHAR2(30):= 'SERVICE_NAME';
PERFORMANCE_CLASS	CONSTANT VARCHAR2(30):= 'PERFORMANCE_CLASS';

---

DBMS_RESOURCE_MANAGERサブプログラムの要約

表105-2 DBMS_RESOURCE_MANAGERパッケージのサブプログラム

サブプログラム	説明
CALIBRATE_IOプロシージャ	ストレージのI/O機能を較正します。
CLEAR_PENDING_AREAプロシージャ	リソース・マネージャに対する作業領域を消去します。
CREATE_CONSUMER_GROUPプロシージャ	リソース・コンシューマ・グループを定義するエントリを作成します。
CREATE_PENDING_AREAプロシージャ	リソース・マネージャ・オブジェクトへの変更を行うための作業領域を作成します。
CREATE_PLANプロシージャ	リソース・プランを定義するエントリを作成します。
CREATE_PLAN_DIRECTIVEプロシージャ	リソース・プラン・ディレクティブを作成します。
CREATE_SIMPLE_PLANプロシージャ	最大8つのコンシューマ・グループが含まれた単一レベルのリソース・プランを1ステップで作成します。
DELETE_CONSUMER_GROUPプロシージャ	リソース・コンシューマ・グループを定義するエントリを削除します。
DELETE_PLANプロシージャ	指定のプランおよびそれが参照するすべてのプラン・ディレクティブを削除します。
DELETE_PLAN_CASCADEプロシージャ	指定のプランおよびそのすべての子（プラン・ディレクティブ、サブプラン、コンシューマ・グループ）を削除します。
DELETE_PLAN_DIRECTIVEプロシージャ	リソース・プラン・ディレクティブを削除します。
SET_CONSUMER_GROUP_MAPPINGプロシージャ	ログイン属性およびランタイム属性のマッピングに使用するエントリを追加、削除または変更します。
SET_CONSUMER_GROUP_MAPPING_PRIプロシージャ	セッション属性マッピングの優先順位リストを作成します。
SET_INITIAL_CONSUMER_GROUPプロシージャ	ユーザーに対して、初期リソース・コンシューマ・グループを割り当てます。 （注意: 推奨されないサブプログラム）
SUBMIT_PENDING_AREAプロシージャ	リソース・マネージャに対する保留中の変更を実行します。
SWITCH_CONSUMER_GROUP_FOR_SESSプロシージャ	指定のセッションのリソース・コンシューマ・グループを変更します。
SWITCH_CONSUMER_GROUP_FOR_USERプロシージャ	指定のユーザー名で、すべてのセッションのリソース・コンシューマ・グループを変更します。
SWITCH_PLANプロシージャ	現行のリソース・マネージャ・プランを設定します。
UPDATE_CONSUMER_GROUPプロシージャ	リソース・コンシューマ・グループを定義するエントリを更新します。
UPDATE_PLANプロシージャ	リソース・プランを定義するエントリを更新します。
UPDATE_PLAN_DIRECTIVEプロシージャ	リソース・プラン・ディレクティブを更新します。
VALIDATE_PENDING_AREAプロシージャ	リソース・マネージャに対する保留中の変更を検証します。

---

CALIBRATE_IOプロシージャ

このプロシージャは、ストレージのI/O機能を較正します。 較正ステータスはV$IO_CALIBRATION_STATUSビューから利用可能であり、較正が正常に実行された場合、結果はDBA_RSRC_IO_CALIBRATE表に配置されます。

構文

DBMS_RESOURCE_MANAGER.CALIBRATE_IO (
   num_physical_disks      IN  PLS_INTEGER DEFAULT 1,
   max_latency             IN  PLS_INTEGER DEFAULT 20,
   max_iops                OUT PLS_INTEGER,
   max_mbps                OUT PLS_INTEGER,
   actual_latency          OUT PLS_INTEGER);

パラメータ

表105-3 CALIBRATE_IOプロシージャのパラメータ

パラメータ	説明
num_physical_disks	データベース記憶域にある物理ディスクの概数。
max_latency	データベース・ブロック・サイズのIOリクエストの最大許容待機時間（ミリ秒）。
max_iops	維持できるI/Oリクエストの最大数（秒）。I/Oリクエストは、ランダムに分散されるデータベース・ブロック・サイズの読取りです。
max_mbps	維持できるI/Oスループットの最大数（MB/秒単位）。I/Oリクエストは、ランダムに分散される1MBの読取りです。
actual_latency	max_iops値でのデータベース・ブロック・サイズのI/Oリクエストの平均待機時間（ミリ秒）。

使用上の注意

• このプロシージャは、SYSDBA権限を持つユーザーのみが実行できます。 また、権限を持つユーザーは、timed_statisticsをオンにし、asynch_ioがデータファイルに対して有効になっていることを確認する必要もあります。 この設定は、filesystemio_optionsをASYNCHまたはSETALLのいずれかに設定することによって行うことができます。 また、次のSQL文を使用して、asynch_ioステータスを問い合せることもできます。

  col name format a50
  SELECT name, asynch_io FROM v$datafile f,v$iostat_file i
    WHERE f.file#        = i.file_no
    AND   filetype_name  = 'Data File'
   /
  

• 一度に実行できる較正は1つのみです。別の較正を同時に開始すると失敗します。

• Oracle Real Application Clusters（RAC）データベースでは、ワークロードはすべてのインスタンスから同時に生成されます。

関連項目: 較正の詳細は、『Oracle Databaseパフォーマンス・チューニング・ガイド』を参照してください。

例

I/O較正プロシージャの使用例

SET SERVEROUTPUT ON
DECLARE
  lat  INTEGER;
  iops INTEGER;
  mbps INTEGER;
BEGIN
-- DBMS_RESOURCE_MANAGER.CALIBRATE_IO (<DISKS>, <MAX_LATENCY>, iops, mbps, lat);
   DBMS_RESOURCE_MANAGER.CALIBRATE_IO (2, 10, iops, mbps, lat);

  DBMS_OUTPUT.PUT_LINE ('max_iops = ' || iops);
  DBMS_OUTPUT.PUT_LINE ('latency  = ' || lat);
  dbms_output.put_line('max_mbps = ' || mbps);
end;
/

I/O較正結果の表示

SQL> desc V$IO_CALIBRATION_STATUS
  Name                                      Null?    Type
  ----------------------------------------- -------- ----------------------------
  STATUS                                             VARCHAR2(13)
  CALIBRATION_TIME                                   TIMESTAMP(3)

SQL> desc gv$io_calibration_status
  Name                                      Null?    Type
  ----------------------------------------- -------- ----------------------------
  INST_ID                                            NUMBER
  STATUS                                             VARCHAR2(13)
  CALIBRATION_TIME                                   TIMESTAMP(3)

Column explanation:
-------------------
STATUS:
  IN PROGRESS   : Calibration in Progress (Results from previous calibration
                  run displayed, if available)
  READY         : Results ready and available from earlier run
  NOT AVAILABLE : Calibration results not available.

CALIBRATION_TIME: End time of the last calibration run

I/O較正結果を格納するDBA表

SQL> desc DBA_RSRC_IO_CALIBRATE
  Name                                      Null?    Type
  ----------------------------------------- -------- ----------------------------
  START_TIME                                         TIMESTAMP(6)
  END_TIME                                           TIMESTAMP(6)
  MAX_IOPS                                           NUMBER
  MAX_MBPS                                           NUMBER
  MAX_PMBPS                                          NUMBER
  LATENCY                                            NUMBER
  NUM_PHYSICAL_DISKS                                 NUMBER

comment on table DBA_RSRC_IO_CALIBRATE is
'Results of the most recent I/O calibration'
/
comment on column DBA_RSRC_IO_CALIBRATE.START_TIME is
'start time of the most recent I/O calibration'
/
comment on column DBA_RSRC_IO_CALIBRATE.END_TIME is
'end time of the most recent I/O calibration'
/
comment on column DBA_RSRC_IO_CALIBRATE.MAX_IOPS is
'maximum number of data-block read requests that can be sustained per second'
/
comment on column DBA_RSRC_IO_CALIBRATE.MAX_MBPS is
'maximum megabytes per second of maximum-sized read requests that can be
sustained'
/
comment on column DBA_RSRC_IO_CALIBRATE.MAX_PMBPS is
'maximum megabytes per second of large I/O requests that
can be sustained by a single process'
/
comment on column DBA_RSRC_IO_CALIBRATE.LATENCY is
'latency for data-block read requests'
/
comment on column DBA_RSRC_IO_CALIBRATE.NUM_PHYSICAL_DISKS is
'number of physical disks in the storage subsystem (as specified by user)'
/

---

CLEAR_PENDING_AREAプロシージャ

このプロシージャは、リソース・マネージャに対する保留中の変更内容を消去します。

構文

DBMS_RESOURCE_MANAGER.CLEAR_PENDING_AREA;

---

CREATE_CONSUMER_GROUPプロシージャ

このプロシージャは、リソース・コンシューマ・グループを定義するエントリを作成します。

構文

DBMS_RESOURCE_MANAGER.CREATE_CONSUMER_GROUP (
   consumer_group  IN VARCHAR2,
   comment         IN VARCHAR2,
   cpu_mth         IN VARCHAR2 DEFAULT NULL,
   mgmt_mth        IN VARCHAR2 DEFAULT 'ROUND-ROBIN');

パラメータ

表105-4 CREATE_CONSUMER_GROUPプロシージャのパラメータ

パラメータ	説明
consumer_group	コンシューマ・グループの名前。
comment	ユーザーのコメント。
cpu_mth	CPUリソース割当て方法の名前（非推奨）。
mgmt_mth	CPUリソース割当て方法の名前。

---

CREATE_PENDING_AREAプロシージャ

このプロシージャは、リソース・マネージャ・オブジェクトに変更を加えます。

プラン・スキーマへのすべての変更は、ペンディング・エリア内で行う必要があります。ペンディング・エリアは、プラン・スキーマを変更するためのスクラッチ領域とみなすことができます。管理者は、このペンディング・エリアを作成し、必要に応じて変更を加え、場合によってその変更を検証します。その実行が完了したときのみ、その変更内容がアクティブになります。

構文

DBMS_RESOURCE_MANAGER.CREATE_PENDING_AREA;

使用上の注意

ペンディング・エリアがアクティブな間は、変更された現行のプラン・スキーマを適切なユーザー・ビューから選択して、いつでも表示できます。

現行の変更を中止する場合は、いつでもペンディング・エリアを消去できます。また、VALIDATEプロシージャをコールして、変更が有効になっているかどうかを確認できます。変更は、エントリ・グループの一貫性を維持するための指定の順序で行う必要はありません。これらのチェックは、ペンディング・エリアが実行されるときにも暗黙的に行われます。

注意: Oracleでは、孤立したコンシューマ・グループ（つまり、そのコンシューマ・グループを参照するプラン・ディレクティブがないコンシューマ・グループ）が可能です。これは、現在は使用しないが将来使用するコンシューマ・グループを管理者があらかじめ作成できるようにするためです。

次のルールを厳守してください。これらのルールは、VALIDATEまたはSUBMITプロシージャが実行されるたびにチェックされます。

• プラン・スキーマにループがないこと。

• プラン・ディレクティブが参照するすべてのプランおよびコンシューマ・グループがあること。

• すべてのプランに、プランまたはコンシューマ・グループのいずれかを参照するプラン・ディレクティブがあること。

• リソース割当て方法がEMPHASISの場合は、指定レベルでのパーセントの合計が100を超えないこと。

• アクティブなインスタンスでトップレベルのプランとして現在使用されているプランを削除しないこと。

• Oracle8iの場合、プラン・ディレクティブのパラメータparallel_degree_limit_p1は、コンシューマ・グループ（つまり、サブプランではなく）を参照するプラン・ディレクティブでのみ表示されます。

• 指定のプランでのプラン・ディレクティブが32を超えないこと（つまり、プランは33以上の子を持つことはできません）。

• アクティブなプラン・スキーマ内のコンシューマ・グループが32を超えないこと。

• プランとコンシューマ・グループは同じネームスペースを使用するため、コンシューマ・グループと同じ名前のプランがないこと。

• アクティブなプラン・スキーマ内にOTHER_GROUPSに対するプラン・ディレクティブがあること。これにより、現在アクティブなプランがカバーしていないセッションにOTHER_GROUPSディレクティブが指定したリソースが割り当てられます。

VALIDATEまたはSUBMITプロシージャによるチェック時に、前述のルールのいずれかに違反していると、それを通知するエラー・メッセージが戻されます。 変更して問題を修正し、VALIDATEまたはSUBMITプロシージャを再発行できます。

---

CREATE_PLANプロシージャ

このプロシージャは、リソース・プランを定義するエントリを作成します。

構文

DBMS_RESOURCE_MANAGER.CREATE_PLAN (
   plan                       IN   VARCHAR2,
   comment                    IN   VARCHAR2,
   cpu_mth                    IN   VARCHAR2 DEFAULT NULL, -- deprecated
   active_sess_pool_mth       IN   VARCHAR2 DEFAULT 'ACTIVE_SESS_POOL_ABSOLUTE',
   parallel_degree_limit_mth  IN   VARCHAR2 DEFAULT
                                      'PARALLEL_DEGREE_LIMIT_ABSOLUTE',
   queueing_mth               IN   VARCHAR2 DEFAULT 'FIFO_TIMEOUT',
   mgmt_mth                   IN   VARCHAR2 DEFAULT 'EMPHASIS');

パラメータ

表105-5 CREATE_PLANプロシージャのパラメータ

パラメータ	説明
plan	リソース・プランの名前。
comment	ユーザーのコメント。
cpu_mth	CPUリソース割当て方法（非推奨）。
active_sess_pool_mth	アクティブ・セッション・プールのリソース割当て方法。アクティブなセッションの数を制限します。他のセッションはすべて非アクティブになり、アクティブ化されるまでキューで待機します。 デフォルトのACTIVE_SESS_POOL_ABSOLUTEは、選択できる唯一の方法です。
parallel_degree_limit_mth	任意の操作の並列度に制限を指定するためのリソース割当て方法。 デフォルトのPARALLEL_DEGREE_LIMIT_ABSOLUTEは、選択できる唯一の方法です。
queueing_mth	キューイングのリソース割当て方法。キュー内で実行待ちになっている非アクティブなセッションを実行する順序を制御します。 デフォルトのFIFO_TIMEOUTは、選択できる唯一の方法です。
mgmt_mth	コンシューマ・グループやサブ・プランがそれぞれ使用するリソース量（CPUやI/Oなど）を指定するためのリソース割当て方法。 EMPHASIS: コンシューマ・グループ間でのI/Oリソースの分散方法を指定する際にパーセントを使用する、マルチレベル・プランに向いています。 RATIO: I/Oリソースの分散方法を指定する際に比率を使用する、単一レベルのプランに向いています。

使用上の注意

デフォルトのリソース割当て方法を使用する場合は、プランの作成または更新時に方法を指定する必要はありません。

---

CREATE_PLAN_DIRECTIVEプロシージャ

このプロシージャは、リソース・プラン・ディレクティブを作成します。

構文

DBMS_RESOURCE_MANAGER.CREATE_PLAN_DIRECTIVE (
   plan                      IN VARCHAR2,
   group_or_subplan          IN VARCHAR2,
   comment                   IN VARCHAR2,
   cpu_p1                    IN NUMBER   DEFAULT NULL, -- deprecated
   cpu_p2                    IN NUMBER   DEFAULT NULL, -- deprecated
   cpu_p3                    IN NUMBER   DEFAULT NULL, -- deprecated
   cpu_p4                    IN NUMBER   DEFAULT NULL, -- deprecated
   cpu_p5                    IN NUMBER   DEFAULT NULL, -- deprecated
   cpu_p6                    IN NUMBER   DEFAULT NULL, -- deprecated
   cpu_p7                    IN NUMBER   DEFAULT NULL, -- deprecated
   cpu_p8                    IN NUMBER   DEFAULT NULL, -- deprecated
   active_sess_pool_p1       IN NUMBER   DEFAULT NULL,
   queueing_p1               IN NUMBER   DEFAULT NULL,
   parallel_degree_limit_p1  IN NUMBER   DEFAULT NULL,
   switch_group              IN VARCHAR2 DEFAULT NULL,
   switch_time               IN NUMBER   DEFAULT NULL,
   switch_estimate           IN BOOLEAN  DEFAULT FALSE,
   max_est_exec_time         IN NUMBER   DEFAULT NULL,
   undo_pool                 IN NUMBER   DEFAULT NULL,
   max_idle_time             IN NUMBER   DEFAULT NULL,
   max_idle_blocker_time     IN NUMBER   DEFAULT NULL,
   switch_time_in_call       IN NUMBER   DEFAULT NULL, -- deprecated
   mgmt_p1                   IN NUMBER   DEFAULT NULL,
   mgmt_p2                   IN NUMBER   DEFAULT NULL,
   mgmt_p3                   IN NUMBER   DEFAULT NULL,
   mgmt_p4                   IN NUMBER   DEFAULT NULL,
   mgmt_p5                   IN NUMBER   DEFAULT NULL,
   mgmt_p6                   IN NUMBER   DEFAULT NULL,
   mgmt_p7                   IN NUMBER   DEFAULT NULL,
   mgmt_p8                   IN NUMBER   DEFAULT NULL,
   switch_io_megabytes       IN NUMBER   DEFAULT NULL,
   switch_io_reqs            IN NUMBER   DEFAULT NULL,
   switch_for_call           IN BOOLEAN  DEFAULT NULL);

パラメータ

表105-6 CREATE_PLAN_DIRECTIVEプロシージャのパラメータ

パラメータ	説明
plan	リソース・プランの名前。
group_or_subplan	コンシューマ・グループの名前またはサブプランの名前。
comment	プラン・ディレクティブについてのコメント。
cpu_p1	CPUリソース割当て方法の最初のパラメータ（非推奨、mgmt_p1をかわりに使用）。
cpu_p2	CPUリソース割当て方法の2番目のパラメータ（非推奨、mgmt_p2をかわりに使用）。
cpu_p3	CPUリソース割当て方法の3番目のパラメータ（非推奨、mgmt_p3をかわりに使用）。
cpu_p4	CPUリソース割当て方法の4番目のパラメータ（非推奨、mgmt_p4をかわりに使用）。
cpu_p5	CPUリソース割当て方法の5番目のパラメータ（非推奨、mgmt_p5をかわりに使用）。
cpu_p6	CPUリソース割当て方法の6番目のパラメータ（非推奨、mgmt_p6をかわりに使用）。
cpu_p7	CPUリソース割当て方法の7番目のパラメータ（非推奨、mgmt_p7をかわりに使用）。
cpu_p8	CPUリソース割当て方法の8番目のパラメータ（非推奨、mgmt_p8をかわりに使用）。
active_sess_pool_p1	コンシューマ・グループに対するアクティブな同時セッションの最大数を指定します。デフォルトのNULLは、無制限を意味します。
queueing_p1	非アクティブ・セッション・キューにあるジョブ（実行待ち状態のジョブ）がタイムアウトする時間（秒）を指定します。デフォルトのNULLは、無制限を意味します。
parallel_degree_limit_p1	任意の操作の並列度を制限します。デフォルトのNULLは、無制限を意味します。
switch_group	切替え条件に達した場合に、切り替えるコンシューマ・グループを指定します。 グループ名が'CANCEL_SQL'の場合は、切替え条件に達したときに現行のコールが取り消されます。 グループ名が'KILL_SESSION'の場合は、切替え条件に達したときにセッションが終了します。デフォルトはNULLです。
switch_time	アクションの実行前にセッションを実行できる時間（秒）を指定します。デフォルトのNULLは、無制限を意味します。
switch_estimate	TRUEの場合は、実行前に、見積り実行時間が操作のコンシューマ・グループに自動的に切り換えられるようにOracleに指示します。デフォルトはFALSEです。
max_est_exec_time	セッションに許可する実行時間（秒）の最大値を指定します。操作時間がMAX_EST_EXEC_TIMEより長いとオプティマイザが判断した場合、その操作は開始されず、ORA-07455が発行されます。オプティマイザが判断しない場合は、このディレクティブの効果はありません。デフォルトのNULLは、無制限を意味します。
undo_pool	コンシューマ・グループによって生成される取消しの合計量の最大値を、キロバイト（K）単位で設定します。デフォルトのNULLは、無制限を意味します。
max_idle_time	セッションのアイドル時間の最大値を示します。デフォルトのNULLは、無制限を意味します。
max_idle_blocker_time	別のセッションのリソース取得をブロックしながら、セッションのアイドル状態を維持できる時間（秒）の最大値。
switch_time_in_call	非推奨。 このパラメータを指定すると、switch_timeがswitch_time_in_callに設定され、switch_for_callがTRUEに設定されます。
mgmt_p1	レベル1のリソース割当て値（cpu_p1のかわり）。 EMPHASIS: リソースのパーセントを第1レベルに指定します。 RATIO: リソース使用率の重みを指定します。
mgmt_p2	レベル2のリソース割当て値（cpu_p2のかわり）。 EMPHASIS: リソースのパーセントを第2レベルに指定します。 RATIO: なし
mgmt_p3	レベル3のリソース割当て値（cpu_p3のかわり）。 EMPHASIS: リソースのパーセントを第3レベルに指定します。 RATIO: なし
mgmt_p4	レベル4のリソース割当て値（cpu_p4のかわり）。 EMPHASIS: リソースのパーセントを第4レベルに指定します。 RATIO: なし
mgmt_p5	レベル5のリソース割当て値（cpu_p5のかわり）。 EMPHASIS: リソースのパーセントを第5レベルに指定します。 RATIO: なし
mgmt_p6	レベル6のリソース割当て値（cpu_p6のかわり）。 EMPHASIS: リソースのパーセントを第6レベルに指定します。 RATIO: なし
mgmt_p7	レベル7のリソース割当て値（cpu_p7のかわり）。 EMPHASIS: リソースのパーセントを第7レベルに指定します。 RATIO: なし
mgmt_p8	レベル8のリソース割当て値（cpu_p8のかわり）。 EMPHASIS: リソースのパーセントを第8レベルに指定します。 RATIO: なし
switch_io_megabytes	アクションの実行前にセッションが発行できるI/Oの量（MB）を指定します。デフォルトのNULLは、無制限を意味します。
switch_io_reqs	アクションの実行前にセッションが発行できるI/Oリクエストの数を指定します。デフォルトのNULLは、無制限を意味します。
switch_for_call	switch_time、switch_io_megabytesまたはswitch_io_reqsパラメータのためにアクションが実行される場合、最初のコールの終了時に、コンシューマ・グループが元のコンシューマ・グループにリストアされるように指定します。デフォルト値のFALSEは、最初のコールの終了時に元のコンシューマ・グループがリストアされないことを意味します。

使用上の注意

• すべてのパラメータは、NULLにデフォルト設定されます。ただし、CPUリソース割当て方法がEMPHASISの場合は、ユーザーがすべてのパラメータを入力する必要があります。

• max_idle_timeおよびmax_idle_blocker_timeに指定された制限値については、PMONが1分に1回確認します。いずれかの制限を超過したセッションが見つかると、そのセッションは強制終了され、すべての状態がクリーン・アップされます。

• 中間層サーバーによるセッション・プーリングの実装が行われている場合の3層アプリケーションでは、ほとんどの場合、パラメータswitch_time_in_callは有用です。 switch_time_in_callを使用した場合のクライアントのリソース使用率は、今後別のクライアントが偶然同じセッションで実行されても影響しません。

---

CREATE_SIMPLE_PLANプロシージャ

このプロシージャでは、最大8つのコンシューマ・グループが含まれた単一レベルのリソース・プランを1ステップで作成します。 リソース・プランの作成前にペンディング・エリアを手動で作成したり、CREATE_CONSUMER_GROUPプロシージャおよびCREATE_RESOURCE_PLAN_DIRECTIVESプロシージャを個別に使用する必要がありません。

構文

DBMS_RESOURCE_MANAGER.CREATE_SIMPLE_PLAN (
   simple_plan      IN  VARCHAR2  DEFAULT NULL,
   consumer_group1  IN  VARCHAR2  DEFAULT NULL,
   group1_cpu       IN  NUMBER    DEFAULT NULL,   -- deprecated
   consumer_group2  IN  VARCHAR2  DEFAULT NULL,
   group2_cpu       IN  NUMBER    DEFAULT NULL,   -- deprecated
   consumer_group3  IN  VARCHAR2  DEFAULT NULL,
   group3_cpu       IN  NUMBER    DEFAULT NULL,   -- deprecated
   consumer_group4  IN  VARCHAR2  DEFAULT NULL,
   group4_cpu       IN  NUMBER    DEFAULT NULL,   -- deprecated
   consumer_group5  IN  VARCHAR2  DEFAULT NULL,
   group5_cpu       IN  NUMBER    DEFAULT NULL,   -- deprecated
   consumer_group6  IN  VARCHAR2  DEFAULT NULL,
   group6_cpu       IN  NUMBER    DEFAULT NULL,   -- deprecated
   consumer_group7  IN  VARCHAR2  DEFAULT NULL,
   group7_cpu       IN  NUMBER    DEFAULT NULL,   -- deprecated
   consumer_group8  IN  VARCHAR2  DEFAULT NULL,
   group8_cpu       IN  NUMBER    DEFAULT NULL,   -- deprecated
   group1_percent   IN  NUMBER    DEFAULT NULL,
   group2_percent   IN  NUMBER    DEFAULT NULL,
   group3_percent   IN  NUMBER    DEFAULT NULL,
   group4_percent   IN  NUMBER    DEFAULT NULL,
   group5_percent   IN  NUMBER    DEFAULT NULL,
   group6_percent   IN  NUMBER    DEFAULT NULL,
   group7_percent   IN  NUMBER    DEFAULT NULL,
   group8_percent   IN  NUMBER    DEFAULT NULL);

パラメータ

表105-7 CREATE_SIMPLE_PLANプロシージャのパラメータ

パラメータ	説明
simple_plan	リソース・プランの名前。
consumer_group1	コンシューマ・グループの名前。
group1_cpu	グループのパーセント（非推奨）。
consumer_group2	コンシューマ・グループの名前。
group2_cpu	グループのパーセント（非推奨）。
consumer_group3	コンシューマ・グループの名前。
group3_cpu	グループのパーセント（非推奨）。
consumer_group4	コンシューマ・グループの名前。
group4_cpu	グループのパーセント（非推奨）。
consumer_group5	コンシューマ・グループの名前。
group5_cpu	グループのパーセント（非推奨）。
consumer_group6	コンシューマ・グループの名前。
group6_cpu	グループのパーセント（非推奨）。
consumer_group7	コンシューマ・グループの名前。
group7_cpu	グループのパーセント（非推奨）。
consumer_group8	コンシューマ・グループの名前。
group8_cpu	グループのパーセント（非推奨）。
group1_percent	このコンシューマ・グループに割り当てられたリソースのパーセント。
group2_percent	このコンシューマ・グループに割り当てられたリソースのパーセント。
group3_percent	このコンシューマ・グループに割り当てられたリソースのパーセント。
group4_percent	このコンシューマ・グループに割り当てられたリソースのパーセント。
group5_percent	このコンシューマ・グループに割り当てられたリソースのパーセント。
group6_percent	このコンシューマ・グループに割り当てられたリソースのパーセント。
group7_percent	このコンシューマ・グループに割り当てられたリソースのパーセント。
group8_percent	このコンシューマ・グループに割り当てられたリソースのパーセント。

---

DELETE_CONSUMER_GROUPプロシージャ

このプロシージャは、リソース・コンシューマ・グループを定義するエントリを削除します。

構文

DBMS_RESOURCE_MANAGER.DELETE_CONSUMER_GROUP (
   consumer_group IN VARCHAR2);

パラメータ

表105-8 DELETE_CONSUMER_GROUPプロシージャのパラメータ

パラメータ	説明
consumer_group	削除されるコンシューマ・グループの名前。

---

DELETE_PLANプロシージャ

このプロシージャは、指定のプランおよびそれが参照するすべてのプラン・ディレクティブを削除します。

構文

DBMS_RESOURCE_MANAGER.DELETE_PLAN (
   plan IN VARCHAR2);

パラメータ

表105-9 DELETE_PLANプロシージャのパラメータ

パラメータ	説明
plan	削除するリソース・プランの名前。

---

DELETE_PLAN_CASCADEプロシージャ

このプロシージャは、指定のプランおよびそのすべての子（プラン・ディレクティブ、サブプラン、コンシューマ・グループ）を削除します。必須オブジェクトおよび必須ディレクティブは削除されません。

構文

DBMS_RESOURCE_MANAGER.DELETE_PLAN_CASCADE (
   plan IN VARCHAR2);

パラメータ

表105-10 DELETE_PLAN_CASCADEプロシージャのパラメータ

パラメータ	説明
plan	プランの名前。

使用上の注意

DELETE_PLAN_CASCADEプロシージャでエラーが発生した場合は、ロールバックされるため、何も削除されません。

---

DELETE_PLAN_DIRECTIVEプロシージャ

このプロシージャは、リソース・プラン・ディレクティブを削除します。

構文

DBMS_RESOURCE_MANAGER.DELETE_PLAN_DIRECTIVE (
   plan              IN VARCHAR2,
   group_or_subplan  IN VARCHAR2);

パラメータ

表105-11 DELETE_PLAN_DIRECTIVEプロシージャのパラメータ

パラメータ	説明
plan	リソース・プランの名前。
group_or_subplan	グループの名前またはサブプランの名前。

---

SET_CONSUMER_GROUP_MAPPINGプロシージャ

このプロシージャは、セッションのログイン属性およびランタイム属性に基づいて、セッションをコンシューマ・グループにマップするエントリを追加、削除または変更します。

構文

DBMS_RESOURCE_MANAGER.SET_CONSUMER_GROUP_MAPPING(
   attribute       IN VARCHAR2,
   value            IN VARCHAR2,
   consumer_group  IN VARCHAR2 DEFAULT NULL);

パラメータ

表105-12 SET_CONSUMER_GROUP_MAPPINGプロシージャのパラメータ

パラメータ	説明
attribute	追加または変更するマッピング属性。リストされている定数のいずれかを指定します。
value	一致させる属性値。
consumer_group	マップされたコンシューマ・グループの名前。マッピングを削除する場合はNULLを指定します。

使用上の注意

指定された属性および値に対するマッピングが存在しない場合は、指定されたコンシューマ・グループへのマッピングが作成されます。指定された属性および値に対するマッピングがすでに存在する場合、マッピング先のコンシューマ・グループは、指定された属性および値を持つコンシューマ・グループに更新されます。 consumer_group引数がNULLの場合は、指定された属性および値からのマッピングがすべて削除されます。

---

SET_CONSUMER_GROUP_MAPPING_PRIプロシージャ

1つのセッションが持つ複数の属性を使用して、セッションをコンシューマ・グループにマップできます。このプロシージャでは、属性のマッピングにおける優先順位を指定します。

構文

DBMS_RESOURCE_MANAGER.SET_CONSUMER_GROUP_MAPPING_PRI(
   explicit               IN NUMBER,
   oracle_user            IN NUMBER,
   service_name           IN NUMBER,
   client_os_user         IN NUMBER,
   client_program         IN NUMBER,
   client_machine         IN NUMBER,
   module_name            IN NUMBER,
   module_name_action     IN NUMBER,
   service_module         IN NUMBER,
   service_module_action  IN NUMBER);

パラメータ

表105-13 SET_CONSUMER_GROUP_MAPPING_PRIプロシージャのパラメータ

パラメータ	説明
explicit	明示的マッピングの優先順位。
oracle_user	Oracleユーザー名のマッピングの優先順位。
service_name	クライアント・サービス名のマッピングの優先順位。
client_os_user	クライアント・オペレーティング・システムのユーザー名のマッピングの優先順位。
client_program	クライアント・プログラムのマッピングの優先順位。
client_machine	クライアント・マシンのマッピングの優先順位。
module_name	アプリケーション・モジュール名のマッピングの優先順位。
module_name_action	アプリケーション・モジュール名およびアプリケーション・アクションのマッピングの優先順位。
service_module	サービス名およびアプリケーション・モジュール名のマッピングの優先順位。
module_name_action	サービス名、アプリケーション・モジュール名およびアプリケーション・アクションのマッピングの優先順位。

使用上の注意

• このプロシージャには、引数として擬似属性explicitを含める必要があります。値は、1に設定する必要があります。これは、コンシューマ・グループの明示的な切替えが最も高い優先順位であることを示します。コンシューマ・グループの明示的な切替えは、次のパッケージ・プロシージャを使用して実行します。

  • DBMS_SESSION.SWITCH_CURRENT_CONSUMER_GROUP

  • DBMS_RESOURCE_MANAGER.SWITCH_CONSUMER_GROUP_FOR_SESS

  • DBMS_RESOURCE_MANAGER.SWITCH_CONSUMER_GROUP_FOR_USER

• 優先順位を指定する値は、それぞれ1から10の一意の整数にしてください。優先順位1から10を使用する場合、優先順位が最も高いのは1、最も低いのは10です。

---

SET_INITIAL_CONSUMER_GROUPプロシージャ

注意: 11g リリース1では、このプロシージャの使用は推奨されていません。このパッケージでこのプロシージャを使用することはできますが、初期コンシューマ・グループは、セッションとコンシューマ間のグループのマッピング・ルールによって設定されます。

ユーザーの初期コンシューマ・グループは、そのユーザーが作成したセッションが最初に所属しているコンシューマ・グループです。このプロシージャは、ユーザーに対して、初期のリソース・コンシューマ・グループを設定します。

構文

DBMS_RESOURCE_MANAGER.SET_INITIAL_CONSUMER_GROUP (
   user           IN VARCHAR2,
   consumer_group IN VARCHAR2);

パラメータ

表105-14 SET_INITIAL_CONSUMER_GROUPプロシージャのパラメータ

パラメータ	説明
user	ユーザーの名前。
consumer_group	ユーザーの初期コンシューマ・グループ。

使用上の注意

このプロシージャを実行するためには、ADMINISTER_RESOURCE_MANAGERまたはALTER USERシステム権限が必要です。ユーザーの初期コンシューマ・グループが設定される前に、ユーザーまたはPUBLICに対して、コンシューマ・グループへの切替え権限が直接付与されている必要があります。初期コンシューマ・グループに対する切替え権限は、そのユーザーに付与されているロールから与えることはできません。

注意: この方法は、ALTER USER DEFAULT ROLEに対する方法に類似しています。

ユーザーの初期コンシューマ・グループが設定されていない場合は、自動的にDEFAULT_CONSUMER_GROUPがコンシューマ・グループになります。

DEFAULT_CONSUMER_GROUPはPUBLICに付与された切替え権限を持つため、すべてのユーザーはこのコンシューマ・グループに対する切替え権限を自動的に付与されます。 コンシューマ・グループを削除するとき、削除するグループを初期コンシューマ・グループとしていたすべてのユーザーは、DEFAULT_CONSUMER_GROUPを初期コンシューマ・グループとします。 削除するコンシューマ・グループに所属している現行のアクティブなセッションは、すべてDEFAULT_CONSUMER_GROUPに切り替えられます。

---

SUBMIT_PENDING_AREAプロシージャ

このプロシージャは、リソース・マネージャに対する保留中の変更を発行します。変更内容を検証してコミットした後（その変更内容が有効な場合）、ペンディング・エリアを消去します。

注意: SUBMIT_PENDING_AREAへのコールは、VALIDATE_PENDING_AREAが成功していても失敗する場合があります。 これは、VALIDATE_PENDING_AREAをコールした後に、削除中のプランがインスタンスによってSUBMIT_PENDING_AREAをコールするまでにロードされてしまうことが原因です。

構文

DBMS_RESOURCE_MANAGER.SUBMIT_PENDING_AREA;

---

SWITCH_CONSUMER_GROUP_FOR_SESSプロシージャ

このプロシージャは、指定のセッションのリソース・コンシューマ・グループを変更します。また、トップレベルのユーザー・セッションに関連する（PQ）スレーブ・セッションのコンシューマ・グループも変更します。

構文

DBMS_RESOURCE_MANAGER.SWITCH_CONSUMER_GROUP_FOR_SESS (
   session_id      IN NUMBER,
   session_serial  IN NUMBER,
   consumer_group  IN VARCHAR2);

パラメータ

表105-15 SWITCH_CONSUMER_GROUP_FOR_SESSプロシージャのパラメータ

パラメータ	説明
session_id	ビューV$SESSIONでのSID列。
session_serial	ビューV$SESSIONでのSERIAL#列。
consumer_group	切り替えるコンシューマ・グループの名前。

---

SWITCH_CONSUMER_GROUP_FOR_USERプロシージャ

このプロシージャは、指定のユーザーIDを持つすべてのセッションに対するリソース・コンシューマ・グループを変更します。また、トップレベルのユーザー・セッションに関連する（PQ）スレーブ・セッションのコンシューマ・グループも変更します。

構文

DBMS_RESOURCE_MANAGER.SWITCH_CONSUMER_GROUP_FOR_USER (
   user            IN VARCHAR2,
   consumer_group  IN VARCHAR2);

パラメータ

表105-16 SWITCH_CONSUMER_GROUP_FOR_USERプロシージャのパラメータ

パラメータ	説明
user	ユーザーの名前。
consumer_group	切り替えるコンシューマ・グループの名前。

使用上の注意

SWITCH_CONSUMER_GROUP_FOR_SESSプロシージャおよびSWITCH_CONSUMER_GROUP_FOR_USERプロシージャは、特定のセッションまたはユーザーのCPUリソース割当てを増減します。これにより、UNIXのniceコマンドと類似した機能性が提供されます。

これらのプロシージャは、新規に指定されたコンシューマ・グループにセッションを即時に移動します。

---

SWITCH_PLANプロシージャ

このプロシージャは、現行のリソース・マネージャ・プランを設定します。

構文

DBMS_RESOURCE_MANAGER.SWITCH_PLAN(
   plan_name                     IN   VARCHAR2,
   sid                           IN   VARCHAR2 DEFAULT '*',
   allow_scheduler_plan_switches IN   BOOLEAN DEFAULT TRUE);

パラメータ

表105-17 SWITCH_PLANプロシージャのパラメータ

パラメータ	説明
plan_name	切替え先となるプランの名前。 plan_nameに空の文字列（''）を渡すと、リソース・マネージャは無効になります。
sid	sidパラメータを使用できるのは、Oracle Real Application Clusters環境のみです。このパラメータにより、プランを特定のインスタンスに対して変更できます。プランを変更するインスタンスのsidを指定します。 また、すべてのインスタンスに対してプランを変更する場合は、'*'を指定してください。
allow_scheduler_plan_switches	FALSEに設定すると、ウィンドウ境界でのジョブ・スケジューラによるプランの自動切替えが無効になります。 プランの自動切替えを再度有効にするには、管理者がallow_scheduler_plan_switchesをTRUEに設定して、switch_planを再度コールする必要があります。デフォルトでは、ジョブ・スケジューラによるプランの自動切替えは有効になっています。

---

UPDATE_CONSUMER_GROUPプロシージャ

このプロシージャは、リソース・コンシューマ・グループを定義するエントリを更新します。

構文

DBMS_RESOURCE_MANAGER.UPDATE_CONSUMER_GROUP (
   consumer_group  IN VARCHAR2,
   new_comment     IN VARCHAR2 DEFAULT NULL,
   new_cpu_mth     IN VARCHAR2 DEFAULT NULL,
   new_mgmt_mth    IN VARCHAR2 DEFAULT NULL);

パラメータ

表105-18 UPDATE_CONSUMER_GROUPプロシージャのパラメータ

パラメータ	説明
consumer_group	コンシューマ・グループの名前。
new_comment	新しいユーザーのコメント。
new_cpu_mth	CPUリソース割当てに対する新規の方法名（非推奨）。
new_mgmt_mth	CPUリソース割当てに対する新規の方法名。

使用上の注意

UPDATE_CONSUMER_GROUPに対するパラメータを指定しない場合、これらのパラメータは、データ・ディクショナリ内で変更されないまま残ります。

---

UPDATE_PLANプロシージャ

このプロシージャは、リソース・プランを定義するエントリを更新します。

構文

DBMS_RESOURCE_MANAGER.UPDATE_PLAN (
   plan                               IN VARCHAR2,
   new_comment                        IN VARCHAR2 DEFAULT NULL,
   new_cpu_mth                        IN VARCHAR2 DEFAULT NULL, -- deprecated
   new_active_sess_pool_mth           IN VARCHAR2 DEFAULT NULL,
   new_parallel_degree_limit_mth      IN VARCHAR2 DEFAULT NULL,
   new_queueing_mth                   IN VARCHAR2 DEFAULT NULL,
   new_queueing_mth                   IN VARCHAR2 DEFAULT NULL,
   new_mgmt_mth                       IN VARCHAR2 DEFAULT NULL);

パラメータ

表105-19 UPDATE_PLANプロシージャのパラメータ

パラメータ	説明
plan	リソース・プランの名前。
new_comment	新しいユーザーのコメント。
new_cpu_mth	CPUリソースに対する新規の割当て方法の名前（非推奨）。
new_active_sess_pool_mth	アクティブな最大セッションに対する新規の方法名。
new_parallel_degree_limit_mth	並列度に対する新規の方法名。
new_queueing_mth	アクティブなセッションのプール機能で使用するキューイング・ポリシーのタイプを指定します。
new_mgmt_mth	コンシューマ・グループやサブ・プランがそれぞれ使用するリソース量（CPUやI/Oなど）を指定するためのリソース割当て方法。 EMPHASIS: コンシューマ・グループ間でのI/Oリソースの分散方法を指定する際にパーセントを使用する、マルチレベル・プランに向いています。 RATIO: I/Oリソースの分散方法を指定する際に比率を使用する、単一レベルのプランに向いています。

使用上の注意

• UPDATE_PLANプロシージャに対するパラメータを指定しない場合、これらのパラメータは、データ・ディクショナリ内に変更されないまま残ります。

• デフォルトのリソース割当て方法を使用する場合は、プランの作成または更新時に方法を指定する必要はありません。

---

UPDATE_PLAN_DIRECTIVEプロシージャ

このプロシージャは、リソース・プラン・ディレクティブを更新します。

構文

DBMS_RESOURCE_MANAGER.UPDATE_PLAN_DIRECTIVE (
   plan                          IN VARCHAR2,
   group_or_subplan              IN VARCHAR2,
   new_comment                   IN VARCHAR2 DEFAULT NULL,
   new_cpu_p1                    IN NUMBER   DEFAULT NULL, -- deprecated
   new_cpu_p2                    IN NUMBER   DEFAULT NULL, -- deprecated
   new_cpu_p3                    IN NUMBER   DEFAULT NULL, -- deprecated
   new_cpu_p4                    IN NUMBER   DEFAULT NULL, -- deprecated
   new_cpu_p5                    IN NUMBER   DEFAULT NULL, -- deprecated
   new_cpu_p6                    IN NUMBER   DEFAULT NULL, -- deprecated
   new_cpu_p7                    IN NUMBER   DEFAULT NULL, -- deprecated
   new_cpu_p8                    IN NUMBER   DEFAULT NULL, -- deprecated
   new_active_sess_pool_p1       IN NUMBER   DEFAULT NULL,
   new_queueing_p1               IN NUMBER   DEFAULT NULL,
   new_parallel_degree_limit_p1  IN NUMBER   DEFAULT NULL,
   new_switch_group              IN VARCHAR2 DEFAULT NULL,
   new_switch_time               IN NUMBER   DEFAULT NULL,
   new_switch_estimate           IN BOOLEAN  DEFAULT FALSE,
   new_max_est_exec_time         IN NUMBER   DEFAULT NULL,
   new_undo_pool                 IN NUMBER   DEFAULT NULL,
   new_max_idle_time             IN NUMBER   DEFAULT NULL,
   new_max_idle_blocker_time     IN NUMBER   DEFAULT NULL,
   switch_time_in_call           IN NUMBER   DEFAULT NULL, -- deprecated
   mgmt_p1                       IN NUMBER   DEFAULT NULL,
   mgmt_p2                       IN NUMBER   DEFAULT NULL,
   mgmt_p3                       IN NUMBER   DEFAULT NULL,
   mgmt_p4                       IN NUMBER   DEFAULT NULL,
   mgmt_p5                       IN NUMBER   DEFAULT NULL,
   mgmt_p6                       IN NUMBER   DEFAULT NULL,
   mgmt_p7                       IN NUMBER   DEFAULT NULL,
   mgmt_p8                       IN NUMBER   DEFAULT NULL,
   switch_io_megabytes           IN NUMBER   DEFAULT NULL,
   switch_io_reqs                IN NUMBER   DEFAULT NULL,
   switch_for_call               IN BOOLEAN  DEFAULT NULL);

パラメータ

表105-20 UPDATE_PLAN_DIRECTIVEプロシージャのパラメータ

パラメータ	説明
plan	リソース・プランの名前。
group_or_subplan	コンシューマ・グループの名前またはサブプランの名前。
new_comment	プラン・ディレクティブについてのコメント。
new_cpu_p1	CPUリソース割当て方法の最初のパラメータ（非推奨、new_mgmt_p1をかわりに使用）。
new_cpu_p2	CPUリソース割当て方法のパラメータ（非推奨、new_mgmt_p2をかわりに使用）。
new_cpu_p3	CPUリソース割当て方法のパラメータ（非推奨、new_mgmt_p3をかわりに使用）。
new_cpu_p4	CPUリソース割当て方法のパラメータ（非推奨、new_mgmt_p4をかわりに使用）。
new_cpu_p5	CPUリソース割当て方法のパラメータ（非推奨、new_mgmt_p5をかわりに使用）。
new_cpu_p6	CPUリソース割当て方法のパラメータ（非推奨、new_mgmt_p6をかわりに使用）。
new_cpu_p7	CPUリソース割当て方法のパラメータ（非推奨、new_mgmt_p7をかわりに使用）。
new_cpu_p8	CPUリソース割当て方法のパラメータ（非推奨、new_mgmt_p8をかわりに使用）。
new_active_sess_pool_p1	コンシューマ・グループに対するアクティブな同時セッションの最大数を指定します。デフォルトのNULLは、無制限を意味します。
new_queueing_p1	非アクティブ・セッション・キューにあるジョブ（実行待ち状態のジョブ）がタイムアウトする時間（秒）を指定します。デフォルトのNULLは、無制限を意味します。
new_switch_group	任意の操作の並列度を制限します。デフォルトのNULLは、無制限を意味します。切替え条件に達した場合に、別のグループに切り替えます。
new_switch_time	他の切替え基準に達した場合に、現行セッションの切替え先となるコンシューマ・グループを指定します。デフォルトはNULLです。 グループ名が'CANCEL_SQL'の場合は、他の切替え基準に達したときに現行のコールが取り消されます。 グループ名が'KILL_SESSION'の場合は、他の切替え基準に達したときにセッションが終了します。
new_switch_estimate	アクションの実行前にセッションを実行できる時間（秒）を指定します。デフォルトのNULLは、無制限を意味します。
new_max_est_exec_time	TRUEの場合は、実行前に、見積り実行時間が操作のコンシューマ・グループに自動的に切り換えられるようにOracleに指示します。デフォルトはFALSEです。
new_undo_pool	セッションに許可する実行時間（秒）の最大値を指定します。操作時間がMAX_EST_EXEC_TIMEより長いとオプティマイザが判断した場合、その操作は開始されず、ORA-07455が発行されます。オプティマイザが判断しない場合は、このディレクティブの効果はありません。デフォルトのNULLは、無制限を意味します。
new_parallel_degree_limit_p1	コンシューマ・グループによって生成される取消しの合計量の最大値を、キロバイト（K）単位で設定します。デフォルトのNULLは、無制限を意味します。
new_max_idle_time	セッションのアイドル時間の最大値を示します。デフォルトのNULLは、無制限を意味します。
new_max_idle_blocker_time	別のセッションのリソース取得をブロックしながら、セッションのアイドル状態を維持できる時間（秒）の最大値。
new_switch_time_in_call	非推奨。 このパラメータを指定すると、new_switch_timeはnew_switch_time_in_callに設定され、new_switch_for_callはTRUEに設定されます。
new_mgmt_p1	レベル1のリソース割当て値（new_cpu_p1のかわり）。 EMPHASIS: リソースのパーセントを第1レベルに指定します。 RATIO: リソース使用率の重みを指定します。
new_mgmt_p2	レベル2のリソース割当て値（new_cpu_p2のかわり）。 EMPHASIS: リソースのパーセントを第2レベルに指定します。 RATIO: なし
new_mgmt_p3	レベル3のリソース割当て値（new_cpu_p3のかわり）。 EMPHASIS: リソースのパーセントを第3レベルに指定します。 RATIO: なし
new_mgmt_p4	レベル4のリソース割当て値（new_cpu_p4のかわり）。 EMPHASIS: リソースのパーセントを第4レベルに指定します。 RATIO: なし
new_mgmt_p5	レベル5のリソース割当て値（new_cpu_p5のかわり）。 EMPHASIS: リソースのパーセントを第5レベルに指定します。 RATIO: なし
new_mgmt_p6	レベル6のリソース割当て値（new_cpu_p6のかわり）。 EMPHASIS: リソースのパーセントを第6レベルに指定します。 RATIO: なし
new_mgmt_p7	レベル7のリソース割当て値（new_cpu_p7のかわり）。 EMPHASIS: リソースのパーセントを第7レベルに指定します。 RATIO: なし
new_mgmt_p8	レベル8のリソース割当て値（new_cpu_p8のかわり）。 EMPHASIS: リソースのパーセントを第8レベルに指定します。 RATIO: なし
new_switch_io_megabytes	アクションの実行前にセッションが発行できるI/Oの量（MB）を指定します。デフォルトのNULLは、無制限を意味します。
new_switch_io_reqs	アクションの実行前にセッションが発行できるI/Oリクエストの数を指定します。デフォルトのNULLは、無制限を意味します。
new_switch_for_call	new_switch_time、new_switch_io_megabytesまたはnew_switch_io_reqsパラメータのためにアクションが実行される場合、最初のコールの終了時に、コンシューマ・グループが元のコンシューマ・グループにリストアされるように指定します。デフォルト値のFALSEは、最初のコールの終了時に元のコンシューマ・グループがリストアされないことを意味します。

使用上の注意

• UPDATE_PLAN_DIRECTIVEに対してパラメータを指定しない場合、これらのパラメータは、データ・ディクショナリ内で変更されないまま残ります。

• new_max_idle_timeおよびnew_max_idle_blocker_timeに指定された制限値については、PMONが1分に1回確認します。いずれかの制限を超過したセッションが見つかると、そのセッションは強制終了され、すべての状態がクリーン・アップされます。

• 中間層サーバーによるセッション・プーリングの実装が行われている場合の3層アプリケーションでは、ほとんどの場合、パラメータnew_switch_time_in_callは有用です。 new_switch_time_in_callをオンに設定した場合のクライアントのリソース使用率は、今後別のクライアントのコンシューマ・グループが偶然同じセッションで実行されても影響しません。

---

VALIDATE_PENDING_AREAプロシージャ

このプロシージャは、リソース・マネージャに対する保留中の変更内容を検証します。

構文

DBMS_RESOURCE_MANAGER.VALIDATE_PENDING_AREA;