Décharger les interrogations sur les clones actualisables de membre

Fournit des informations sur l'utilisation du déchargement d'interrogation avec un groupe élastique et décrit les fonctions de déchargement d'interrogation.

Le déchargement des interrogations de groupe élastique offre des avantages en matière de performance en permettant à un ou plusieurs clones actualisables de traiter les interrogations pour un chef de groupe élastique ou pour un membre de groupe élastique. Cette fonction vous permet également d'ajouter des clones actualisables pour répondre à une demande croissante d'interrogation (lecture). Le déchargement des interrogations permet à votre application de faire une mise à l'échelle horizontale, où vous pouvez ajouter des clones actualisables pour assurer la performance globale du système, si nécessaire, pour répondre au volume de vos demandes d'interrogation.

Lorsque le déchargement des interrogations est activé, les interrogations sont soumises au chef de groupe élastique ou à un membre de groupe élastique et un ou plusieurs clones actualisables disponibles deviennent des candidats pour le déchargement des interrogations. En outre, lorsque d'autres clones actualisables sont ajoutés, le déchargement des interrogations s'ajuste dynamiquement pour utiliser les nouvelles ressources.

Un cas d'utilisation pour le déchargement des interrogations est d'activer la fonction pendant les heures de pointe pour retirer le chargement du chef de groupe élastique ou d'un membre de groupe élastique. Pendant les heures tranquilles, vous pouvez désactiver le déchargement des interrogations pour effectuer des opérations de maintenance telles que l'actualisation des clones actualisables.

Par défaut, le déchargement des interrogations prend en compte les interrogations de n'importe quelle session. Vous pouvez également décharger les interrogations d'une liste de sessions que vous spécifiez par nom de module ou d'action.

La figure suivante illustre le déchargement des interrogations à partir du leader du pool élastique.

Description de l'illustration autonomous-elastic-pool-leader-query-offload.png

La figure suivante illustre le déchargement des interrogations à partir d'un membre de pool élastique.

Description de l'illustration autonomous-elastic-pool-member-query-offload.eps

Les données des clones actualisables sont à jour en fonction de l'heure de la dernière actualisation pour chaque clone actualisable. Cela signifie que lorsque le déchargement des interrogations est activé, vous effectuez toutes les opérations LDD, LMD et PL/SQL sur le leader du pool élastique ou sur le membre du pool élastique qui décharge les interrogations. Ensuite, après l'actualisation d'un clone actualisable, les modifications sont répercutées sur le clone actualisable.

Pour plus d'informations, voir Utiliser des clones actualisables avec une base de données d'IA autonome.

Décrit comment activer le déchargement des interrogations pour un responsable de groupe élastique ou pour un membre de groupe élastique.

1. Vérifiez que l'instance de base de données Autonomous AI Database est un chef de groupe élastique ou un membre de groupe élastique :
   1. Utilisez l'interrogation suivante pour vérifier qu'une instance est un chef de groupe élastique :

      SELECT sys_context('userenv', 'is_elastic_pool_leader') FROM DUAL;

      Cette interrogation doit retourner YES.

   2. Utilisez l'interrogation suivante pour vérifier qu'une instance est un membre de groupe élastique :

      SELECT sys_context('userenv', 'is_elastic_pool_member') FROM DUAL;

      Cette interrogation doit retourner YES.

   Note
   
   Il peut y avoir un délai allant jusqu'à 15 minutes pour que la valeur sys_context reflète la valeur courante si le groupe élastique a été créé ou modifié récemment.
2. Activer le déchargement d'interrogation.

   Il existe deux options : activer le déchargement des interrogations pour les interrogations de n'importe quelle session ou limiter le déchargement des interrogations aux sessions que vous spécifiez par nom de module ou d'action.

   • Pour activer le déchargement d'interrogation pour toutes les sessions, exécutez DBMS_PROXY_SQL.ENABLE_READ_ONLY_OFFLOAD sans paramètres. Exemple :

     EXEC DBMS_PROXY_SQL.ENABLE_READ_ONLY_OFFLOAD;

   • Pour activer le déchargement d'interrogation pour des sessions spécifiques par nom de module ou nom d'action, exécutez DBMS_PROXY_SQL.ENABLE_READ_ONLY_OFFLOAD avec les paramètres module_name ou action_name.

     Pour plus d'informations, voir Activer le déchargement des interrogations pour les modules ou actions nommés.

SELECT sys_context('userenv', 'con_name') FROM DUAL;

• Activer le déchargement des interrogations pour les modules ou actions nommés
  Décrit comment activer le déchargement des interrogations pour les sessions avec des modules ou des actions nommés.

Décrit comment désactiver le déchargement des interrogations pour un responsable de groupe élastique ou pour un membre de groupe élastique.

EXEC DBMS_PROXY_SQL.DISABLE_READ_ONLY_OFFLOAD;

Lorsque le déchargement des interrogations est activé, les interrogations sont déchargées vers des clones actualisables même si elles sont intégrées dans du code PL/SQL. Le code PL/SQL peut être stocké sous forme de procédures, de fonctions, de packages ou de blocs anonymes.

