QSYS2.RESET_TABLE_INDEX_STATISTICS

À quoi ça sert

Chaque index de Db2 for i garde des compteurs d'utilisation par l'optimiseur, comme QUERY_USE_COUNT et QUERY_STATISTICS_COUNT. Cette procédure les remet à zéro pour tous les index d'une table, désignée par SCHEMA_NAME et TABLE_NAME.

Le paramètre DELETE_ADVICE vaut NO par défaut ; à YES, les conseils d'index associés sont aussi supprimés. L'intérêt est de repartir de zéro avant une période d'observation, pour savoir quels index servent réellement. La procédure n'a pas de mode aperçu.

Résultat réel sur un IBM i 7.5

Ce que nous avons exécuté :

CALL QSYS2.RESET_TABLE_INDEX_STATISTICS('JOBISQL', 'CLIENT');
SELECT TABLE_SCHEMA, TABLE_NAME, INDEX_NAME, QUERY_USE_COUNT, QUERY_STATISTICS_COUNT, LAST_QUERY_USE FROM QSYS2.SYSINDEXSTAT WHERE TABLE_SCHEMA = 'JOBISQL' AND TABLE_NAME = 'CLIENT'

Ce que l'IBM i a renvoyé le 01/10/2026 (1 ligne au plus) :

Données anonymisées : les noms de système, de profils, de bibliothèques, de postes et les adresses IP ont été remplacés. Les objets du schéma JOBISQL sont des objets de démonstration créés pour ce site.

L'exemple d'IBM

Réinitialiser les statistiques QUERY_USE_COUNT et QUERY_STATISTICS_COUNT de tous les index construits sur la table TOYSTORE/EMPLOYEE.

-- Description: Reset the QUERY_USE_COUNT and QUERY_STATISTICS_COUNT 
-- statistics for all the indexes built over the TOYSTORE/EMPLOYEE table 
 CALL QSYS2.RESET_TABLE_INDEX_STATISTICS('TOYSTORE', 'EMPLOYEE');

Paramètres