Service SQL IBM i (AS/400) · Fonction table
QSYS2.USER_SPACE
Contenu d'un espace utilisateur
Fonction de table qui lit le contenu d'un espace utilisateur (*USRSPC), en caractères ou en binaire non converti.
À quoi ça sert
USER_SPACE renvoie le contenu d'un espace utilisateur sous deux formes : la colonne DATA en texte et la colonne DATA_BINARY en binaire non traduit. Les paramètres sont le nom de l'espace (USER_SPACE) et sa bibliothèque (USER_SPACE_LIBRARY, par défaut *LIBL).
Elle sert à inspecter un espace utilisateur utilisé par une application ou par une API système, par exemple pour le déboguer, sans écrire de programme de lecture.
Pour changer le contenu ou les attributs, voir les procédures de modification d'espace utilisateur ; pour les attributs seulement, voir USER_SPACE_INFO.
Résultat réel sur un IBM i 7.5
Ce que nous avons exécuté :
SELECT USER_SPACE_LIBRARY, USER_SPACE, SUBSTR(DATA, 1, 40) AS DEBUT_DES_DONNEES FROM TABLE(QSYS2.USER_SPACE(USER_SPACE => 'DEMOSPC', USER_SPACE_LIBRARY => 'JOBISQL')) X
Ce que l'IBM i a renvoyé le 01/10/2026 (1 ligne au plus) :
| USER_SPACE_LIBRARY Bibliothèque de l'espace utilisateur | USER_SPACE Nom de l'espace utilisateur | DEBUT_DES_DONNEES |
|---|---|---|
| JOBISQL | UTIL907 | Texte écrit par CHANGE_USER_SPACE (démo) |
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
Examiner le contenu non traduit de l'espace utilisateur USRSPACE1 de la bibliothèque TESTLIB.
-- Description: Look at the untranslated contents of user space USERSPC1 in TESTLIB.
SELECT DATA_BINARY FROM TABLE(QSYS2.USER_SPACE(
USER_SPACE => 'USRSPACE1',
USER_SPACE_LIBRARY => 'TESTLIB'));
Paramètres
| Paramètre | Type | Par défaut | Signification |
|---|---|---|---|
USER_SPACE |
VARCHAR(10) | obligatoire | Nom de l'espace utilisateur |
USER_SPACE_LIBRARY |
VARCHAR(10) | '*LIBL' | Bibliothèque de l'espace utilisateur |
Colonnes renvoyées (4)
Afficher les 4 colonnes
| Colonne | Type | Signification |
|---|---|---|
USER_SPACE_LIBRARY |
VARCHAR(10) | Bibliothèque de l'espace utilisateur |
USER_SPACE |
VARCHAR(10) | Nom de l'espace utilisateur |
DATA |
CHAR LARGE OBJECT | Données |
DATA_BINARY |
BINARY LARGE OBJECT | Données au format binaire |