Documentation sur Oracle Cloud Infrastructure

DBMS_PROXY_SQL

Décrit les procédures permettant d'activer et de désactiver le déchargement des interrogations pour un responsable de groupe élastique ou un membre de groupe élastique. Cet ensemble fournit également des procédures pour activer et gérer ProxySQL pour l'acheminement des énoncés.

Rubrique parent : Informations de référence sur les ensembles fournis avec Autonomous AI Database

Sommaire des sous-programmes DBMS_PROXY_SQL

Ce tableau résume les sous-programmes inclus dans l'ensemble DBMS_PROXY_SQL.

Sous-programme Description
   

ACCEPT_MAPPING Procédure

Ajoute une nouvelle entrée de mappage à l'instance de base de données d'IA autonome cible correspondant à l'entrée de mappage d'un objet de schéma sur l'instance de base de données d'IA autonome du routeur.

ADD_MAPPING Procédure

Ajoute une nouvelle entrée de mappage pour un objet de schéma dans la table de routage de l'instance de base de données Autonomous AI Database sur le routeur.

   

DISABLE_READ_ONLY_OFFLOAD Procédure

Désactive le déchargement d'interrogation pour un chef de groupe élastique de base de données Autonomous AI Database ou pour un membre de groupe élastique.

DISABLE_ROUTING Procédure

Désactive l'acheminement automatique des énoncés ProxySQL pour une instance de base de données d'intelligence artificielle autonome.

ENABLE_READ_ONLY_OFFLOAD Procédure

Permet le déchargement des interrogations pour un chef de groupe élastique de base de données Autonomous AI Database ou pour un membre de groupe élastique.

ENABLE_ROUTING Procédure

Active le routage d'énoncés automatique ProxySQL pour une instance de base de données d'intelligence artificielle autonome.

REJECT_MAPPING Procédure

Supprime une entrée de mappage existante pour un objet de schéma de l'instance de base de données d'intelligence artificielle autonome cible.

REMOVE_MAPPING Procédure

Supprime une entrée de mappage existante pour un objet de schéma de l'instance de base de données Autonomous AI Database du routeur.

  • Procédure ACCEPT_MAPPING
    Exécutez cette procédure sur une instance cible ProxySQL pour ajouter une nouvelle entrée de mappage correspondant à l'entrée de mappage d'un objet dans la table de routage de l'instance de base de données d'IA autonome du routeur.
  • Procédure ADD_MAPPING
    Exécutez cette procédure sur une instance de base de données Autonomous AI Database sur un routeur pour ajouter un nouveau mappage dans la table de routage.
  • Procédure DISABLE_READ_ONLY_OFFLOAD
    Cette procédure désactive le déchargement d'interrogation pour un responsable de groupe élastique de base de données Autonomous AI Database ou pour un membre de groupe élastique.
  • Procédure DISABLE_ROUTING
    Exécutez cette procédure sur une instance de routeur pour désactiver ProxySQL.
  • Procédure ENABLE_READ_ONLY_OFFLOAD
    Cette procédure permet le déchargement d'interrogation pour un chef de groupe élastique de base de données Autonomous AI Database ou pour un membre de groupe élastique.
  • Procédure ENABLE_ROUTING
    Exécutez cette procédure sur une instance Autonomous AI Database pour désigner l'instance en tant qu'instance de routeur et pour activer le routage automatique des énoncés.
  • Procédure REJECT_MAPPING
    Exécutez sur une instance de base de données d'intelligence artificielle autonome cible pour supprimer une entrée de mappage existante de la table d'acceptation.
  • Procédure REMOVE_MAPPING
    Exécutez cette procédure sur l'instance de base de données Autonomous AI Database du routeur pour supprimer une entrée de mappage existante pour un objet de la table de routage.

Rubrique parent : DBMS_PROXY_SQL

ACCEPT_MAPPING Procédure

