XMLELEMENT - OceanBase 数据库 V4.5.0

XMLELEMENT

更新时间：2026-03-13 18:23:19

描述

该函数生成具有指定名称、属性和内容的 XML 元素。

语法

XMLELEMENT ( [ ENTITYESCAPING | NOENTITYESCAPING ]
   { ( [ NAME ] identifier ) | ( EVALNAME value_expr ) }
   [ , XML_attributes_clause ]
   [ , value_expr [ [ AS ] c_alias ]]...
 )

参数解释

字段	说明
ENTITYESCAPING \| NOENTITYESCAPING	可选项，指定元素的名字和内容是否需要强制转译的关键字。建议直接使用表达式默认的行为`ENTITYESCAPING`。
NAME	指定根元素名称为文字标识符的关键字，`NAME` 表示其后面的值就是标识符，为可选项。
EVALNAME	指定根元素名称是计算结果为字符串的关键字。`EVALNAME` 表示其后面的值需要经过计算获取结果。
identifier	指定字符串类型的标签名。
value_expr	元素值表达式。该参数可以是其他元素也可以是文本。如果是其他元素，可以是 XMLType 列或者 `XMLELEMENT`、`XMLAGG` 等生成 XMLType 的表达式。
XML_attributes_clause	可选项，指定元素属性的表达式，具体信息参见 XMLATTRIBUTES。
c_alias	指定内容别名的字符串类型。

返回类型

返回 XMLType 数据类型。

示例

如下示例为构建一个元素名称为 Emp，元素内容为value 的 XML 元素。

obclient> SELECT XMLELEMENT(NAME "Emp", 'value') FROM DUAL;
+-------------------------------+
| XMLELEMENT(NAME"EMP",'VALUE') |
+-------------------------------+
| <Emp>value</Emp>
             |
+-------------------------------+
1 row in set