Aller au contenu

Service SQL IBM i (AS/400) · Vue

QSYS2.USER_INDEX_INFO

Attributs des index utilisateur

Liste les index utilisateur (*USRIDX) avec leurs attributs : longueur d'entrée et de clé, nombre d'entrées, mise à jour immédiate et optimisation.

À quoi ça sert

USER_INDEX_INFO renvoie une ligne par index utilisateur : bibliothèque et nom, type et longueur des entrées, longueur maximale, taille de l'index, mise à jour immédiate, optimisation, insertion des clés, longueur de clé, nombre d'entrées, d'entrées ajoutées et retirées, domaine de l'objet et texte descriptif.

Elle permet d'inventorier les index utilisateur d'une bibliothèque, comme dans l'exemple d'IBM sur MYLIB, ou de vérifier leurs attributs. Les paramètres USER_INDEX et USER_INDEX_LIBRARY (par défaut *LIBL) ciblent la lecture ; IGNORE_ERRORS vaut 'NO' par défaut.

Pour lire le contenu d'un index, voir USER_INDEX_ENTRIES.

Résultat réel sur un IBM i 7.5

Ce que nous avons exécuté :

SELECT * FROM QSYS2.USER_INDEX_INFO

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

USER_INDEX_LIBRARY Bibliothèque de l'index utilisateur USER_INDEX Nom de l'index utilisateur ENTRY_TYPE Type de l'entrée ENTRY_LENGTH Longueur des entrées MAXIMUM_ENTRY_LENGTH Longueur maximale d'une entrée INDEX_SIZE Taille de l'index IMMEDIATE_UPDATE Mise à jour immédiate OPTIMIZATION Optimisation KEY_INSERTION Mode d'insertion des clés KEY_LENGTH Longueur de la clé ENTRY_TOTAL Nombre total d'entrées ENTRIES_ADDED Nombre d'entrées ajoutées ENTRIES_REMOVED Nombre d'entrées supprimées OBJECT_DOMAIN Domaine de l'objet TEXT_DESCRIPTION Texte descriptif
UTIL201 UTIL201 FIXED 128 128 4 GB YES BIBAPP557 YES 1 1 1 0 *USER NULL
UTIL201 UTIL914 VARIABLE 0 2000 4 GB YES BIBAPP557 YES 20 0 0 0 *USER Description de l'objet
QHTTP QTMHPID FIXED 52 52 4 GB YES BIBAPP557 YES 10 10 32 22 *SYSTEM Description de l'objet
QHTTP QZSRPERF FIXED 21 21 4 GB YES SEQUENTIAL YES 10 10 10 0 *SYSTEM Data Index for HTTP server Collection Services
QUSRDIRCF QGLDPU FIXED 11 11 4 GB NO BIBAPP557 YES 11 327 457 130 *SYSTEM Description de l'objet

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

Retourner la liste des attributs de tous les index utilisateur de la bibliothèque MYLIB.

-- Description: Return a list of attributes for all user indexes in MYLIB. 
    SELECT * FROM QSYS2.USER_INDEX_INFO  
  WHERE USER_INDEX_LIBRARY = 'MYLIB';

Paramètres

ParamètreTypePar défautSignification
USER_INDEX VARCHAR(10) obligatoire Nom de l'index utilisateur
USER_INDEX_LIBRARY VARCHAR(10) '*LIBL' Bibliothèque de l'index utilisateur
IGNORE_ERRORS VARCHAR(3) 'NO' Ignorer les erreurs

Colonnes renvoyées (15)

Afficher les 15 colonnes
ColonneTypeSignification
USER_INDEX_LIBRARY VARCHAR(10) Bibliothèque de l'index utilisateur
USER_INDEX VARCHAR(10) Nom de l'index utilisateur
ENTRY_TYPE VARCHAR(8) Type de l'entrée
ENTRY_LENGTH INTEGER Longueur des entrées
MAXIMUM_ENTRY_LENGTH INTEGER Longueur maximale d'une entrée
INDEX_SIZE CHAR(4) Taille de l'index
IMMEDIATE_UPDATE VARCHAR(3) Mise à jour immédiate
OPTIMIZATION VARCHAR(10) Optimisation
KEY_INSERTION VARCHAR(3) Mode d'insertion des clés
KEY_LENGTH INTEGER Longueur de la clé
ENTRY_TOTAL INTEGER Nombre total d'entrées
ENTRIES_ADDED INTEGER Nombre d'entrées ajoutées
ENTRIES_REMOVED INTEGER Nombre d'entrées supprimées
OBJECT_DOMAIN VARCHAR(7) Domaine de l'objet
TEXT_DESCRIPTION VARCHAR(50) Texte descriptif