XMLCONCAT |
Concaténation XML |
|---|---|
| Oracle Database SQL | Oracle 9i Release 1 (version 9.0) ou supérieure |
Syntaxe
| XMLCONCAT(XMLTypeInstance) |
Paramètres
| Nom | Description |
|---|---|
| XMLTypeInstance | Ce paramètre permet d'indiquer une expression retournant une valeur XML. |
Description
Cette fonction permet de retourner le résultat de la concaténation d'une série d'élément pour chacun des enregistrements.
Remarques
- XMLCONCAT est conçue pour fusionner plusieurs fragments XML en un seul résultat XML, tout en préservant la validité syntaxique des balises. Contrairement à une simple concaténation de chaînes, elle comprend la structure XML et ne casse pas l'arborescence.
- Les paramètres fournis à XMLCONCAT doivent être de type XMLType ou convertibles en XMLType. Dans le cas contraire, il est nécessaire d'utiliser des fonctions comme XMLElement ou XMLForest pour générer des blocs XML valides avant la concaténation.
- L'ordre des paramètres est strictement respecté dans le résultat final. Cela signifie qu'un changement dans la séquence des arguments modifie directement l'ordre des balises dans le document XML produit.
- Si l'un des fragments XML passés en paramètre est NULL, XMLCONCAT l'ignore sans générer d'erreur. Cela facilite la gestion des données partielles ou optionnelles dans un flux XML.
- Cette fonction ne crée pas automatiquement un élément racine unique. Si un document XML valide nécessite une balise racine commune, celle-ci doit être explicitement générée autour du résultat via XMLElement ou une autre fonction XML.
- XMLCONCAT est souvent utilisée conjointement avec XMLAGG lorsqu'il faut agréger des fragments XML provenant de plusieurs lignes, puis concaténer le résultat avec d'autres sections XML statiques ou calculées.
- Les données passées à XMLCONCAT doivent respecter les règles de validité XML (balises fermées, encodage correct). En cas de fragment mal formé, la fonction renverra une erreur et arrêtera le traitement.
- Cette fonction retourne un résultat de type XMLType, permettant ainsi un chaînage direct avec d'autres fonctions SQL/XML comme EXTRACT, EXISTSNODE ou XMLSERIALIZE pour filtrer, vérifier ou mettre en forme les données.
- L'utilisation de XMLCONCAT ne modifie pas le contenu interne des fragments, ce qui garantit que la mise en forme ou les attributs d'origine des balises restent intacts dans le document final.
- Dans un contexte applicatif, XMLCONCAT est idéale pour générer dynamiquement des sections XML provenant de différentes sources, comme l'assemblage d'informations client et commande en un seul document.
- Par défaut, XMLCONCAT ne produit pas de mise en forme lisible (indentation ou sauts de ligne). Pour obtenir un affichage formaté, il faut ensuite utiliser XMLSERIALIZE avec l'option INDENT ou un outil externe.
- Introduite avec Oracle 9i Release 1 (9.0), XMLCONCAT fait partie des premières fonctions SQL/XML natives intégrées dans Oracle pour répondre au besoin croissant de manipulation de données semi-structurées directement dans la base de données relationnelle.
Voir également
Langage de programmation - XML (eXtensible Markup Language) - Accueil
Article - Les géants de l'informatique - Oracle
Dernière mise à jour : Lundi, le 11 mai 2015