Scarica query nelle copie aggiornabili dei membri

Fornisce informazioni sull'uso dell'offload delle query con un pool elastico e descrive le funzioni di offload delle query.

L'offload delle query del pool elastico offre vantaggi in termini di prestazioni consentendo a una o più copie aggiornabili di gestire le query per un leader del pool elastico o per un membro del pool elastico. Questa funzione consente inoltre di aggiungere copie aggiornabili per soddisfare l'aumento della domanda di query (lettura). Le query di riduzione del carico consentono all'applicazione di ridimensionarsi orizzontalmente, dove è possibile aggiungere copie aggiornabili per mantenere le prestazioni complessive del sistema in base alle esigenze per soddisfare il volume delle richieste di query.

Quando l'offload delle query è abilitato, le query vengono sottomesse al leader del pool elastico o a un membro del pool elastico e una o più copie aggiornabili disponibili diventano candidati per l'offload delle query. Inoltre, quando vengono aggiunte altre copie aggiornabili, l'offload delle query viene regolato in modo dinamico per utilizzare le nuove risorse.

Un caso d'uso per l'offload delle query è quello di abilitare la funzione durante le ore di punta per rimuovere il carico dal leader del pool elastico o da un membro del pool elastico. Durante le ore di inattività, è possibile disabilitare l'offload delle query per eseguire operazioni di manutenzione, ad esempio l'aggiornamento delle copie aggiornabili.

Per impostazione predefinita, l'offload delle query considera le query da qualsiasi sessione. In alternativa, è possibile scaricare le query da un elenco di sessioni specificato in base al nome del modulo o dell'azione.

La figura seguente mostra l'offload delle query dal leader del pool elastico.

Descrizione dell'illustrazione autonomous-elastic-pool-leader-query-offload.png

La figura seguente mostra l'offload delle query da un membro del pool elastico.

Descrizione dell'illustrazione autonomous-elastic-pool-member-query-offload.eps

I dati delle copie aggiornabili sono aggiornati in base all'ora dell'ultimo aggiornamento per ogni copia aggiornabile. Ciò significa che quando l'offload delle query è abilitato, è possibile eseguire tutte le operazioni DDL, DML e PL/SQL sul leader del pool elastico o sul membro del pool elastico che sta scaricando le query. Quindi, dopo l'aggiornamento di una copia aggiornabile, le modifiche vengono applicate alla copia aggiornabile.

Per ulteriori informazioni, vedere Usa copie aggiornabili con Autonomous Database.

Descrive come abilitare l'offload delle query per un leader del pool elastico o per un membro del pool elastico.

1. Verificare che l'istanza di Autonomous Database sia un leader del pool elastico o un membro del pool elastico:
   1. Utilizzare la query seguente per verificare che un'istanza sia un leader del pool elastico:

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

      Questa query deve restituire YES.

   2. Utilizzare la query seguente per verificare che un'istanza sia un membro del pool elastico:

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

      Questa query deve restituire YES.

   Nota
   
   Se il pool elastico è stato creato o modificato di recente, potrebbe verificarsi un ritardo massimo di 15 minuti affinché il valore sys_context rifletta il valore corrente.
2. Abilita l'offload delle query.

   Sono disponibili due opzioni: è possibile abilitare l'offload delle query per le query da qualsiasi sessione o limitare l'offload delle query alle sessioni specificate in base al modulo o al nome dell'azione.

   • Per abilitare l'offload delle query per tutte le sessioni, eseguire DBMS_PROXY_SQL.ENABLE_READ_ONLY_OFFLOAD senza parametri. Ad esempio:

     EXEC DBMS_PROXY_SQL.ENABLE_READ_ONLY_OFFLOAD;

   • Per abilitare l'offload delle query per sessioni specifiche in base al nome del modulo o al nome dell'azione, eseguire DBMS_PROXY_SQL.ENABLE_READ_ONLY_OFFLOAD con i parametri module_name o action_name.

     Per ulteriori informazioni, vedere Abilita riduzione carico query per moduli o azioni denominati.

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

• Abilita riduzione carico query per moduli o azioni denominati
  Descrive come abilitare l'offload delle query per le sessioni con moduli o azioni denominati.

Descrive come disabilitare l'offload delle query per un leader del pool elastico o per un membro del pool elastico.

EXEC DBMS_PROXY_SQL.DISABLE_READ_ONLY_OFFLOAD;

Quando l'offload delle query è abilitato, le query vengono scaricate nelle copie aggiornabili anche se sono incorporate in PL/SQL. PL/SQL può essere memorizzato in procedure, funzioni, pacchetti o blocchi anonimi.

Ad esempio, è possibile dimostrare che una query viene scaricata in una copia aggiornabile quando si abilita l'offload della query per un modulo e un'azione specifici. In questo esempio, si supponga che i dati del leader siano stati aggiornati e che la copia aggiornabile non sia stata ancora aggiornata (quindi i dati della copia aggiornabile non sono aggiornati e sono diversi). In questo esempio, con valori diversi nel leader del pool elastico e nella copia aggiornabile, è possibile vedere quando i dati provengono dal leader o dalla copia aggiornabile.

