人大金仓数据库KingbaseES 兼容Oracle包dbms_xmlgen的重新启动查询功能

金仓数据库KingbaseES 兼容Oracle包dbms_xmlgen的重新启动查询功能

关键字：

KingbaseES、xml、dbms_xmlgen、xmlgen、人大金仓、KingbaseES

重新启动查询功能概述

兼容Oracle包dbms_xmlgen的功能是将SQL查询结果转化为XML文档。如果只是需要将SQL查询结果的内容转化为XML文档，可以直接使用GETXML或GETXMLTYPE函数进行转换，向其中一个函数输入查询字符串即可。如果想要对转换的XML文档的标签或空值等属性进行设置，就需要使用dbms_xmlgen包中的newcontext函数创建一个上下文句柄，上下文句柄可以关联查询语句，提取查询结果。通过上下文句柄与各种属性相互关联，就可以完成对XML文档的各种设置。

在dbms_xmlgen包中，重新启动查询功能通过restartQuery过程来实现。与标签设置相同，restartQuery过程也是通过上下文句柄来完成，语法如下：

procedure restartQuery(ctx in out ctxHandle);

dbms_xmlgen包生成XML文档的原理是每调用一次GETXML或GETXMLTYPE函数，生成一次XML文档。由于可能设置一次处理的行数，因此，每次获取的XML文档可能由所有的SQL查询结果转化，也可能只是SQL查询结果的一部分转化的结果。如果用户获取到一半或想重新获取XML文档，restartQuery过程给用户提供了一个接口，调用该过程，用户可以重新从第一行启动查询，从头获取XML文档。

值得注意的是，如果用户发现在获取XML文档的过程中，表格的数据有遗漏，想更新表格的数据，只是在表格中更新，更新的数据不会反映在XML文档，需要重新启动查询。restartQuery过程的重新启动查询功能，可以将更新的数据显示在文档中。

二、 使用示例

在下面的示例中，使用的数据如下所示。表格test1用于查询，其中的查询结果用于转化为XML文档。表格xml_test用于存放生成的XML文档。dbms_xmlgen包依赖于kdb_xmltype插件，因此，在创建dbms_xmlgen包之前，还需要创建kdb_xmltype插件。

create extension kdb_xmltype;

create extension dbms_xmlgen;

create table test1 (id int, name text);

create table xml_test (result xmltype);

insert into test1 values(1, 'aaa'), (2, 'bbb'), (3, NULL);

（1）使用setmaxrows过程设置每次处理的行数最大为一行，重新启动查询。

set serveroutput on

\set SQLTERM /

declare

lcontext dbms_xmlgen.ctxhandle;

lxmldata CLOB;

begin

lcontext := dbms_xmlgen.newcontext('select * from test1');

dbms_xmlgen.setmaxrows(lcontext,1);

lxmldata := dbms_xmlgen.getxml(lcontext, 0);

dbms_output.put_line(lxmldata);

dbms_xmlgen.restartquery(lcontext);

lxmldata := dbms_xmlgen.getxml(lcontext, 0);

dbms_output.put_line(lxmldata);

dbms_xmlgen.closecontext(lcontext);

end;

/

<?xml version = "1.0"?>

<rowset>

<row>

<id>1</id>

<name>aaa</name>

</row>

</rowset>

<?xml version = "1.0"?>

<rowset>

<row>

<id>1</id>

<name>aaa</name>

</row>

</rowset>

(2 rows)

（2）使用setmaxrows过程设置每次处理的行数最大为一行，不重新启动查询。

set serveroutput on

\set SQLTERM /

declare

lcontext dbms_xmlgen.ctxhandle;

lxmldata CLOB;

begin

lcontext := dbms_xmlgen.newcontext('select * from test1');

dbms_xmlgen.setmaxrows(lcontext,1);

lxmldata := dbms_xmlgen.getxml(lcontext, 0);

dbms_output.put_line(lxmldata);

lxmldata := dbms_xmlgen.getxml(lcontext, 0);

dbms_output.put_line(lxmldata);

