XMLAGG-Funktion [Aggregat]

XMLAGG( expression [ ORDER BY  order-by-expression ] )

expression Ein XML-Wert. Der Inhalt wird in Escapezeichen gesetzt, es sei denn, der Datentyp ist XML. Der order_by_expression sortiert die von der Funktion zurückgegebenen Elemente.

order-by-expression Ein Ausdruck, der zum Sortieren der XML-Elemente anhand des Ausdruckwerts verwendet wird.

Wenn eine ORDER BY-Klausel Konstanten enthält, werden sie vom Optimierer interpretiert und dann durch eine entsprechende ORDER BY-Klausel ersetzt. Der Optimierer interpretiert z.B. "ORDER BY 'a'" als ORDER BY-Ausdruck.

Ein Abfrageblock, der mehr als eine Aggregatfunktion mit gültigen ORDER BY-Klauseln enthält, kann ausgeführt werden, wenn die ORDER BY-Klauseln logisch in einer einzigen ORDER BY-Klausel kombiniert werden können. Zum Beispiel sind folgende Klauseln vorhanden:

ORDER BY expression1, 'a', expression2

ORDER BY expression1, 'b', expression2, 'c', expression3

Sie werden in der folgenden Klausel zusammengefasst:

ORDER BY expression1, expression2, expression3

XML

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 unterVerwendung der XMLAGG-Funktion.

Verwendung der XMLAGG-Funktion

SQL/2008 XMLAGG ist Teil der optionalen SQL/2008-Sprachenfunktion X034. Die optionale ORDER BY-Klausel für die XMLAGG-Funktion umfasst die SQL/2008 Sprachenfunktion X035.

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;

XMLAGG-Funktion [Aggregat]

Syntax

Parameter

Rückgabe

Bemerkungen

Siehe auch

Standards und Kompatibilität

Beispiel