KingbaseES 原生XML系列四--XML通用函数

KingbaseES 原生XML系列四--XML通用函数(XMLAGG,XMLCOMMENT,XMLCONCAT,XMLELEMENT,XMLFOREST,XMLPI,XMLROOT,XMLSEQUENCE)

XML的简单使其易于在任何应用程序中读写数据，这使XML很快成为数据交换的一种公共语言。在不同平台下产生的信息，可以很容易加载XML数据到程序中并分析他，并以XML格式输出结果。

xml数据类型可以被用来存储XML数据。它比直接在一个text域中存储XML数据的优势在于，它会检查输入值的结构是不是良好，并且有支持函数用于在其上执行类型安全的操作。

本文详细介绍了KingbaseES中集成的相关xml通用函数使用。

准备数据：

CREATE TABLE "public"."xmldata" (
    "id" integer NULL,
    "comm" varchar NULL,
    "xmlvarchar" varchar NULL,
    "xmldata" xml NULL,
    "XMLarray" xml NULL
);

INSERT INTO xmldata values(1, 'zhangsan' , '<kes>aaa</kes>' , '<kes><sql>sql001</sql><rac>rac001</rac></kes>' , '<kes><version>v8r3001</version><version>v8r6001</version></kes>');
INSERT INTO xmldata values(2, 'lisi' , '<kes>bbb</kes>' , '<kes><sql>sql002</sql><rac>rac002</rac></kes>' , '<kes><version>v8r3002</version><version>v8r6002</version></kes>');
INSERT INTO xmldata values(3, 'wangwu' , '<kes>ccc</kes>' , '<kes><sql>sql003</sql><rac>rac003</rac></kes>' , '<kes><version>v8r3003</version><version>v8r6003</version></kes>');

xml函数列表

• XMLAGG
• XMLCOMMENT
• XMLCONCAT
• XMLELEMENT
• XMLFOREST
• XMLPI
• XMLROOT
• XMLSEQUENCE

json函数简介

XMLAGG

功能：

函数xmlagg是一个聚集函数。它将聚集函数调用的输入值串接起来

用法：

xmlagg(xml)

示例：

test=# select xmlagg(xmlvarchar) from xmldata ;
                   xmlagg
--------------------------------------------
 <kes>aaa</kes><kes>bbb</kes><kes>ccc</kes>
(1 行记录)

XMLCOMMENT

功能：

XMLComment使用 的评估结果生成 XML 注释value_expr。

用法：

XMLCOMMENT(values_expr)

示例：

test=# select xmlcomment('doc') from dual ;
 xmlcomment
------------
 <!--doc-->
(1 行记录)

XMLCONCAT

功能：

XMLConcat将一系列XMLType实例作为输入，连接每一行的一系列元素，并返回连接后的系列。

用法：

XMLCONCAT(XMLType_instance [,...])

示例：

test=# select xmlconcat(xmlvarchar , xmldata) from xmldata ;
                          xmlconcat
-------------------------------------------------------------
 <kes>aaa</kes><kes><sql>sql001</sql><rac>rac001</rac></kes>
 <kes>bbb</kes><kes><sql>sql002</sql><rac>rac002</rac></kes>
 <kes>ccc</kes><kes><sql>sql003</sql><rac>rac003</rac></kes>
(3 行记录)

XMLELEMENT

功能：

XMLElement获取元素名称identifier或评估元素名称EVALNAME value_expr、元素的可选属性集合以及构成元素内容的参数。它返回一个类型的实例XMLType。

用法：

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

XML_attributes_clause:
XML_ATTRIBUTES( [{ENTITYESCAPING|NOENTITYESCAPING}] [{SCHEMACHECK|NOSCHEMACHECK}] value [{[AS] c_alias| AS EVALINAME value_expr}] )

示例：

test=# select xmlelement(name comm, id) from xmldata ;
   xmlelement
----------------
 <comm>1</comm>
 <comm>2</comm>
 <comm>3</comm>
(3 行记录)

test=# select xmlelement(name item , xmlattributes(comm as test)) from xmldata ;
       xmlelement
-------------------------
 <item test="zhangsan"/>
 <item test="lisi"/>
 <item test="wangwu"/>
(3 行记录)

XMLEXISTS

功能：

XMLExists检查给定 XQuery 表达式是否返回非空 XQuery 序列。

用法：

XMLEXISTS(XQuery_string [XML_passing_clause])

XML_passing_clause:

    PASSING [BY VALUE ] expr [AS identifier] [, ... ]

示例：

test=# SELECT xmlexists('/kes[text() = ''aaa'']' PASSING BY VALUE xmlvarchar) ,xmlvarchar from xmldata ;
 xmlexists |   xmlvarchar
-----------+----------------
 t         | <kes>aaa</kes>
 f         | <kes>bbb</kes>
 f         | <kes>ccc</kes>
(3 行记录)

test=# SELECT xmlexists('/kes/sql' PASSING BY VALUE xmldata) ,xmldata from xmldata;
 xmlexists |                    xmldata
-----------+-----------------------------------------------
 t         | <kes><sql>sql001</sql><rac>rac001</rac></kes>
 t         | <kes><sql>sql002</sql><rac>rac002</rac></kes>
 t         | <kes><sql>sql003</sql><rac>rac003</rac></kes>
(3 行记录)

XMLFOREST

功能：

XMLForest将其每个参数参数转换为 XML，然后返回一个 XML 片段，该片段是这些转换后的参数的串联。

用法：

XMLFOREST(value_expr [as {c_alias|EVALINAME value_expr]}][,...])

示例：

test=# select XMLFOREST( id , comm) from xmldata ;
            xmlforest
---------------------------------
 <id>1</id><comm>zhangsan</comm>
 <id>2</id><comm>lisi</comm>
 <id>3</id><comm>wangwu</comm>
(3 行记录)

XMLPI

功能：

XMLPIidentifier使用和可选的评估结果生成 XML 处理指令value_expr。

用法：

XMLPI({[NAME]idenfitier|EVALNAME value_expr} [, value_expr])

示例：

test=# select xmlpi(name id , comm) from xmldata ;
      xmlpi
-----------------
 <?id zhangsan?>
 <?id lisi?>
 <?id wangwu?>
(3 行记录)

XMLROOT

功能：

XMLROOT允许您通过在现有 XML 值的 XML 根信息 (prolog) 中提供版本和独立属性来创建新的 XML 值。

用法：

XMLROOT(value_expr,VERSION {value_expr| NO VALUE} [,STANDALONE {YES|NO|NO VALUE}])

示例：

test=# SELECT XMLROOT (xmlvarchar, VERSION '1.0', STANDALONE YES) AS "XMLROOT" FROM xmldata;
                       XMLROOT
------------------------------------------------------
 <?xml version="1.0" standalone="yes"?><kes>aaa</kes>
 <?xml version="1.0" standalone="yes"?><kes>bbb</kes>
 <?xml version="1.0" standalone="yes"?><kes>ccc</kes>
(3 行记录)

XMLSEQUENCE

功能：

XMLSEQUENCE函数接受一个xml类型的XML实例，返回一个包含所有顶层XML节点的可变数组。

只能在oracle模式下

用法：

XMLSEQUENCE(xml_instance xml)

示例：

test=# select t.* from xmldata ,table(xmlsequence(extract(xmldata,'/kes/*'))) t ;
     xml_data
-------------------
 <sql>sql001</sql>
 <rac>rac001</rac>
 <sql>sql002</sql>
 <rac>rac002</rac>
 <sql>sql003</sql>
 <rac>rac003</rac>
(6 行记录)