Aller au contenu

Service SQL IBM i (AS/400) · Fonction table

SYSTOOLS.RELATED_OBJECTS

Objets dépendants d'un fichier

Liste les objets qui dépendent d'un fichier : vues, index, déclencheurs, contraintes et autres objets SQL qui s'y rapportent.

À quoi ça sert

Cette fonction de table prend un fichier (FILE_NAME) et sa bibliothèque (LIBRARY_NAME) et renvoie les objets liés : le schéma et le nom SQL source, le schéma et le nom de l'objet dépendant, son type SQL, son nom système, son propriétaire, ses commentaires et sa dernière modification.

Elle sert avant de modifier ou supprimer une table : savoir quelles vues, index ou autres objets seront touchés, comme avec DSPDBR pour les dépendances de fichiers. Le SQL permet de trier, de filtrer par type d'objet et de conserver la liste dans un document de migration.

Résultat réel sur un IBM i 7.5

Ce que nous avons exécuté :

SELECT * FROM TABLE(SYSTOOLS.RELATED_OBJECTS(LIBRARY_NAME=>'JOBISQL', FILE_NAME=>'CLIENT'))

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

SOURCE_SCHEMA_NAME Nom du schéma source SOURCE_SQL_NAME Nom SQL source SQL_OBJECT_TYPE Type d'objet SQL SCHEMA_NAME Nom du schéma SQL_NAME Nom SQL LIBRARY_NAME Nom de la bibliothèque SYSTEM_NAME Nom du système OBJECT_OWNER Propriétaire de l'objet LONG_COMMENT Commentaire détaillé OBJECT_TEXT Texte descriptif de l'objet LAST_ALTERED Horodatage de dernière modification
JOBISQL CLIENT VIEW JOBISQL GROS_CLIENTS JOBISQL GROS_00001 UTIL232 NULL NULL 2026-10-01 09:05:29.887000
JOBISQL CLIENT INDEX JOBISQL CLIENT_VILLE JOBISQL CLIEN00001 UTIL232 NULL NULL 2026-10-01 09:05:29.784000

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

Lister tous les objets qui dépendent du fichier ORDERS de la bibliothèque APPLIB.

-- Description: List all the objects that are dependent on the ORDERS file in APPLIB. 
 SELECT * FROM TABLE(SYSTOOLS.RELATED_OBJECTS( 
                    LIBRARY_NAME=>'APPLIB', FILE_NAME=>'ORDERS'));

Bon à savoir

À consulter systématiquement avant un ALTER TABLE ou un DROP : une vue oubliée est la cause fréquente d'une erreur après modification.

Paramètres

ParamètreTypePar défautSignification
LIBRARY_NAME VARCHAR(10) obligatoire Nom de la bibliothèque
FILE_NAME VARCHAR(10) obligatoire Nom du fichier

Colonnes renvoyées (11)

Afficher les 11 colonnes
ColonneTypeSignification
SOURCE_SCHEMA_NAME VARCHAR(128) Nom du schéma source
SOURCE_SQL_NAME VARCHAR(128) Nom SQL source
SQL_OBJECT_TYPE VARCHAR(24) Type d'objet SQL
SCHEMA_NAME VARCHAR(128) Nom du schéma
SQL_NAME VARCHAR(128) Nom SQL
LIBRARY_NAME VARCHAR(10) Nom de la bibliothèque
SYSTEM_NAME VARCHAR(279) Nom du système
OBJECT_OWNER VARCHAR(10) Propriétaire de l'objet
LONG_COMMENT GRAPHIC VARYING Commentaire détaillé
OBJECT_TEXT GRAPHIC VARYING Texte descriptif de l'objet
LAST_ALTERED TIMESTAMP Horodatage de dernière modification