DBMS_PROXY_SQL

Syntax

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

Parameter

Beispiel

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

Hinweise zur Verwendung

• Sie müssen diese Prozedur auf der autonomen KI-Zieldatenbankinstanz ausführen.

• Um diese Prozedur ausführen zu können, müssen Sie als ADMIN-Benutzer angemeldet sein oder die Berechtigung EXECUTE für das Package DBMS_PROXY_SQL besitzen.

• Jeder Zuordnungseintrag in der Routing-Tabelle der autonomen AI-Datenbankinstanz des Routers muss einen entsprechenden Eintrag in der jeweiligen autonomen AI-Zieldatenbankinstanz aufweisen.

Syntax

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

Parameter

Beispiele

Beispiel zum Aktivieren des Routings auf Objektebene:

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

Beispiel zum Aktivieren des Routings auf Schemaebene:

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

Hinweise zur Verwendung

• Um diese Prozedur ausführen zu können, müssen Sie als ADMIN-Benutzer angemeldet sein oder die Berechtigung EXECUTE für das Package DBMS_PROXY_SQL besitzen.

• Sie müssen diese Prozedur auf der autonomen AI-Datenbankinstanz des Routers ausführen.

Syntax

DBMS_PROXY_SQL.DISABLE_READ_ONLY_OFFLOAD;

Beispiel

EXEC DBMS_PROXY_SQL.DISABLE_READ_ONLY_OFFLOAD;

Syntax

DBMS_PROXY_SQL.DISABLE_ROUTING;

Beispiel

Hinweise zur Verwendung

• Um diese Prozedur ausführen zu können, müssen Sie als ADMIN-Benutzer angemeldet sein oder die Berechtigung EXECUTE für das Package DBMS_PROXY_SQL besitzen.

• Sie müssen diese Prozedur auf der autonomen AI-Datenbankinstanz des Routers ausführen.

Syntax

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

Parameter

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 die Auslagerung berücksichtigt wird.

• Wenn die Abfrageauslagerung für eine Session aktiviert ist, können Sie den Namen des aktualisierbaren Klons finden, an den Abfragen ausgelagert werden. Beispiel:

  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.

• Die Ansichten DBA_PROXY_SQL_ACTIONS und DBA_PROXY_SQL_MODULES zeigen die Liste der Module oder Aktionen an, die für die Abfrageauslagerung konfiguriert sind. Sie müssen diese Ansichten 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, wird bei dem mit DBMS_APPLICATION_INFO festgelegten Modulnamen und Aktionsnamen die Groß-/Kleinschreibung beachtet. DBMS_PROXY_SQL.ENABLE_READ_ONLY_OFFLOAD hält sich an dieses Verhalten unter Berücksichtigung der Groß-/Kleinschreibung. Beispiel: Wenn eine Session einen Modulnamen in Kleinbuchstaben oder einen Modulnamen in gemischter Groß-/Kleinschreibung hat, 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;
/

Syntax

DBMS_PROXY_SQL.ENABLE_ROUTING;

Beispiel

Hinweise zur Verwendung

• Um diese Prozedur ausführen zu können, müssen Sie als ADMIN-Benutzer angemeldet sein oder die Berechtigung EXECUTE für das Package DBMS_PROXY_SQL besitzen.

• Sie müssen diese Prozedur auf der autonomen AI-Datenbankinstanz des Routers ausführen.

Syntax

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

Parameter

Beispiel

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

Hinweise zur Verwendung

• Sie müssen die Prozedur in der autonomen KI-Zieldatenbankinstanz ausführen.

• Um diese Prozedur ausführen zu können, müssen Sie als ADMIN-Benutzer angemeldet sein oder die Berechtigung EXECUTE für das Package DBMS_PROXY_SQL besitzen.

Syntax

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

Parameter

Beispiel

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

Hinweise zur Verwendung

• Sie müssen diese Prozedur auf der autonomen AI-Datenbankinstanz des Routers ausführen.

• Um diese Prozedur ausführen zu können, müssen Sie als ADMIN-Benutzer angemeldet sein oder die Berechtigung EXECUTE für das Package DBMS_PROXY_SQL besitzen.