Par exemple, vous pouvez démontrer qu'une interrogation est déchargée vers un clone actualisable lorsque vous activez le déchargement d'interrogation pour un module et une action spécifiques. Dans cet exemple, supposons que les données du chef de file ont été mises à jour et que le clone actualisable n'a pas encore été mis à jour (les données du clone actualisable sont donc obsolètes et différentes). Dans cet exemple, avec des valeurs différentes pour le chef de groupe élastique et le clone actualisable, vous pouvez voir quand les données proviennent du chef ou du clone actualisable.

1. Activez le déchargement des interrogations et spécifiez les sessions admissibles par nom de module et nom d'action. Par exemple, 'mod1', 'act1'.

   DECLARE 
      mod_values clob := to_clob('["mod1"]');
      act_values clob := to_clob('["act1"]');
   BEGIN 
      DBMS_PROXY_SQL.ENABLE_READ_ONLY_OFFLOAD(
         module_name => mod_values,                                          
         action_name => act_values);
   END;
   /

2. Définissez la fonction f1 pour tester le déchargement de l'interrogation.

   SQL> create or replace function f1 (n number)
     2  return number
     3  as
     4    l_cnt number;
     5  begin
     6    select sum(c1) into l_cnt from u2.tab1;
     7    return l_cnt;
     8  end;
     9  /
    
   Function created.

