# Démo Oracle — guide utilisateur

## À quoi sert ce module

Démo Oracle donne accès aux rapports de supervision Oracle de **sw** sur une
base réellement connectée, en consultation seule. Ce que vous voyez à l'écran
est produit par les mêmes requêtes que la version complète : les chiffres sont
vrais, pas simulés.

Trois différences avec la version complète, et elles sont assumées :

1. **aucune action** n'est exécutable sur la base ;
2. les fenêtres d'analyse et les filtres sont **plafonnés** ;
3. certaines pages sont **remplacées** par une explication de ce qu'elles font.

## Se connecter à une base

1. Ouvrez **Démo Oracle** depuis le menu de navigation.
2. La page d'accueil liste les bases déclarées (cinq au maximum).
3. Cliquez sur **Se connecter** en regard de celle qui vous intéresse.
4. Le bandeau du haut rappelle en permanence la base sélectionnée ; le bouton
   **Se déconnecter** la relâche.

Si aucune base n'apparaît, c'est qu'aucune n'a été déclarée : demandez-le à la
personne qui administre l'application.

## Lire les rapports

Un **rail vertical** borde la gauche de l'écran, une icône par menu :
Configuration, Temps réel, Historique, Rapports Oracle, Diagnostic, Tableaux de
bord. Survolez une icône, le sous-menu se déplie à droite. C'est la même
navigation que le module Oracle complet.

Le bouton **☰**, à gauche du titre de l'application, replie le rail ; le choix
est mémorisé d'une visite à l'autre. Le rail ne porte que les menus : pour
revenir à la liste des bases, passez par **Démo Oracle** dans la barre de
navigation ; la déconnexion s'y trouve aussi, sous le rappel de la base
connectée.

Le nom de la base connectée est affiché en permanence dans la barre du haut :
les rapports ne le répètent pas, ils portent seulement leur propre titre.

Une section marquée d'un cadenas (&#128274;) reste cliquable : elle mène à une
page qui décrit la fonction sans l'exécuter. Elle n'est pas masquée, parce que
savoir ce qui existe fait partie de ce que la démonstration doit montrer.

### Ce que vous pouvez consulter

| Menu | Sections servies |
| --- | --- |
| Configuration | paramètres, tablespaces et redo logs, mémoire PGA/SGA, indicateurs, calcul des statistiques, optimisation SQL |
| Temps réel | activité temps réel, sessions actives, diagnostic des verrous, détail d'un SQL_ID |
| Historique | rapport d'historique, rapport ASH |
| Diagnostic | ralentissement, ORA-01555, ORA-04030, ORA-04031 |
| Tableaux de bord | synthèse des sauvegardes, exports/imports/tables externes, TDE et portefeuilles |

### Les plafonds, section par section

| Section | Ce qui est bridé |
| --- | --- |
| Paramètres | la modification d'une valeur et sa remise par défaut |
| Tablespaces et redo logs | le tri du graphique ; le redimensionnement et la gestion des groupes redo |
| Mémoire PGA/SGA | rien |
| Indicateurs | rien |
| Calcul des statistiques | les trois commandes (préférence, planification, tâche automatique) |
| Optimisation SQL | la modification d'un paramètre, la suppression d'un profil |
| Activité temps réel | fenêtre figée à 30 min, trois dimensions sur sept, service « tous », sessions actives |
| Sessions actives | l'arrêt de session |
| Diagnostic des verrous | aucune action |
| Détail SQL | cinq onglets sur huit ; ni outlines, ni fixage de plan |
| Historique | profondeur figée à 7 jours |
| Rapport ASH | amplitude plafonnée à 24 h, deux dimensions sur huit, service « tous » |
| Diagnostics ORA-* et ralentissement | rien |
| Synthèse des sauvegardes | rien |
| Exports, imports, tables externes | le lien vers le détail d'un objet |
| TDE et portefeuilles | l'activation de l'auto-login d'un portefeuille |

### Le détail d'un SQL_ID

Cette page n'a pas d'entrée de menu : on y arrive en cliquant droit sur un
`SQL_ID`, dans les Top SQL de l'activité temps réel ou dans la liste des
sessions actives, puis **Ouvrir le détail SQL**.

Cinq onglets sur huit sont servis, à l'identique de la version complète :

| Onglet | État |
| --- | --- |
| Plans d'exécution | servi — arbre complet, prédicats, plans adaptables, binds peekés |
| Efficacité des plans | servi |
| Texte SQL | servi, mise en forme et coloration comprises |
| Historique des charges | servi |
| SQL Monitoring | servi — les exécutions en cours de ce SQL, sans licence Oracle |
| Objets liés | version complète |
| Statistiques d'exécution | version complète |
| Historique des plans | version complète |

