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.

Sommaire des sous-programmes DBMS_PROXY_SQL

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

Sous-programme Description
   
Procédure ACCEPT_MAPPING 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.
Procédure ADD_MAPPING 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.
   
Procédure DISABLE_READ_ONLY_OFFLOAD 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.
Procédure DISABLE_ROUTING Désactive l'acheminement automatique des énoncés ProxySQL pour une instance de base de données d'intelligence artificielle autonome.
Procédure ENABLE_READ_ONLY_OFFLOAD 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.
Procédure ENABLE_ROUTING Active le routage d'énoncés automatique ProxySQL pour une instance de base de données d'intelligence artificielle autonome.
Procédure REJECT_MAPPING 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.
Procédure REMOVE_MAPPING 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 Autonomous AI Database sur le routeur.

  • Procédure ADD_MAPPING Exécutez cette procédure sur une instance de base de données d'IA autonome de 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 des interrogations 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 IA autonome 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.

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.