1. Abilita l'offload della query e specifica le sessioni idonee in base al nome del modulo e al nome dell'azione. Ad esempio, '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. Definire la funzione f1 per eseguire il test dell'offload delle query.

   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. Eseguire la funzione f1. La query con la funzione f1 viene eseguita sul leader del pool elastico (o su un membro del pool elastico per cui è abilitata la query di scarico). Questa sessione viene eseguita con i nomi di modulo e azione non specificati che non corrispondono a quelli specificati per l'offload della query nel passo 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. Specificare il nome del modulo e il nome dell'azione per la sessione in modo che corrispondano ai nomi specificati nel Passo 1. Le query di questa sessione ora sono idonee per essere scaricate in una copia aggiornabile.

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

5. Eseguire nuovamente la funzione f1. In questo caso il nome del modulo e il nome dell'azione corrispondono ai nomi specificati nel Passo 1. La query nella funzione f1 viene scaricata in una copia aggiornabile.

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

6. Specificare i nomi del modulo e dell'azione in modo diverso da mod1 e act1. Le query di questa sessione non sono più idonee per essere scaricate in una copia aggiornabile a causa dei nomi di modulo e azione non corrispondenti a quelli specificati nel passo 1.

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

7. Eseguire la query con la funzione f1. Poiché il modulo e il nome dell'azione per questa sessione non corrispondono a quelli impostati nel Passo 1, questa query non viene scaricata e viene eseguita sul leader del pool elastico.

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

Quando l'offload delle query è abilitato, le query provenienti da un'azione job di Oracle Scheduler vengono scaricate in copie aggiornabili. Le query vengono scaricate se il job viene eseguito in primo piano o in background.

Ad esempio, come nell'esempio precedente per PL/SQL, è possibile dimostrare che una query viene scaricata in una copia aggiornabile quando si abilita l'offload della query per un job di Oracle Scheduler. In questo esempio, si supponga che i dati del leader siano stati aggiornati e che la copia aggiornabile non sia stata ancora aggiornata (quindi i dati della copia aggiornabile non sono aggiornati e sono diversi). In questo esempio, con valori diversi nel leader del pool elastico e nella copia aggiornabile, è possibile vedere quando i dati provengono dal leader o dalla copia aggiornabile.

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.

Fornisce note aggiuntive per la funzione di scaricamento query.

Note per l'offload della query:

• Aggiunta o rimozione di una copia aggiornabile: quando si aggiunge una copia aggiornabile come membro del pool elastico, può verificarsi un ritardo massimo di quindici minuti affinché l'aggiunta venga riflessa nel leader del pool elastico. Una copia aggiornabile appena aggiunta non viene considerata come destinazione per gli scarichi delle query finché il leader non è a conoscenza del nuovo membro del pool elastico aggiunto.

  Analogamente, quando un clone aggiornabile viene rimosso dal pool elastico, può verificarsi un ritardo di quindici minuti prima che la rimozione venga riflessa nel leader del pool elastico. La copia aggiornabile rimossa viene considerata come destinazione per gli scarichi delle query finché il leader non sa che il membro è stato rimosso dal pool elastico.

• Aggiornamento della copia aggiornabile: quando si aggiorna una copia aggiornabile, le query che vengono scaricate nella copia aggiornabile potrebbero subire un ritardo.

• Supporto degli endpoint pubblici e privati: l'offload delle query è supportato per le istanze su un endpoint pubblico e per le istanze su un endpoint privato.

• Copia aggiornabile disconnessa: se una copia aggiornabile viene disconnessa, non è più idonea come destinazione per l'offload delle query. Può verificarsi un ritardo massimo di quindici minuti prima che il leader del pool elastico rilevi che una copia aggiornabile è stata disconnessa e interrompa il download delle query.

  Per assicurarsi che una copia aggiornabile rimanga disponibile per l'offload delle query, abilitare gli aggiornamenti automatici o aggiornare periodicamente manualmente la copia aggiornabile.

  Per ulteriori informazioni, vedere Aggiorna una copia aggiornabile in Autonomous Database.

• Nome modulo con distinzione tra maiuscole e minuscole e Nome azione: quando si scaricano le query da una lista di sessioni specificata in base al nome del modulo o dell'azione, il nome del modulo e il nome dell'azione impostati con DBMS_APPLICATION_INFO fanno distinzione tra maiuscole e minuscole. DBMS_PROXY_SQL.ENABLE_READ_ONLY_OFFLOAD rispetta questo comportamento con distinzione tra maiuscole e minuscole. Ad esempio, quando una sessione ha un nome di modulo minuscolo o un nome di modulo a lettere maiuscole/minuscole, il caso deve corrispondere ai valori dei parametri quando si abilita l'offload della query con DBMS_PROXY_SQL.ENABLE_READ_ONLY_OFFLOAD e si includono i parametri module_name o action_name.

  È possibile controllare il nome del modulo e il nome dell'azione per la sessione corrente utilizzando 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;
  /

• Caso d'uso tipico: un caso d'uso per l'offload delle query è quello di abilitare la funzione durante le ore di punta per rimuovere il carico da Elastic Pool Leader (o dal membro Elastic Pool in cui è abilitato l'offload delle query). Durante le ore di inattività, è possibile disabilitare l'offload delle query per eseguire operazioni di manutenzione, ad esempio l'aggiornamento delle copie aggiornabili.