CS_RESOURCE_MANAGERパッケージ

CS_RESOURCE_MANAGERパッケージは、コンシューマ・グループ・パラメータのリストおよび更新、およびパラメータをデフォルト値に戻すためのインタフェースを提供します。

LIST_CURRENT_RULESファンクション
このファンクションは、各コンシューマ・グループのパラメータ値をリストします。
LIST_DEFAULT_RULESファンクション
このファンクションは、すべてのコンシューマ・グループのデフォルト値を返します。
REVERT_TO_DEFAULT_VALUESプロシージャ
このプロシージャは、指定されたリソース・マネージャのプラン・プロパティをデフォルト値に戻します。
UPDATE_PLAN_DIRECTIVEプロシージャ
このプロシージャを使用して、指定したコンシューマ・グループのリソース・プランを更新します。

親トピック: Autonomous Database提供されているパッケージ参照

LIST_CURRENT_RULESファンクション

この関数は、各コンシューマ・グループのパラメータ値をリストします。

構文

CS_RESOURCE_MANAGER.LIST_CURRENT_RULES
   RETURN TABLE;

例

SELECT * FROM CS_RESOURCE_MANAGER.LIST_CURRENT_RULES();

CONSUMER_GROUP ELAPSED_TIME_LIMIT IO_MEGABYTES_LIMIT SHARES CONCURRENCY_LIMIT DEGREE_OF_PARALLELISM 
-------------- ------------------ ------------------ ------ ----------------- --------------------- 
HIGH                                                      4                 3                     3 
MEDIUM                                                    2                 2                     9 
LOW                                                       1               900                     1

親トピック: CS_RESOURCE_MANAGERパッケージ

LIST_DEFAULT_RULESファンクション

この関数は、すべてのコンシューマ・グループのデフォルト値を返します。

構文

CS_RESOURCE_MANAGER.LIST_DEFAULT_RULES
  RETURN TABLE;

使用上のノート

デフォルトでは、TPURGENTコンシューマ・グループの並列度ポリシー値はMANUALです。 CS_RESOURCE_MANAGER.LIST_DEFAULT_RULES関数は、TPURGENTコンシューマ・グループのDEGREE_OF_PARALLELISMのデフォルト値を表示しません。

例

SELECT * FROM CS_RESOURCE_MANAGER.LIST_DEFAULT_RULES();
CONSUMER_GROUP ELAPSED_TIME_LIMIT IO_MEGABYTES_LIMIT SHARES CONCURRENCY_LIMIT DEGREE_OF_PARALLELISM 
-------------- ------------------ ------------------ ------ ----------------- --------------------- 
HIGH                            0                  0      4                 3                     1 
MEDIUM                          0                  0      2                 1                     1 
LOW                             0                  0      1               300                     1 
TP                              0                  0      8               300                     1 
TPURGENT                        0                  0     12               300

親トピック: CS_RESOURCE_MANAGERパッケージ

REVERT_TO_DEFAULT_VALUESプロシージャ

この手順では、指定したリソース・マネージャ・プラン・プロパティをデフォルト値に戻します。

構文

CS_RESOURCE_MANAGER.REVERT_TO_DEFAULT_VALUES(
   consumer_group         IN VARCHAR2,
   shares                 IN BOOLEAN   DEFAULT FALSE,
   concurrency_limit      IN BOOLEAN   DEFAULT FALSE);

パラメータ

パラメータ説明

パラメータ	説明
`consumer_group`	元に戻すコンシューマ・グループを指定します。ワークロードに応じて、有効な値は次のとおりです: `HIGH`, `MEDIUM`, `LOW`, `TP`または`TPURGENT`。
`shares`	値が`TRUE`の場合、サービスの共有をデフォルト値に戻します。
`concurrency_limit`	値が`TRUE`の場合、サービスの`concurrency_limit`をデフォルト値に戻します。 `concurrency_limit`を元に戻すと、`concurrency_limit`と`degree_of_parallelism`の両方の値がデフォルト値に設定されます。

consumer_group