Dans l'onglet des plans, deux choses manquent par rapport à la version
complète : les **directives outline** et le bouton **Fixer ce plan**. Une
outline est la liste de hints qui reproduit exactement un plan ; c'est ce que
la version complète injecte dans un SQL Profile, un SQL Patch ou une baseline
pour figer ce plan. La démonstration ne sait pas fixer un plan, et ne reçoit
donc pas les outlines.

### L'historique et le rapport ASH

Le rapport d'**historique** montre la courbe de charge horaire et trois cartes
de chaleur : charge, entrées-sorties, commutations de redo. Sa profondeur est
figée à sept jours ; les boutons 1 j et 30 j restent affichés, éteints. Cliquer
sur une case d'une carte de chaleur ouvre le **rapport ASH** sur l'heure
correspondante.

Le **rapport ASH** détaille les échantillons à la minute — voire à la seconde
sur une période courte. Deux limites :

- l'**amplitude est plafonnée à 24 heures**. Si vous demandez une période plus
  longue, le début est conservé et la fin ramenée : vous obtenez les 24 h qui
  suivent la date de début que vous avez saisie, jamais une autre période que
  celle que vous avez commencé à décrire ;
- deux **dimensions** sur huit sont servies, classe d'attente et module — le
  même choix qu'en temps réel.

En revanche, le filtrage croisé sur les six panneaux Top N (SQL, PHV, FMS,
événement, module, action) fonctionne normalement : il resserre ce que la
période montre déjà.

Ces deux rapports ont besoin d'une source d'échantillons : le Diagnostic Pack,
ou le paquetage `sw$bash_snapper` s'il est installé sur la base. Sans l'un ni
l'autre, ils s'affichent en le disant. Le test de connexion, côté
administration, prévient à l'avance.

Sur l'activité temps réel, le **filtre croisé** — cliquer sur une barre d'un
panneau Top N pour restreindre tous les autres — fonctionne normalement. Il ne
donne accès à rien de plus : il resserre ce que la fenêtre montre déjà.

### Le SQL Monitor, sans licence Oracle

Oracle facture le suivi d'exécution en temps réel au titre du **Tuning Pack**.
Ce rapport-là est pourtant servi : la démonstration ne lit aucune des vues
concernées, elle reconstruit le suivi à partir des sessions actives, qu'elle
**échantillonne** à chaque rafraîchissement.

Vous y trouverez le plan d'exécution ligne à ligne, la répartition du temps par
ligne de plan et par classe d'attente, la mémoire et le temporaire consommés
par opération, l'avancement des opérations longues, et les totaux de
l'exécution.

Trois choses manquent, et la page les dit :

- **les exécutions terminées sont invisibles.** Sans licence il n'existe aucun
  inventaire : seul ce qui tourne est visible, et la fin d'une exécution est
  déduite de la disparition de ses sessions ;
- **le nombre de lignes réellement produites et les démarrages par opération
  n'existent pas** — Oracle ne les compte que sous Real-Time SQL Monitoring.
  Ces colonnes affichent « — », jamais zéro ;
- sur certaines bases, **la ligne de plan active n'est pas renseignée**. Le
  rapport le détecte et présente alors l'activité globalement, sans
  l'attribuer ligne par ligne. Le reste demeure.

Plus vous laissez la page ouverte, plus l'histogramme se précise : chaque
rafraîchissement ajoute un relevé.

### Ce qui renvoie vers la version complète

Journal d'alerte, points de restauration, piste d'audit, rapports ASH et AWR
produits par Oracle, licences, ordonnanceur et travaux, statistiques système.

## Les limites, en clair

| Ce que vous verrez | Pourquoi |
| --- | --- |
| Un bouton grisé avec une pastille jaune | l'action existe dans la version complète ; elle est absente d'ici |
| Un choix de période bloqué | l'amplitude d'analyse est plafonnée (24 h pour un rapport ASH) |
| Un historique qui s'arrête à sept jours | la profondeur d'historique est plafonnée |
| Un filtre de service figé sur « tous » | le filtrage fin appartient à la version complète |
| Des options de tri inactives | idem |

Sur les **sessions actives**, l'arrêt d'une session est signalé comme
disponible dans la version complète, pour les profils DBA et DEV. Aucun lien
vers les rapports `DBMS_SQLTUNE` n'est proposé — en revanche le clic droit sur
un `SQL_ID` ouvre bien le détail SQL, qui fait partie de la démonstration.

## Une question fréquente

> Le bouton est grisé — puis-je le forcer ?

Non, et pas seulement parce que c'est déconseillé : le module ne contient
aucun code capable d'exécuter ces commandes. Le bouton grisé n'est pas une
serrure, c'est un panneau d'information.
