PATH

Syntaxe

Paramètres

Description

Cette fonction permet de retourner le chemin relatif de la ressource indiqué par la condition parente.

Remarques

• Fonction accessoire dans Oracle XML DB : PATH est une fonction accessoire (ancillary) utilisée uniquement en contexte de requêtes XML déposées dans Oracle XML DB. Elle accompagne les conditions UNDER_PATH et EQUALS_PATH, permettant de récupérer un chemin relatif basé sur des ressources XML entreposées dans le dépôt.
• Retourne un chemin relatif : La fonction retourne le chemin relatif menant à une ressource spécifiée dans une condition parente. Cela facilite la navigation dans des structures XML hiérarchiques sans devoir recréer manuellement le chemin complet.
• Corrélation via correlation_integer : Le paramètre correlation_integer (entier) sert à connecter la fonction PATH avec une condition de type UNDER_PATH ou EQUALS_PATH. Il permet de faire coïncider plusieurs conditions et fonctions dans la même requête.
• Valeurs inférieures à 1 traitées comme 1 : Si l'entier de corrélation est inférieur à 1, Oracle le considère automatiquement comme égal à 1. Cela garantit une robustesse pour toutes les valeurs invalides ou par défaut.
• Ne fonctionne pas seul : PATH ne peut être utilisée que conjointement à une condition parent (UNDER_PATH ou EQUALS_PATH). Elle n'est pas utilisable de manière autonome dans une requête.
• Complément à DEPTH : Elle est souvent utilisée avec la fonction DEPTH, qui retourne la profondeur relative de la ressource dans l'arborescence. Ensemble, elles permettent de reconstruire un chemin complet avec informations hiérarchiques.
• Applicabilité aux vues RESOURCE_VIEW et PATH_VIEW : Les vues publiques RESOURCE_VIEW et PATH_VIEW permettent d'accéder aux données du dépôt XML via SQL. PATH s'utilise typiquement dans des requêtes sur ces vues pour repérer les chemins relatifs des ressources.
• Fonctionnalité introduite dès Oracle XML DB initial : Dès l'introduction d'Oracle XML DB, Oracle a enrichi le SQL avec des fonctions comme UNDER_PATH, EQUALS_PATH, PATH, et DEPTH pour faciliter la navigation dans les ressources XML, sans nécessiter de PL/SQL ou de parcours manuel en PL/SQL.
• Améliore la performance des accès hiérarchiques : L'utilisation de PATH dans des requêtes permet de bénéficier des index hiérarchiques internes d'Oracle XML DB, rendant les recherches sous-arborescentes plus performantes qu'en reconstruction manuelle du chemin.
• Simplifie la génération de rapports hiérarchiques : En combinant PATH avec DEPTH, on peut produire des rapports ou des exports listant précisément le positionnement, le niveau et le chemin des documents stockés dans Oracle XML DB, sans complexité de formatage.
• Stabilité inter-versions : La fonction PATH et ses consours ont été présentes dans Oracle depuis au moins la version 9i/10g avec Oracle XML DB, et sont toujours supportées dans les dernières versions (jusqu'à 21c et au-delà), assurant une compatibilité ascendante fiable.

Exemple

Cas d'usage typique :

Cela récupère le chemin relatif (PATH(1)) et la profondeur (DEPTH(2)) pour les ressources correspondant à la condition UNDER_PATH.

Voir également

Article - Les géants de l'informatique - Oracle