元に戻すコンシューマ・グループを指定します。

ワークロードに応じて、有効な値は次のとおりです: HIGH, MEDIUM, LOW, TPまたはTPURGENT。

shares

値がTRUEの場合、サービスの共有をデフォルト値に戻します。

concurrency_limit

値がTRUEの場合、サービスのconcurrency_limitをデフォルト値に戻します。 concurrency_limitを元に戻すと、concurrency_limitとdegree_of_parallelismの両方の値がデフォルト値に設定されます。

使用上のノート

ワークロード・タイプがデータ・ウェアハウスの場合、consumer_groupの有効な値はHIGH、MEDIUMまたはLOWです。

例

BEGIN
   CS_RESOURCE_MANAGER.REVERT_TO_DEFAULT_VALUES(
      consumer_group => 'MEDIUM', 
      concurrency_limit => TRUE);
END;
/

BEGIN
   CS_RESOURCE_MANAGER.REVERT_TO_DEFAULT_VALUES(
      consumer_group => 'HIGH', 
      shares => TRUE);
END;
/

親トピック: CS_RESOURCE_MANAGERパッケージ

UPDATE_PLAN_DIRECTIVEプロシージャ

この手順を使用して、指定したコンシューマ・グループのリソース・プランを更新します。

構文

CS_RESOURCE_MANAGER.UPDATE_PLAN_DIRECTIVE(
   consumer_group         IN VARCHAR2,
   io_megabytes_limit     IN NUMBER   DEFAULT NULL,
   elapsed_time_limit     IN NUMBER   DEFAULT NULL,
   shares                 IN NUMBER   DEFAULT NULL,
   concurrency_limit      IN NUMBER   DEFAULT NULL);

パラメータ

パラメータ	説明
`consumer_group`	更新するコンシューマ・グループを指定します。ワークロードに応じて、有効な値は次のとおりです: `HIGH`, `MEDIUM`, `LOW`, `TP`または`TPURGENT`。
`io_megabytes_limit`	SQL操作で発行できるI/Oの最大メガバイトを指定します。制限をクリアするには、`NULL`値を指定します。
`elapsed_time_limit`	SQL操作を実行できる最大時間(秒)を指定します。制限をクリアするには、`NULL`値を指定します。
`shares`	共有値を指定します。他のコンシューマ・グループと比較して、共有数が多いほど、コンシューマ・グループのCPUおよびI/O優先度が高くなります。
`concurrency_limit`	実行可能な同時SQL文の最大数を指定します。このパラメータは、`MEDIUM`コンシューマ・グループでのみ有効です。

使用上のノート

指定されたサービスのSQL文が、指定されたランタイム制限(elapsed_time_limit)を超えるか、指定された量(io_megabytes_limit)を超えるI/Oを実行した場合、SQL文は終了します。
ワークロード・タイプがデータ・ウェアハウスの場合、consumer_groupの有効な値はHIGH、MEDIUMまたはLOWです。
concurrency_limitパラメータが指定されている場合、consumer_groupの有効な値はMEDIUMのみです。

例

BEGIN
   CS_RESOURCE_MANAGER.UPDATE_PLAN_DIRECTIVE(
      consumer_group => 'HIGH', 
      shares => 8);
   CS_RESOURCE_MANAGER.UPDATE_PLAN_DIRECTIVE(
      consumer_group => 'MEDIUM', 
      shares => 2);
   CS_RESOURCE_MANAGER.UPDATE_PLAN_DIRECTIVE(
      consumer_group => 'LOW', 
      shares => 1);
END;
/

BEGIN
   CS_RESOURCE_MANAGER.UPDATE_PLAN_DIRECTIVE(
      consumer_group => 'HIGH', 
      io_megabytes_limit => null, 
      elapsed_time_limit => null);
END;
/

BEGIN
   CS_RESOURCE_MANAGER.UPDATE_PLAN_DIRECTIVE(
     consumer_group => 'MEDIUM', 
     concurrency_limit => 2);
END;
/

親トピック: CS_RESOURCE_MANAGERパッケージ