Connecter une base Oracle en direct (Live Object)

Un nœud de type D (voir Types de nœuds) correspond à un Live Object : une connexion directe et permanente vers une base de données externe, via les extensions PostgreSQL Foreign Data Wrapper (oracle_fdw pour Oracle, postgres_fdw pour PostgreSQL).

Contrairement à un nœud B alimenté par import de rapports statiques, un nœud D interroge la base cible en temps réel à chaque requête.

Prérequis

• Un Live Object doit avoir été préalablement défini côté administration système de KAIROS : identifiant, extension FDW à utiliser (oracle_fdw ou postgres_fdw), paramètres de connexion (utilisateur, mot de passe), et description des tables/collections exposées.
• Si aucun Live Object n'apparaît dans la liste déroulante décrite ci-dessous, contactez votre administrateur KAIROS pour qu'il en configure un.

Procédure

1. Créer un nœud vide : clic droit sur le nœud parent souhaité dans l'arborescence → Create node. Le nouveau nœud est de type N.
2. Ouvrir ce nœud : le sélectionner, puis clic droit → Open node.
3. Dans la fenêtre de propriétés qui s'ouvre, repérer le champ déroulant Live object.
4. Sélectionner le Live Object voulu dans la liste.
5. Cliquer sur le bouton Apply live object.

À la validation, KAIROS effectue les opérations suivantes côté serveur :

1. création d'un foreign server PostgreSQL pointant vers la base cible,
2. création d'une correspondance utilisateur (user mapping) avec les identifiants du Live Object,
3. création d'une table étrangère (foreign table) par table déclarée dans le Live Object,
4. bascule du type du nœud de N vers D.

Le nœud change alors d'icône (base de données) et devient interrogeable en direct depuis les menus de graphiques et de requêtes.

Modifier un Live Object existant

Sur un nœud déjà de type D, le menu contextuel propose l'action Edit Live Object, qui permet de rouvrir le formulaire de connexion et de changer le Live Object appliqué au nœud.

Limites

• La connexion étant établie en temps réel, les performances de consultation dépendent directement de la disponibilité et de la charge de la base source.
• Un Live Object mal configuré (identifiants invalides, réseau inaccessible) fera échouer la création des tables étrangères : vérifiez la connectivité réseau entre le conteneur KAIROS et la base cible (port SQL*Net Oracle, généralement 1521) avant de dépanner plus avant.

Administrer les Live Objects (Manage objects)

Les Live Objects proposés dans la liste déroulante décrite plus haut sont eux-mêmes des objets KAIROS, gérés depuis une fenêtre d'administration dédiée : Manage objects, accessible depuis le menu KAIROS de la barre d'outils principale.

Cette fenêtre liste tous les objets KAIROS (pas seulement les Live Objects) : agrégateurs, charts, gcharts, etc. Le filtre Type permet d'isoler les liveobject. On y distingue :

• des Live Objects système (Origin = kairos_system_system), fournis par défaut : ORACLE_AWR, ORACLE_STATSPACK, ORACLE_V$, MYSELF, awrtemplate, vdollartemplate, ...
• des Live Objects utilisateur (Origin = <votre utilisateur>), créés ou dérivés des modèles système.

La barre d'outils de cette fenêtre propose :

Action	Rôle
Upload object	Importer la définition d'un objet depuis un fichier
Download object	Exporter la définition d'un objet vers un fichier
Delete object	Supprimer un objet
Edit object	Ouvrir l'éditeur de code pour modifier la définition de l'objet sélectionné
Graphical Edit	Alternative graphique à l'édition de code (selon le type d'objet)

Éditer un Live Object

Edit object ouvre un éditeur affichant la définition complète du Live Object sous forme de classe Python (class UserObject(dict)) :

On y trouve deux parties :

• Les attributs de connexion, en tête de classe : ID, IPADDRESS, PORT, CONTAINER (le nom du PDB/service), USER, PASSWORD, INSTANCE, HOST, RETENTION (durée de rétention en jours), ainsi que les requêtes MINDATE/MAXDATE qui bornent la période de données disponible.
• La méthode __init__, qui définit une à une les requêtes SQL exécutées en direct sur la base cible pour chaque collection exposée par ce Live Object (activité, wait events, SQL, IO, mémoire, ...). C'est ce code qui détermine quelles données — et sous quelle forme — seront disponibles dans les menus de graphiques une fois le Live Object appliqué à un nœud.

Contenu sensible

Cet éditeur affiche des identifiants de connexion, potentiellement en clair (comme PASSWORD ci-dessus, masqué dans cette documentation). Limitez l'accès à cette fenêtre aux administrateurs, et ne diffusez pas de captures d'écran de cet éditeur sans les avoir préalablement passées en revue.

Après modification, le bouton Save enregistre la nouvelle définition ; elle est immédiatement disponible pour tout nœud auquel ce Live Object est ou sera appliqué (voir Connecter une base Oracle en direct plus haut).