Documentation Oracle Cloud Infrastructure

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 consommateurs de ressources, et de rétablir les valeurs par défaut des paramètres.

Rubrique parent : Référence de package fourni par la base de données Autonomous AI

Fonction LIST_CURRENT_RULES

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

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

Rubrique parent : Package CS_RESOURCE_MANAGER

Fonction LIST_DEFAULT_RULES

Cette fonction renvoie les valeurs par défaut de tous les groupes de consommateurs de ressources.

Syntaxe

CS_RESOURCE_MANAGER.LIST_DEFAULT_RULES
  RETURN TABLE;

Remarque sur l'utilisation

  • Par défaut, la valeur de stratégie de degré parallèle est MANUAL pour le groupe de consommateurs de ressources TPURGENT. La fonction CS_RESOURCE_MANAGER.LIST_DEFAULT_RULES n'affiche aucune valeur pour la valeur par défaut de DEGREE_OF_PARALLELISM pour le groupe de consommateurs de ressources 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

Rubrique parent : Package CS_RESOURCE_MANAGER

Procédure REVERT_TO_DEFAULT_VALUES

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

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 consommateurs de ressources à rétablir.

Les valeurs valides sont : HIGH, MEDIUM, LOW, TP ou TPURGENT.

shares

Lorsque la valeur est TRUE, rétablissez la valeur par défaut pour les partages du service.

concurrency_limit

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

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

Rubrique parent : Package CS_RESOURCE_MANAGER

Procédure UPDATE_PLAN_DIRECTIVE

Cette procédure permet de mettre à jour le plan d'allocation de ressources pour un groupe de consommateurs de ressources spécifié.

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 consommateurs de ressources à mettre à jour.

Les valeurs valides sont : HIGH, MEDIUM, LOW, TP ou TPURGENT.

io_megabytes_limit

Indique le nombre maximal de mégaoctets d'E/S qu'une opération SQL peut émettre.

Indiquez une 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 une valeur NULL pour effacer la limite.

shares

Spécifie la valeur des partages. Par rapport aux autres groupes de consommateurs de ressources, un nombre plus élevé de partages augmente la priorité d'E/S et de CPU du groupe.

concurrency_limit

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

Ce paramètre est valide uniquement avec le groupe de consommateurs de ressources MEDIUM.

Notes d'utilisation

  • Lorsqu'une instruction SQL dans le service indiqué s'exécute plus que la limite d'exécution indiquée (elapsed_time_limit) ou effectue plus d'E/S que la quantité indiquée (io_megabytes_limit), l'instruction SQL prend fin.

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

Rubrique parent : Package CS_RESOURCE_MANAGER