Service SQL IBM i (AS/400) · Fonction table
QSYS2.LIBRARY_INFO
Informations sur une bibliothèque
Renvoie les caractéristiques d'une bibliothèque : nombre d'objets, taille, type, ASP, audit et journalisation : l'équivalent SQL de DSPLIBD.
À quoi ça sert
La fonction de table prend le nom d'une bibliothèque (LIBRARY_NAME) et renvoie une ligne : nombre d'objets, taille, taille complète, type, texte descriptif, ASP, droit de création, audit de création des objets, journalisation de la bibliothèque, journal et règles d'héritage de journalisation.
Le paramètre DETAILED_INFO permet de choisir entre un résultat rapide et un résultat détaillé, plus coûteux à calculer, et IGNORE_ERRORS règle le comportement en cas de bibliothèque inaccessible. Le calcul de la taille est la partie la plus lourde, surtout pour une grosse bibliothèque.
On l'utilise pour dresser l'inventaire des bibliothèques d'un système, repérer les plus volumineuses, ou contrôler en série qu'une propriété comme la journalisation est cohérente d'une bibliothèque à l'autre. L'exemple d'IBM interroge la bibliothèque APPLIB.
Résultat réel sur un IBM i 7.5
Ce que nous avons exécuté :
SELECT * FROM TABLE(QSYS2.LIBRARY_INFO('JOBISQL'))Ce que l'IBM i a renvoyé le 01/10/2026 (1 ligne au plus) :
| OBJECT_COUNT Nombre d'objets | LIBRARY_SIZE Taille de la bibliothèque | LIBRARY_SIZE_COMPLETE Indicateur de taille de bibliothèque complète | LIBRARY_TYPE Type de bibliothèque | TEXT_DESCRIPTION Texte descriptif | IASP_NAME Nom de l'ASP indépendant | IASP_NUMBER Numéro de l'ASP indépendant | CREATE_AUTHORITY Droit de création | OBJECT_AUDIT_CREATE Audit à la création des objets | JOURNALED Indicateur de journalisation | JOURNAL_LIBRARY Bibliothèque du journal | JOURNAL_NAME Nom du journal | INHERIT_JOURNALING Héritage de la journalisation | JOURNAL_INHERIT_RULES Règles d'héritage de journalisation | JOURNAL_START_TIMESTAMP Horodatage de début de journalisation | APPLY_STARTING_RECEIVER_LIBRARY Bibliothèque du récepteur de journal de départ de l'application | APPLY_STARTING_RECEIVER Récepteur de journal de départ de l'application | APPLY_STARTING_RECEIVER_ASP ASP du récepteur de journal de départ de l'application |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 44 | 5451776 | YES | PROD | Demonstrations des services SQL de job-i.fr | *SYSBAS | 1 | *EXCLUDE | *SYSVAL | YES | JOBISQL | QSQJRN | YES | 1 | 2026-10-01 09:05:28.267000 | NULL | NULL | NULL |
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écupérer les informations de la bibliothèque APPLIB.
-- Description: Retrieve information about library APPLIB.
SELECT * FROM TABLE(QSYS2.LIBRARY_INFO('APPLIB'));Bon à savoir
Sur une bibliothèque qui contient des centaines de milliers d'objets, le calcul de la taille peut être long : n'active le mode détaillé que si tu en as besoin.
Paramètres
| Paramètre | Type | Par défaut | Signification |
|---|---|---|---|
LIBRARY_NAME |
VARCHAR(10) | obligatoire | Nom de la bibliothèque |
IGNORE_ERRORS |
VARCHAR(3) | 'YES' | Ignorer les erreurs |
DETAILED_INFO |
VARCHAR(12) | 'LIBRARY_SIZE' | Informations détaillées |
Colonnes renvoyées (18)
Afficher les 18 colonnes
| Colonne | Type | Signification |
|---|---|---|
OBJECT_COUNT |
INTEGER | Nombre d'objets |
LIBRARY_SIZE |
BIGINT | Taille de la bibliothèque |
LIBRARY_SIZE_COMPLETE |
VARCHAR(3) | Indicateur de taille de bibliothèque complète |
LIBRARY_TYPE |
CHAR(4) | Type de bibliothèque |
TEXT_DESCRIPTION |
VARCHAR(50) | Texte descriptif |
IASP_NAME |
VARCHAR(10) | Nom de l'ASP indépendant |
IASP_NUMBER |
INTEGER | Numéro de l'ASP indépendant |
CREATE_AUTHORITY |
VARCHAR(10) | Droit de création |
OBJECT_AUDIT_CREATE |
VARCHAR(7) | Audit à la création des objets |
JOURNALED |
VARCHAR(3) | Indicateur de journalisation |
JOURNAL_LIBRARY |
VARCHAR(10) | Bibliothèque du journal |
JOURNAL_NAME |
VARCHAR(10) | Nom du journal |
INHERIT_JOURNALING |
VARCHAR(3) | Héritage de la journalisation |
JOURNAL_INHERIT_RULES |
INTEGER | Règles d'héritage de journalisation |
JOURNAL_START_TIMESTAMP |
TIMESTAMP | Horodatage de début de journalisation |
APPLY_STARTING_RECEIVER_LIBRARY |
VARCHAR(10) | Bibliothèque du récepteur de journal de départ de l'application |
APPLY_STARTING_RECEIVER |
VARCHAR(10) | Récepteur de journal de départ de l'application |
APPLY_STARTING_RECEIVER_ASP |
VARCHAR(10) | ASP du récepteur de journal de départ de l'application |