Exécutez cette procédure sur une instance cible ProxySQL pour ajouter une nouvelle entrée de mappage correspondant à l'entrée de mappage pour un objet dans la table de routage de l'instance de base de données d'intelligence artificielle autonome du routeur.

Syntaxe 

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

Paramètres

Paramètre Description

object_owner

Indique le responsable de l'objet.

Ce paramètre est obligatoire.

router_database_ocid

Spécifie l'OCID de l'instance de base de données de l'IA autonome du routeur.

La valeur router_database_ocid doit être indiquée en majuscules.

Ce paramètre est obligatoire.

Exemple 

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

Notes d'utilisation

  • Vous devez exécuter cette procédure sur l'instance de base de données de l'IA autonome cible.

  • Pour exécuter cette procédure, vous devez être connecté en tant qu'utilisateur ADMIN ou disposer du privilège EXECUTE sur l'ensemble DBMS_PROXY_SQL.

  • Chaque entrée de mappage dans la table de routage sur l'instance de base de données d'IA autonome du routeur doit avoir une entrée correspondante sur l'instance de base de données d'IA autonome cible respective.

ADD_MAPPING Procédure

Exécutez cette procédure sur une instance de base de données Autonomous AI Database du routeur pour ajouter un nouveau mappage dans la table de routage.

Syntaxe 

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

Paramètres

Paramètre Description

object_owner

Indique le responsable de l'objet.

Ce paramètre est obligatoire.

object_name

Spécifie le nom de l'objet pour lequel l'acheminement d'énoncé automatique doit être activé.

Les valeurs valides pour le paramètre object_name sont les suivantes :

  • object_name pour activer le routage au niveau de l'objet.

  • Un astérisque (*) pour activer le routage au niveau du schéma.

Ce paramètre est obligatoire.

database_ocid

Spécifie l'OCID de l'instance de base de données de l'IA autonome cible.

La valeur database_ocid doit être indiquée en majuscules.

Ce paramètre est obligatoire.

Exemples

Exemple pour activer le routage au niveau de l'objet :

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

Exemple pour activer le routage au niveau schéma :

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

Notes d'utilisation

  • Pour exécuter cette procédure, vous devez être connecté en tant qu'utilisateur ADMIN ou disposer du privilège EXECUTE sur l'ensemble DBMS_PROXY_SQL.

  • Vous devez exécuter cette procédure sur l'instance de base de données Autonomous AI Database du routeur.

DISABLE_READ_ONLY_OFFLOAD Procédure

Cette procédure désactive le déchargement des interrogations pour un responsable de groupe élastique de base de données Autonomous AI Database ou pour un membre de groupe élastique.

Syntaxe 

DBMS_PROXY_SQL.DISABLE_READ_ONLY_OFFLOAD;

Exemple 

EXEC DBMS_PROXY_SQL.DISABLE_READ_ONLY_OFFLOAD;

DISABLE_ROUTING Procédure

Exécutez cette procédure sur une instance de routeur pour désactiver ProxySQL.

Syntaxe 

DBMS_PROXY_SQL.DISABLE_ROUTING;

Exemple 

BEGIN
   DBMS_PROXY_SQL.DISABLE_ROUTING;
END;
/

Notes d'utilisation

  • Pour exécuter cette procédure, vous devez être connecté en tant qu'utilisateur ADMIN ou disposer du privilège EXECUTE sur l'ensemble DBMS_PROXY_SQL.

  • Vous devez exécuter cette procédure sur l'instance de base de données Autonomous AI Database du routeur.

ENABLE_READ_ONLY_OFFLOAD Procédure

Cette procédure permet le déchargement des interrogations pour un chef de groupe élastique de base de données Autonomous AI Database ou pour un membre de groupe élastique.

Syntaxe 

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

Paramètres

Paramètre Description

module_name

