DBMS_PROXY_SQL

Beschreibt die Verfahren zum Aktivieren und Deaktivieren der Abfrageauslagerung für einen Elastic Pool Leader.

Prozedur DISABLE_READ_ONLY_OFFLOAD

Diese Prozedur deaktiviert die Abfrageauslagerung für einen Elastic Pool Leader von Autonomous Database oder für ein Elastic Pool Member.

Syntax

DBMS_PROXY_SQL.DISABLE_READ_ONLY_OFFLOAD;

Beispiel

EXEC DBMS_PROXY_SQL.DISABLE_READ_ONLY_OFFLOAD;

Prozedur ENABLE_READ_ONLY_OFFLOAD

Diese Prozedur ermöglicht die Abfrageauslagerung für einen Elastic Pool Leader von Autonomous Database oder für ein Elastic Pool Member.

Syntax

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

Parameter

Parameter Beschreibung

module_name

Gibt eine Liste der Modulnamen als durch Komma getrennte Liste an. Die Liste gibt die Module an, bei denen Abfragen für die Auslagerung berücksichtigt werden (wobei der Modulname einer Session mit einem Wert in der Liste übereinstimmt).

Der Standardwert für diesen Parameter ist NULL. Das bedeutet, dass der Modulname einer Session ein beliebiger Wert sein kann und die Session für das Auslagern berücksichtigt wird.

action_name

Gibt eine Liste der Aktionsnamen als durch Komma getrennte Liste an. Die Liste gibt die Aktionsnamen an, bei denen Abfragen für die Auslagerung berücksichtigt werden (wobei der Aktionsname einer Session mit einem Wert in der Liste übereinstimmt).

Der Standardwert für diesen Parameter ist NULL. Das bedeutet, dass der Aktionsname einer Session ein beliebiger Wert sein kann und die Session zum Auslagern berücksichtigt wird

Hinweise zur Verwendung

  • Wenn sowohl module_name als auch action_name angegeben sind, muss der Modulname einer Session mit einem Wert in der Liste der Modulnamen übereinstimmen, und der Aktionsname muss mit einem Wert in der Liste der Aktionsnamen übereinstimmen, damit die Session für das Auslagern berücksichtigt werden kann.

  • Wenn das Auslagern von Abfragen für eine Session aktiviert ist, finden Sie den Namen des aktualisierbaren Klons, in den Abfragen ausgelagert werden. Beispiele:

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

    Wenn Abfragen nicht an einen aktualisierbaren Klon ausgelagert werden, zeigt diese Abfrage den Namen des Elastic Pool Leader (oder den Namen des Elastic Pool Members) an.

  • In den Views DBA_PROXY_SQL_ACTIONS und DBA_PROXY_SQL_MODULES wird die Liste der Module oder Aktionen angezeigt, die für die Abfrageauslagerung konfiguriert sind. Sie müssen diese Views aus einer Session abfragen, die nicht für die Abfrageauslagerung aktiviert ist.

    Weitere Informationen finden Sie unter DBA_PROXY_SQL Views.

  • Wenn Sie Abfragen aus einer Liste von Sessions auslagern, die Sie nach Modul- oder Aktionsname angeben, müssen der Modulname und der Aktionsname mit DBMS_APPLICATION_INFO zwischen Groß- und Kleinschreibung unterschieden werden. DBMS_PROXY_SQL.ENABLE_READ_ONLY_OFFLOAD beachtet dieses Verhalten, bei dem die Groß-/Kleinschreibung beachtet wird. Beispiel: Wenn eine Session einen Modulnamen in Kleinbuchstaben oder einen Modulnamen mit gemischter Groß-/Kleinschreibung enthält, muss die Groß-/Kleinschreibung in den Parameterwerten übereinstimmen, wenn Sie die Abfrageauslagerung mit DBMS_PROXY_SQL.ENABLE_READ_ONLY_OFFLOAD aktivieren und die Parameter module_name oder action_name einschließen.

    Sie können den Modulnamen und den Aktionsnamen für die aktuelle Session mit DBMS_APPLICATION_INFO.READ_MODULE prüfen:

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

Beispiele

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