Service SQL IBM i (AS/400) · Procédure
QSYS2.START_PLAN_CACHE_EVENT_MONITOR
Démarrage d'un moniteur du cache de plans
Procédure qui démarre un moniteur d'événements du cache de plans SQL et enregistre les plans dans un fichier, pour analyser les requêtes.
À quoi ça sert
START_PLAN_CACHE_EVENT_MONITOR démarre un moniteur d'événements sur le cache de plans SQL. Les paramètres d'entrée FILESCHEMA et FILENAME désignent la bibliothèque et le nom du fichier qui recevra les données ; le paramètre de sortie MONITORID renvoie l'identifiant du moniteur démarré.
Elle change l'état du système : un moniteur se met à écrire dans le fichier indiqué. Elle n'a pas de mode aperçu. On s'en sert pour capturer ce que le cache de plans contient à un moment donné, ou pour conserver les plans retirés du cache, puis analyser les requêtes coûteuses.
Le moniteur doit ensuite être arrêté avec les procédures de fin du moniteur de cache de plans.
Résultat réel sur un IBM i 7.5
Procédure non exécutée sur notre IBM i de test : elle agit sur la configuration du système ou sur d'autres travaux.
L'exemple d'IBM
Démarrer un moniteur d'événements.
-- Description: Start an event monitor
CALL QSYS2.START_PLAN_CACHE_EVENT_MONITOR('SNAPSHOTS','PRUNETODAY');Bon à savoir
Conservez l'identifiant renvoyé dans MONITORID : il sert à arrêter précisément ce moniteur. END_ALL_PLAN_CACHE_EVENT_MONITORS arrête tous ceux qui sont actifs.
Paramètres
| Paramètre | Type | Par défaut | Signification |
|---|---|---|---|
FILESCHEMA |
VARCHAR(10) | obligatoire | Bibliothèque du fichier |
FILENAME |
VARCHAR(10) | obligatoire | Nom du fichier |
MONITORID |
CHAR(10) | obligatoire | Identifiant du moniteur |