3. Exécutez la fonction f1. L'interrogation avec la fonction f1 s'exécute sur le chef de groupe élastique (ou sur un membre de groupe élastique pour lequel l'interrogation de déchargement est activée). Cette session s'exécute avec des noms de module et d'action non spécifiés qui ne correspondent pas à ceux spécifiés pour le déchargement d'interrogation à l'étape 1.

   SQL> -- expected to fetch from Elastic Pool Leader and returns value 40
   SQL> select f1(3) from dual;
        F1(3)
   ----------
           40
    
   1 row selected.

4. Spécifiez le nom du module et le nom de l'action pour la session afin qu'ils correspondent aux noms spécifiés à l'étape 1. Les interrogations de cette session peuvent désormais être déchargées vers un clone actualisable.

   SQL> exec dbms_application_info.set_module('mod1', 'act1');
    
   PL/SQL procedure successfully completed.

5. Exécutez de nouveau la fonction f1. Dans ce cas, le nom du module et le nom de l'action correspondent aux noms spécifiés à l'étape 1. L'interrogation de la fonction f1 est déchargée dans un clone actualisable.

   SQL> -- Expected to fetch from Refreshable Clone and returns value 10
   SQL> select f1(3) from dual;
    
        F1(3)
   ----------
           10
    
   1 row selected.

6. Spécifiez les noms de module et d'action comme autre chose que mod1 et act1. Les interrogations de cette session ne peuvent plus être déchargées vers un clone actualisable, car les noms de module et d'action ne correspondent pas à ceux spécifiés à l'étape 1.

   SQL> exec dbms_application_info.set_module('random', 'random');
    
   PL/SQL procedure successfully completed.

7. Exécutez l'interrogation avec la fonction f1. Comme le nom du module et de l'action pour cette session ne correspondent pas à ceux définis à l'étape 1, cette interrogation n'est pas déchargée et s'exécute sur le leader du pool élastique.

   SQL> -- expected to fetch from Elastic Pool Leader and returns value 40
   SQL> select f1(3) from dual;
        F1(3)
   ----------
           40
    
   1 row selected.

Lorsque le déchargement des interrogations est activé, les interrogations d'une action de tâche Oracle Scheduler sont déchargées vers des clones actualisables. Les interrogations sont déchargées, que le travail s'exécute au premier plan ou en arrière-plan.

Par exemple, comme dans l'exemple précédent pour PL/SQL, vous pouvez démontrer qu'une interrogation est déchargée vers un clone actualisable lorsque vous activez le déchargement des interrogations pour un travail Oracle Scheduler. Dans cet exemple, supposons que les données du chef de file ont été mises à jour et que le clone actualisable n'a pas encore été mis à jour (les données du clone actualisable sont donc obsolètes et différentes). Dans cet exemple, avec des valeurs différentes pour le chef de groupe élastique et le clone actualisable, vous pouvez voir quand les données proviennent du chef ou du clone actualisable.

SQL> create or replace procedure sproc1 (n number)
  2  as
  3    l_cnt number;
  4  begin
  5    select sum(c1) into l_cnt from u2.tab1;
  6    dbms_output.put_line('l_cnt is ' || l_cnt);
  7  end;
  8  /
 
Procedure created.

Offload Queries from Elastic Pool Leader to Member Refreshable Clones

SQL> create or replace procedure sproc1 (n number)
  2  as
  3    l_cnt number;
  4  begin
  5    select sum(c1) into l_cnt from u2.tab1;
  6    dbms_output.put_line('l_cnt is ' || l_cnt);
  7  end;
  8  /
 
Procedure created.
 
SQL>
SQL> BEGIN
  2    dbms_scheduler.create_job(job_name    => 'PROXYTEST1',
  3                              job_type    => 'PLSQL_BLOCK',
  4                              job_action  => 'BEGIN sproc1(3); END;',
  5                              enabled     => FALSE);
  6  END;
  7  /
 
PL/SQL procedure successfully completed.
 
SQL>
SQL> -- Job runs in the foreground in the current session
SQL> -- expected to fetch from Leader: 40
SQL> exec dbms_scheduler.RUN_JOB(job_name => 'PROXYTEST1', use_current_session => true);
l_cnt is 40
 
PL/SQL procedure successfully completed.
 
SQL>
SQL> exec dbms_proxy_sql.enable_read_only_offload;
 
PL/SQL procedure successfully completed.
 
SQL> show con_name
 
CON_NAME
------------------------------
CDB1_PDB1
SQL> 
SQL> set serveroutput on
SQL> -- Job runs in the foreground in the current session
SQL> -- expected to fetch from Refreshable Clone: 10
SQL> exec dbms_scheduler.RUN_JOB(job_name => 'PROXYTEST1', use_current_session => true);
l_cnt is 10
 
PL/SQL procedure successfully completed.
 
SQL>
SQL> -- Job runs in the background and is expected to fetch from Refreshable Clone: 10
SQL> exec dbms_scheduler.RUN_JOB(job_name => 'PROXYTEST1', use_current_session => false);
 
PL/SQL procedure successfully completed.

Fournit des notes supplémentaires pour la fonction de déchargement des interrogations.

Notes pour le déchargement d'interrogation :

• Ajout ou suppression d'un clone actualisable : Lorsqu'un clone actualisable est ajouté en tant que membre du groupe élastique, il peut y avoir un délai allant jusqu'à quinze minutes pour que l'ajout soit reflété dans le chef du groupe élastique. Un clone actualisable nouvellement ajouté n'est pas considéré comme une cible pour les décharges d'interrogation tant que le responsable n'a pas connaissance du membre de groupe élastique nouvellement ajouté.

  De même, lorsqu'un clone actualisable est retiré du pool élastique, il peut y avoir un délai de quinze minutes maximum pour que le retrait soit reflété dans le leader du pool élastique. Le clone actualisable supprimé est considéré comme une cible pour les décharges d'interrogation jusqu'à ce que le responsable sache que le membre a été supprimé du pool élastique.

• Actualiser le clone actualisable : Lorsqu'un clone actualisable est en cours d'actualisation, les interrogations déchargées vers le clone actualisable peuvent être retardées.

• Prise en charge des points d'extrémité publics et privés : Le déchargement d'interrogation est pris en charge pour les instances d'un point d'extrémité public et pour les instances d'un point d'extrémité privé.

• Clone actualisable déconnecté : Si un clone actualisable est déconnecté, il n'est plus admissible en tant que cible pour le déchargement d'interrogation. Il peut y avoir un délai allant jusqu'à quinze minutes pour que le chef de groupe élastique détecte qu'un clone actualisable a été déconnecté et cesse de lui décharger des interrogations.

  Pour vous assurer qu'un clone actualisable reste disponible pour le déchargement des interrogations, activez les actualisations automatiques ou actualisez manuellement périodiquement le clone actualisable.

  Pour plus d'informations, voir Actualiser un clone actualisable sur une base de données d'IA autonome.

• Nom du module sensible à la casse et nom de l'action : Lorsque vous déchargez des interrogations à partir d'une liste de sessions que vous spécifiez par nom de module ou d'action, le nom du module et le nom de l'action définis avec DBMS_APPLICATION_INFO sont sensibles à la casse. DBMS_PROXY_SQL.ENABLE_READ_ONLY_OFFLOAD respecte ce comportement sensible à la casse. Par exemple, lorsqu'une session a un nom de module en minuscules ou un nom de module en majuscules et minuscules, la casse doit correspondre dans les valeurs de paramètre lorsque vous activez le déchargement d'interrogation avec DBMS_PROXY_SQL.ENABLE_READ_ONLY_OFFLOAD et que vous incluez les paramètres module_name ou action_name.

  Vous pouvez vérifier le nom du module et le nom de l'action pour la session courante à l'aide de DBMS_APPLICATION_INFO.READ_MODULE :

  set serveroutput on;
  declare
    l_mod varchar2(50);
    l_act varchar2(50);
  BEGIN
  DBMS_APPLICATION_INFO.READ_MODULE(l_mod, l_act);
    DBMS_OUTPUT.PUT_LINE('l_mod: ' || l_mod);
    DBMS_OUTPUT.PUT_LINE('l_act: ' || l_act);
  END;
  /

• Cas d'utilisation type : Un cas d'utilisation pour le déchargement d'interrogation est d'activer la fonction pendant les heures de pointe pour retirer le chargement du responsable du groupe élastique (ou hors du membre du groupe élastique où le déchargement d'interrogation est activé). Pendant les heures tranquilles, vous pouvez désactiver le déchargement des interrogations pour effectuer des opérations de maintenance telles que l'actualisation des clones actualisables.