Package CS_RESOURCE_MANAGER

Le package CS_RESOURCE_MANAGER fournit une interface permettant de répertorier et de mettre à jour les paramètres de groupe de destinataires, et de rétablir les valeurs par défaut des paramètres.

Fonction LIST_CURRENT_RULES

Cette fonction répertorie les valeurs de paramètre pour chaque groupe de destinataires.

Syntaxe

CS_RESOURCE_MANAGER.LIST_CURRENT_RULES
   RETURN TABLE;

Exemple

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 

Fonction LIST_DEFAULT_RULES

Cette fonction renvoie les valeurs par défaut pour tous les groupes de destinataires.

Syntaxe

CS_RESOURCE_MANAGER.LIST_DEFAULT_RULES
  RETURN TABLE;

Remarque sur l'utilisation

  • Par défaut, la valeur de stratégie de degré de parallèle est MANUAL pour le groupe de destinataires TPURGENT. La fonction CS_RESOURCE_MANAGER.LIST_DEFAULT_RULES n'affiche aucune valeur par défaut de DEGREE_OF_PARALLELISM pour le groupe de destinataires TPURGENT.

Exemple

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 Procédure

Cette procédure rétablit les valeurs par défaut des propriétés de plan du gestionnaire de ressources indiqué.

Syntaxe

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

Paramètres

Paramètre Description

consumer_group

Indique le groupe de destinataires à rétablir.

En fonction de la charge globale, les valeurs valides sont HIGH, MEDIUM, LOW, TP ou TPURGENT.

shares

Lorsque la valeur est TRUE, rétablit la valeur par défaut des partages pour le service.

concurrency_limit

Lorsque la valeur est TRUE, rétablit la valeur par défaut de concurrency_limit pour le service. Lorsque vous rétablissez concurrency_limit, les valeurs concurrency_limit et degree_of_parallelism sont définies sur leurs valeurs par défaut.

Remarque sur l'utilisation

  • Lorsque le type de charge globale est Entrepôt de données, les valeurs valides pour consumer_group sont HIGH, MEDIUM ou LOW.

Exemples

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 Procédure

Utilisez cette procédure afin de mettre à jour le plan de ressources pour un groupe de destinataires indiqué.

Syntaxe

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

Paramètres

Paramètre Description

consumer_group

Indique le groupe de destinataires à mettre à jour.

En fonction de la charge globale, les valeurs valides sont HIGH, MEDIUM, LOW, TP ou TPURGENT.

io_megabytes_limit

Indique le nombre maximal de méga-octets d'E/S qu'une opération SQL peut exécuter.

Indiquez la valeur NULL pour effacer la limite.

elapsed_time_limit

Indique la durée maximale, en secondes, pendant laquelle une opération SQL peut être exécutée.

Indiquez la valeur NULL pour effacer la limite.

shares

Indique la valeur de partages. Un nombre plus élevé de partages par rapport aux autres groupes de destinataires augmente la priorité d'E/S et d'UC du groupe.

concurrency_limit

Indique le nombre maximal d'instructions SQL simultanées pouvant être exécutées.

Ce paramètre ne peut être utilisé qu'avec le groupe de destinataires MEDIUM.

Notes d'utilisation

  • Lorsqu'une instruction SQL dans le service indiqué est exécutée au-delà de la limite d'exécution indiquée (elapsed_time_limit) ou qu'elle effectue plus d'E/S que la quantité indiquée (io_megabytes_limit), l'instruction SQL prend fin.

  • Lorsque le type de charge globale est Entrepôt de données, les valeurs valides pour consumer_group sont HIGH, MEDIUM ou LOW.

  • Lorsque le paramètre concurrency_limit est indiqué, la seule valeur valide pour consumer_group est MEDIUM.

Exemples

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