Service SQL IBM i (AS/400) · Procédure
QSYS2.IMPORT_PC_EVENT_MONITOR
Importer un moniteur d'événements du plan cache
Importe dans le système un moniteur d'événements du cache de plans SQL préalablement sauvegardé, pour l'analyser avec les outils de performance SQL.
À quoi ça sert
Le cache de plans SQL (plan cache) conserve les plans d'exécution et les statistiques des requêtes. Un moniteur d'événements du plan cache en capture le contenu à un moment donné ; cette procédure ré-importe un tel moniteur, par exemple pour l'étudier sur un autre système ou après coup.
Elle prend trois paramètres : PLAN_CACHE_LIBRARY et PLAN_CACHE_FILE, qui désignent l'endroit d'où l'on importe, et IMPORTED_NAME, le nom donné au moniteur importé. L'exemple d'IBM importe le moniteur du fichier PRUNETODAY de la bibliothèque SNAPSHOTS sous le nom PRUNED ON 160217.
C'est un outil de l'analyse de performance SQL : une fois importé, le moniteur apparaît parmi les éléments que l'on peut examiner dans l'interface graphique de gestion de la base. Pour importer un cliché pris à un instant donné plutôt qu'un moniteur d'événements, voir QSYS2.IMPORT_PC_SNAPSHOT.
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
Importer un moniteur d'événements.
-- Description: Import an event monitor
CALL QSYS2.IMPORT_PC_EVENT_MONITOR('SNAPSHOTS','PRUNETODAY','PRUNED ON 160217');
Paramètres
| Paramètre | Type | Par défaut | Signification |
|---|---|---|---|
PLAN_CACHE_LIBRARY |
VARCHAR(10) | obligatoire | Bibliothèque du cache des plans |
PLAN_CACHE_FILE |
VARCHAR(10) | obligatoire | Fichier du cache des plans |
IMPORTED_NAME |
CHAR(30) | obligatoire | Nom importé |