Aller au contenu

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ètreTypePar défautSignification
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é