Sintassi

DBMS_PROXY_SQL.ACCEPT_MAPPING ( 
    object_owner          IN VARCHAR2,
    router_database_ocid  IN VARCHAR2);

Parametri

Esempio

BEGIN
 DBMS_PROXY_SQL.ACCEPT_MAPPING ( 
    object_owner          => 'DW_USER',
    router_database_ocid  => 'TARGET_DATABASE_OCID');
 END;
/

Note per l'uso

• È necessario eseguire questa procedura sull'istanza di Autonomous Database di destinazione.

• Per eseguire questa procedura, è necessario aver eseguito il login come utente ADMIN o disporre del privilegio EXECUTE sul pacchetto DBMS_PROXY_SQL.

• Ogni voce di mapping nella tabella di instradamento sull'istanza di Autonomous Database del router deve avere una voce corrispondente nella rispettiva istanza di Autonomous Database di destinazione.

Sintassi

DBMS_PROXY_SQL.ADD_MAPPING ( 
    object_owner   IN VARCHAR2,
    object_name    IN VARCHAR2,
    database_ocid  IN VARCHAR2);

Parametri

Esempi

Esempio per abilitare l'instradamento a livello di oggetto:

BEGIN
 DBMS_PROXY_SQL.ADD_MAPPING( 
    object_owner   => 'DW_USER',
    object_name    => 'INVENTORY',
    database_ocid  => 'TARGET_DATABASE_OCID');
END;
/

Esempio per abilitare l'instradamento a livello di schema:

BEGIN
 DBMS_PROXY_SQL.ADD_MAPPING( 
    object_owner   => 'DW_USER',
    object_name    => '*',
    database_ocid  => 'TARGET_DATABASE_OCID');
END;
/

Note per l'uso

• Per eseguire questa procedura, è necessario aver eseguito il login come utente ADMIN o disporre del privilegio EXECUTE sul pacchetto DBMS_PROXY_SQL.

• È necessario eseguire questa procedura sull'istanza di Autonomous Database del router.

Sintassi

DBMS_PROXY_SQL.DISABLE_READ_ONLY_OFFLOAD;

Esempio

EXEC DBMS_PROXY_SQL.DISABLE_READ_ONLY_OFFLOAD;

Sintassi

DBMS_PROXY_SQL.DISABLE_ROUTING;

Esempio

Note sull'uso

• Per eseguire questa procedura, è necessario aver eseguito il login come utente ADMIN o disporre del privilegio EXECUTE sul pacchetto DBMS_PROXY_SQL.

• È necessario eseguire questa procedura sull'istanza di Autonomous Database del router.

Sintassi

DBMS_PROXY_SQL.ENABLE_READ_ONLY_OFFLOAD( 
      module_name       IN CLOB, 
      action_name       IN CLOB);

Parametri

Note sull'uso

• Se vengono specificati sia module_name che action_name, il nome del modulo di una sessione deve corrispondere a un valore nell'elenco dei nomi dei moduli e il relativo nome azione deve corrispondere a un valore nell'elenco dei nomi delle azioni affinché la sessione venga considerata per l'offload.

• Quando l'offload delle query è abilitato per una sessione, è possibile trovare il nome della copia aggiornabile in cui vengono scaricate le query. Ad esempio:

  SELECT sys_context('userenv', 'con_name') from dual;

  Se le query non vengono scaricate in una copia aggiornabile, questa query mostra il nome del leader del pool elastico (o il nome del membro del pool elastico).

• Nelle viste DBA_PROXY_SQL_ACTIONS e DBA_PROXY_SQL_MODULES viene visualizzata la lista dei moduli o delle azioni configurati per l'offload delle query. È necessario eseguire una query su queste viste da una sessione non abilitata per l'offload delle query.

  Per ulteriori informazioni, vedere DBA_PROXY_SQL Views.

• Quando si scaricano le query da una lista di sessioni specificate 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 case sensitive. Ad esempio, quando una sessione ha un nome di modulo minuscolo o un nome di modulo con maiuscole e minuscole, il caso deve corrispondere nei valori dei parametri quando si abilita l'offload delle 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;
  /

Esempi

EXEC DBMS_PROXY_SQL.ENABLE_READ_ONLY_OFFLOAD;


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

Sintassi

DBMS_PROXY_SQL.ENABLE_ROUTING;

Esempio

Note sull'uso

• Per eseguire questa procedura, è necessario aver eseguito il login come utente ADMIN o disporre del privilegio EXECUTE sul pacchetto DBMS_PROXY_SQL.

• È necessario eseguire questa procedura sull'istanza di Autonomous Database del router.

Sintassi

DBMS_PROXY_SQL.REJECT_MAPPING ( 
    object_owner         IN VARCHAR2,
    router_database_ocid IN VARCHAR2);

Parametri

Esempio

BEGIN
 DBMS_PROXY_SQL.REJECT_MAPPING ( 
    object_owner          => 'DW_USER',
    router_database_ocid  => 'TARGET_DATABASE_OCID');
 END;
/

Note sull'uso

• È necessario eseguire la procedura sull'istanza di Autonomous Database di destinazione.

• Per eseguire questa procedura, è necessario aver eseguito il login come utente ADMIN o disporre del privilegio EXECUTE sul pacchetto DBMS_PROXY_SQL.

Sintassi

DBMS_PROXY_SQL.REMOVE_MAPPING ( 
    object_owner   IN VARCHAR2,
    object_name    IN VARCHAR2);

Parametri

Esempio

BEGIN
 DBMS_PROXY_SQL.REMOVE_MAPPING ( 
    object_owner   => 'DW_USER',
    object_name    => 'INVENTORY');
 END;
/

Note sull'uso

• È necessario eseguire questa procedura sull'istanza di Autonomous Database del router.

• Per eseguire questa procedura, è necessario aver eseguito il login come utente ADMIN o disporre del privilegio EXECUTE sul pacchetto DBMS_PROXY_SQL.