XMLAGG 函数 [Aggregate]

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

expression XML 值。始终将元素内容转义，除非数据类型为 XML。order-by-expression 会对该函数返回的元素排序。

order-by-expression 用以对 XML 元素排序的表达式，根据该表达式的值对 XML 元素排序。

当 ORDER BY 子句包含常量时，由优化程序对常量进行解释，然后替换为等效的 ORDER BY 子句。例如，优化程序将 ORDER BY 'a' 解释为 ORDER BY 表达式。

对含多个集合函数的查询块，如果几个有效的 ORDER BY 子句可以在逻辑上组合成一个 ORDER BY 子句，则可执行该 ORDER BY 子句。例如，以下子句：

ORDER BY expression1, 'a', expression2

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

可归入下个子句：

ORDER BY expression1, expression2, expression3

XML

结果中任何为 NULL 的值都将被忽略。如果所有的输入都为 NULL，或输入 0 行数据，则结果为 NULL。如果您要求格式正确的 XML 文档，则必须确保编写查询以使生成的 XML 只包含一个根元素。

当执行一个包含 XMLAGG 的查询时，BINARY、LONG BINARY、IMAGE 和 VARBINARY 列中的数据将被自动以 base64 编码格式返回。

有关使用带有 ORDER BY 子句的 XMLAGG 函数的查询示例，请参见使用 XMLAGG 函数。

使用 XMLAGG 函数

SQL/2008 XMLAGG 是可选 SQL/2008 语言功能 X034 的一部分。XMLAGG 函数的可选 ORDER BY 子句是可选 SQL/2008 语言功能 X035 的一部分。

以下示例生成了显示每个客户所发出的订单的 XML 文档。

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 GROUPO.SalesOrders so
ORDER BY so.ID;

XMLAGG 函数 [Aggregate]

语法

参数

返回值

注释

另请参见

标准和兼容性

示例