Erzeugt einen Wald von XML-Elementen aus einer Sammlung von XML-Werten

Syntax

XMLAGG(Wertausdruck [ ORDERBY order_by_Ausdruck ] )

Parameter

Rückgabe

XML

Bemerkungen

NULL wird nicht in das Ergebnis einbezogen. Wenn alle Eingaben gleich NULL sind bzw. keine Zeilen vorhanden sind, ist das Ergebnis gleich NULL. Wenn ein korrekt aufgebautes XML-Dokument gefordert ist, müssen Sie sicherstellen, dass Ihre Abfrage so geschrieben ist, dass die generierte XML nur ein Wurzelelement hat.

Daten in den Spalten BINARY, LONG BINARY, IMAGE und VARBINARY werden automatisch im Base64-kodierten Format zurückgegeben, wenn Sie eine Abfrage ausführen, die XMLAGG enthält.

Ein Beispiel, das die XMLAGG-Funktion mit einer ORDER BY-Klausel verwendet, finden Sie unterDie XMLAGG-Funktion verwenden.

Siehe auch

• Die XMLAGG-Funktion verwenden

Standards und Kompatibilität

Beispiel

Die folgende Anweisung erzeugt ein XML-Dokument, aus dem die von den einzelnen Kunden erteilten Aufträge ersichtlich sind.

SELECT XMLELEMENT( NAME "order",
                   XMLATTRIBUTES( ID AS order_id ),
                     ( SELECT XMLAGG(
                         XMLELEMENT(
                           NAME "Products",
                           XMLATTRIBUTES( ProductID, Quantity AS "quantity_shipped" ) ) )
                      FROM SalesOrderItems soi
                      WHERE soi.ID = so.ID
                     )
                  ) AS products_ordered
FROM SalesOrders so
ORDER BY so.ID;