Oracle聚合函数XMLAGG详解（史上最全）

---

一、基本介绍

• XMLAGG函数是Oracle数据库中一种特定的聚合函数，主要用于将多行数据转化为一个XML类型的值。通过对多个行数据的拼接，生成XML文档。该函数可以自定义XML文档的结构，实现灵活的数据拼接和文档构建。

二、语法和参数

XMLAGG函数的语法如下：

XMLAGG(XMLELEMENT(name, ...))

XMLELEMENT是一个指定XML元素的函数。该函数需要提供以下两个参数：

• name：指定生成的XML元素名字。
• …：元素中包含的数据，可以是一个或多个值，用逗号分隔。

XMLAGG函数会将所有XML元素的结果以顺序的方式连接成一个XML文档，从而返回一个XML类型的值。

三、使用方法

3.1、拼接字符串

XMLAGG函数可以将多行数据中的指定列拼接成一个字符串。
例如：

SELECT XMLAGG(
           XMLELEMENT(
               e, 
               ename || ','
           ) ORDER BY ename
       ).EXTRACT('//text()') 
       AS names 
  FROM scott.emp;

执行结果：

以上代码实现按照 scott.emp 表中 ename字段排序，将多个ename 拼接成一个字符串，以逗号分隔。

3.2、构建XML文档

XMLAGG函数可以根据需要自定义XML文档的结构。
例如下列的SQL：

SELECT XMLAGG(
           XMLELEMENT(
               "employees", 
               XMLATTRIBUTES(empno AS "empno"), 
               XMLELEMENT("ename", ename), 
               XMLELEMENT("job", job), 
               XMLELEMENT("hiredate", hiredate) 
           ) 
       ) AS "employees"
  FROM scott.emp;

查询结果：

用notepad++的XMLTools插件美化如下：

可以看到生成了xml格式的文本内容。
以上代码使用XMLAGG函数将多行数据中的empno、ename、job、hiredate字段拼接成一个employees元素，生成一个XML文档。

四、相关注意点

4.1、排序

• 如果需要在XML文档中按照指定顺序排列生成的元素，则可以使用ORDER BY子句。例如：

SELECT XMLAGG(
           XMLELEMENT(
               e, 
               ename
           ) ORDER BY ename
       ) 
       AS names 
  FROM scott.emp;

4.2、处理NULL值

• 在使用XMLAGG函数时需要注意空值的处理。如果拼接的字段中含有NULL值，则可能会导致生成的XML文档出现错误。因此应该使用COALESCE函数进行空值的处理。例如：

SELECT XMLAGG(
           XMLELEMENT(
               e, 
               COALESCE(ename, 'N/A')
           ) 
       ) 
       AS ename 
  FROM scott.emp;

以上代码将空值替换成“N/A”，避免了空值引起的错误。

4.3、结尾字符的删除

• XML文档生成后可能会包括一些不需要的结尾字符，例如逗号或空格。可以使用TRIM函数对其进行删除。例如：

SELECT TRIM(BOTH ',' from 
           XMLAGG(
               XMLELEMENT(
                   e, 
                   ename || ','
               ) ORDER BY ename
           ).EXTRACT('//text()')
       )
       AS names 
  FROM scott.emp;

执行结果：

以上代码先使用XMLAGG函数拼接字符串，再使用EXTRACT函数提取文档中的文本内容。然后使用TRIM函数对其进行逗号的删除操作。

五、总结

• XMLAGG函数是Oracle数据库中一种强大的函数，可以用于多行数据的拼接和XML文档的构建。使用时需要注意数据的排序、空值的处理和结尾字符的删除等问题，以确保生成的文档符合要求。