dbms_xmlgen.closecontext(lcontext);

end;

/

<?xml version = "1.0"?>

<rowset>

<row>

<id>1</id>

<name>aaa</name>

</row>

</rowset>

<?xml version = "1.0"?>

<rowset>

<row>

<id>2</id>

<name>bbb</name>

</row>

</rowset>

(2 rows)

（3）使用setmaxrows过程设置每次处理的行数最大为一行，两次查询后，重新启动查询，查询还是会回到第一次查询开始的地方。

set serveroutput on

\set SQLTERM /

declare

lcontext dbms_xmlgen.ctxhandle;

lxmldata CLOB;

begin

lcontext := dbms_xmlgen.newcontext('select * from test1');

dbms_xmlgen.setmaxrows(lcontext,1);

lxmldata := dbms_xmlgen.getxml(lcontext, 0);

dbms_output.put_line(lxmldata);

lxmldata := dbms_xmlgen.getxml(lcontext, 0);

dbms_output.put_line(lxmldata);

dbms_xmlgen.restartquery(lcontext);

lxmldata := dbms_xmlgen.getxml(lcontext, 0);

dbms_output.put_line(lxmldata);

dbms_xmlgen.closecontext(lcontext);

end;

/

<?xml version = "1.0"?>

<rowset>

<row>

<id>1</id>

<name>aaa</name>

</row>

</rowset>

<?xml version = "1.0"?>+

<rowset>

<row>

<id>2</id>

<name>bbb</name>

</row>

</rowset>

<?xml version = "1.0"?>

<rowset>

<row>

<id>1</id>

<name>aaa</name>

</row>

</rowset>

(3 rows)

（4）如果查询过后，设置了需要跳过的行数, 再次查询会从跳过行数的下一行开始。

set serveroutput on

\set SQLTERM /

declare

lcontext dbms_xmlgen.ctxhandle;

lxmldata CLOB;

begin

lcontext := dbms_xmlgen.newcontext('select * from test1');

dbms_xmlgen.setmaxrows(lcontext,1);

lxmldata := dbms_xmlgen.getxml(lcontext, 0);

dbms_output.put_line(lxmldata);

dbms_xmlgen.setskiprows(lcontext,1);

dbms_xmlgen.restartquery(lcontext);

lxmldata := dbms_xmlgen.getxml(lcontext, 0);

dbms_output.put_line(lxmldata);

dbms_xmlgen.closecontext(lcontext);

end;

/

<?xml version = "1.0"?>

<rowset>

<row>

<id>1</id>

<name>aaa</name>

</row>

</rowset>

<?xml version = "1.0"?>

<rowset>

<row>

<id>2</id>

<name>bbb</name>

</row>

</rowset>

(2 rows)

（5）在查询的过程中，表格数据有更新，重新启动查询后，更新的数据会显示在XML文档中。

set serveroutput on

\set SQLTERM /

declare

lcontext dbms_xmlgen.ctxhandle;

lxmldata xmltype;

begin

lcontext := dbms_xmlgen.newcontext('select * from test1');

lxmldata := dbms_xmlgen.getxmltype(lcontext, 0);

insert into test1 values(5, 'sss');

insert into xml_test values(lxmldata);

dbms_xmlgen.restartquery(lcontext);

lxmldata := dbms_xmlgen.getxmltype(lcontext, 0);

insert into xml_test values(lxmldata);

dbms_xmlgen.closecontext(lcontext);

end;

/

select * from xml_test;

/

result

--------------------

<rowset> +

<row> +

<id>1</id> +

<name>aaa</name>+

</row> +

<row> +

<id>2</id> +

<name>bbb</name>+

</row> +

<row> +

<id>3</id> +

</row> +

</rowset> +

<rowset> +

<row> +

<id>1</id> +

<name>aaa</name>+

</row> +

<row> +

<id>2</id> +

<name>bbb</name>+

</row> +

<row> +

<id>3</id> +

</row> +

<row> +

<id>5</id> +

<name>sss</name>+

</row> +

</rowset> +

(2 rows)