文章
姚 鑫 · 六月 2 阅读大约需 4 分钟

第160章 SQL函数 XMLFOREST

第160章 SQL函数 XMLFOREST

格式化多个 XML 标记以包含表达式值的函数。

大纲

XMLFOREST(expression [AS tag][,expression [AS tag]])

参数

  • expression - 任何有效的表达式。通常是包含要标记的数据值的列的名称。当指定为逗号分隔列表时,列表中的每个表达式都将包含在其自己的 XML 标记标记中。
  • AS tag - 可选 — XML 标记标记的名称。如果指定了标签,则 AS 关键字是必需的。保留标签中字母的大小写。
    用双引号括起来的标签是可选的。如果省略双引号,标签必须遵循 XML 命名标准。用双引号括起来的标签消除了这些命名限制。

XMLFOREST 对有效的标签名称实施 XML 命名标准。它不能包含任何字符!"#$%&'()*+,/;<=>?@[\]^``{|}~,也不能包含空格字符,并且不能以 "-", ".", 或数字。

如果指定不带 AS 标记子句的表达式,则标记值是表达式列的名称(大写字母):<HOME_CITY>Chicago</HOME_CITY>

描述

XMLFOREST 函数返回用其自己的 XML 标记开始标记和结束标记标记的每个表达式的值,如 tag 中指定的那样。例如,XMLFOREST(Home_City AS City,Home_State AS State) 返回如下值:<City>Chicago</City><State>IL</State>XMLFOREST 不能用于生成空元素标记。

XMLFOREST 可用于引用表或视图的 SELECT 查询或子查询。 XMLFOREST 可以与普通列值一起出现在 SELECT 列表中。

返回指定的表达式值,由开始标记和结束标记括起来,格式如下:

<tag>value</tag>

通常,表达式是列的名称,或者是包含一个或多个列名称的表达式。表达式可以是任何类型的字段,包括数据流字段。 XMLFOREST 对每个表达式进行如下标记:
- 如果指定了 AS 标记,则 XMLFOREST 用指定的标记标记结果值。标签值区分大小写。
- 如果省略 AS 标记,并且表达式是列名,则 XMLFOREST 用列名标记结果值。列名默认标记始终为大写。
- 如果表达式不是列名(例如,聚合函数、文字或两列的串联),则需要 AS 标记子句。
- 如果表达式是一个流字段,则流值在生成的 XML 值中使用 <![CDATA[...]]>进行转义:

<tag><![CDATA[value]]></tag>

XMLFOREST 为逗号分隔列表中的每个项目提供一个单独的标记。 XMLELEMENT 将逗号分隔列表中的所有项目连接到单个标记中。

XMLFOREST 函数可以嵌套。允许嵌套 XMLFORESTXMLELEMENT 函数的任何组合。可以使用 XMLCONCAT 连接 XMLFOREST 函数。

NULL 值

XMLFOREST 函数仅返回实际数据值的标记。当表达式值为 NULL 时,它不返回标记。例如:

INSERT INTO Sample.Xmltest (f1,f2,f3) values (NULL,'Row 1',NULL)
SELECT XMLFOREST(f1,f2,f3) from Sample.Xmltest 
<F2>Row 1</F2>.

空字符串 ('') 被视为字符串数据类型字段的数据值。如果要标记的 f3 值为空字符串 (''),则 XMLFOREST 返回:

<F3></F3>

XMLFOREST 在处理 NULL 方面与 XMLELEMENT 不同。 XMLELEMENT 始终返回一个标记值,即使字段值为 NULL。因此,XMLELEMENT 不区分 NULL 或空字符串。两者都表示为 <tag></tag>

标点符号值

如果数据值包含 XML/HTML 可能解释为标记或其他编码的标点字符,则 XMLELEMENTXMLFOREST 将此字符转换为相应的编码形式:

  • ampersand (&) 变成 &amp;

  • apostrophe (') 变成 &apos;

  • quotation mark (") 变成 &quot;

  • open angle bracket (<) 变成 &lt;

  • close angle bracket (>) 变成 &gt;

要在提供的文本字符串中表示撇号,请指定两个撇号,如下例所示:'can''t'。列数据不需要加倍撇号。

示例

以下查询将 Sample.Person 中的 Name 列值作为普通数据和 xml 标记数据返回:

SELECT Name,XMLFOREST(Name) AS ExportName
     FROM Sample.Person

返回的数据示例行如下所示。这里的标签默认为列的名称:

Name                    ExportName
Emerson,Molly N.   <NAME>Emerson,Molly N.</NAME>

以下示例指定了多个列:

SELECT XMLFOREST(Home_City,
                 Home_State AS Home_State,
                 AVG(Age) AS AvAge) AS ExportData
FROM Sample.Person

Home_City 字段不指定标签;该标记由所有大写字母的列名生成:<HOME_CITY>Home_State 字段的 AS 子句是可选的。之所以在此处指定,是因为指定标记名称允许您控制标记的大小写:<Home_State>,而不是 <HOME_STATE>;。 AVG(Age) AS子句是强制性的,因为该值是聚合值,而不是列值,因此没有列名。返回的数据示例行如下所示。

ExportData
<HOME_CITY>Chicago</HOME_CITY><Home_State>IL</Home_State>
<AvAge>48.0198019801980198</AvAge>

以下示例返回字符流数据:

SELECT XMLFOREST(name AS Para,Notes AS Para) AS XMLJobHistory
     FROM Sample.Employee

返回的数据示例行如下所示:

XMLJobHistory
<Para>Emerson,Molly N.</Para><Para><![CDATA[Molly worked at DynaMatix Holdings Inc. as a Marketing Manager]]></Para>

以下示例显示了使用子查询值的 XMLFOREST 函数:

SELECT XMLFOREST(Name,DOB,Age,
   (SELECT XMLFOREST(Name,DOB) FROM Sample.Person WHERE %ID=2) AS ExportName)
FROM Sample.Person where %ID=1

返回的数据示例行如下所示:

<NAME>Zahn,Rob F.</NAME><DOB>38405</DOB><AGE>71</AGE><ExportName><NAME>Quinn,Mark N.</NAME><DOB>30999</DOB></ExportName>
0
0 8
讨论 (0)1
登录或注册以继续