Indique une liste de noms de module séparés par des virgules. La liste indique les modules dans lesquels les interrogations sont prises en compte pour le déchargement (où le nom du module d'une session correspond à une valeur de la liste).

La valeur par défaut de ce paramètre est NULL, ce qui signifie que le nom du module d'une session peut être n'importe quelle valeur et que la session est prise en compte pour le déchargement.

action_name

Indique une liste de noms d'action séparés par des virgules. La liste spécifie les noms d'action dans lesquels les interrogations sont prises en compte pour le déchargement (où le nom d'action d'une session correspond à une valeur de la liste).

La valeur par défaut de ce paramètre est NULL, ce qui signifie que le nom d'action d'une session peut être n'importe quelle valeur et que la session est prise en compte pour le déchargement

Notes d'utilisation

  • Si module_name et action_name sont spécifiés, le nom du module d'une session doit correspondre à une valeur dans la liste des noms de module et son nom d'action doit correspondre à une valeur dans la liste des noms d'action pour que la session soit prise en compte pour le déchargement.

  • Lorsque le déchargement des interrogations est activé pour une session, vous pouvez trouver le nom du clone actualisable vers lequel les interrogations sont déchargées. Exemple :

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

    Si les interrogations ne sont pas déchargées vers un clone actualisable, cette interrogation affiche le nom du responsable du groupe élastique (ou le nom du membre du groupe élastique).

  • Les vues DBA_PROXY_SQL_ACTIONS et DBA_PROXY_SQL_MODULES affichent la liste des modules ou des actions configurés pour le déchargement des interrogations. Vous devez interroger ces vues à partir d'une session qui n'est pas activée pour le déchargement des interrogations.

    Pour plus d'informations, voir Vues DBA_PROXY_SQL.

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

Exemples

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

ENABLE_ROUTING Procédure

Exécutez cette procédure sur une instance Autonomous AI Database pour désigner l'instance en tant qu'instance de routeur et pour activer le routage automatique des énoncés.

Syntaxe 


DBMS_PROXY_SQL.ENABLE_ROUTING;

Exemple 

BEGIN
   DBMS_PROXY_SQL.ENABLE_ROUTING;
END;
/

Notes d'utilisation

  • Pour exécuter cette procédure, vous devez être connecté en tant qu'utilisateur ADMIN ou disposer du privilège EXECUTE sur l'ensemble DBMS_PROXY_SQL.

  • Vous devez exécuter cette procédure sur l'instance de base de données Autonomous AI Database du routeur.

REJECT_MAPPING Procédure

Exécutez sur une instance de base de données d'intelligence artificielle autonome cible pour supprimer une entrée de mappage existante de la table d'acceptation.

Syntaxe 

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

Paramètres

Paramètre Description

object_owner

Indique le responsable de l'objet.

Ce paramètre est obligatoire.

router_database_ocid

Spécifie l'OCID de l'instance de base de données de l'IA autonome du routeur.

La valeur router_database_ocid doit être indiquée en majuscules.

Ce paramètre est obligatoire.

Exemple 

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

Notes d'utilisation

  • Vous devez exécuter la procédure sur l'instance de base de données de l'IA autonome cible.

  • Pour exécuter cette procédure, vous devez être connecté en tant qu'utilisateur ADMIN ou disposer du privilège EXECUTE sur l'ensemble DBMS_PROXY_SQL.

REMOVE_MAPPING Procédure

Exécutez cette procédure sur l'instance de base de données Autonomous AI Database du routeur pour supprimer une entrée de mappage existante pour un objet de la table de routage.

Syntaxe 

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

Paramètres

Paramètre Description

object_owner

Indique le responsable de l'objet.

Ce paramètre est obligatoire.

object_name

Indique le nom de l'objet pour lequel l'acheminement d'interrogation automatique doit être désactivé.

Ce paramètre est obligatoire.

Exemple 

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

Notes d'utilisation

  • Vous devez exécuter cette procédure sur l'instance de base de données Autonomous AI Database du routeur.

  • Pour exécuter cette procédure, vous devez être connecté en tant qu'utilisateur ADMIN ou disposer du privilège EXECUTE sur l'ensemble DBMS_PROXY_SQL.