Oracle Cloud Infrastructureドキュメント

CS_RESOURCE_MANAGERパッケージ

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

親トピック: 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

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

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です。

例

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

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の最大MBを指定します。

制限をクリアするには、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;
/