Service SQL IBM i (AS/400) · Procédure
QSYS2.IMPORT_PC_SNAPSHOT
Importer un cliché du plan cache
Importe un cliché (snapshot) du cache de plans SQL préalablement sauvegardé, pour l'analyser avec les outils de performance SQL.
À quoi ça sert
Un cliché du plan cache est une copie, à un instant donné, des plans d'exécution et des statistiques de requêtes que Db2 for i garde en mémoire. Cette procédure ré-importe un tel cliché pour l'examiner, par exemple pour comparer le comportement des requêtes avant et après un changement.
Elle prend trois paramètres : PLAN_CACHE_LIBRARY et PLAN_CACHE_FILE, qui désignent la provenance du cliché, et IMPORTED_NAME, le nom sous lequel il apparaîtra. L'exemple d'IBM importe le fichier SNAP160217 de la bibliothèque SNAPSHOTS avec le texte Snapshot captured on 02/17/2016.
Pour retirer un cliché importé devenu inutile, il existe QSYS2.REMOVE_PC_SNAPSHOT. Le pendant pour les moniteurs d'événements est QSYS2.IMPORT_PC_EVENT_MONITOR.
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 cliché (snapshot).
-- Description: Import a snapshot
CALL QSYS2.IMPORT_PC_SNAPSHOT('SNAPSHOTS',
'SNAP160217','Snapshot captured on 02/17/2016');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é |