FLWOR 语句和迭代 (XQuery)
适用于：
SQL Server
XQuery 定义了 FLWOR 迭代语法。 FLWOR 是 for、let、where、order by 和 return 的缩写词。
FLWOR 语句由以下几个部分组成：
用于将一个或多个迭代器变量绑定到输入序列的一个或多个 FOR 子句。
输入序列可以是其他 XQuery 表达式，例如 XPath 表达式。 它们既可以是节点序列也可以是原子值序列。 原子值序列可以使用文字或构造函数来构造。 在SQL Server中，不允许将构造的 XML 节点作为输入序列。
可选的
let子句。 该子句将一个值分配给用于特定迭代的给定变量。 分配的表达式可以为 XQuery 表达式（如 XPath 表达式），并可返回一个节点序列或一个原子值序列。 原子值序列可以通过使用文字或构造函数来构造。 在SQL Server中，不允许将构造的 XML 节点作为输入序列。迭代器变量。 通过使用
as关键字，此变量可包含一个可选的类型判断。可选的
where子句。 此子句将对迭代应用筛选谓词。可选的
order by子句。return表达式。return子句中的表达式用于构造 FLWOR 语句的结果。
例如，以下查询循环访问第一个制造位置的 <Step> 元素，并返回节点的 <Step> 字符串值：
declare @x xml
set @x='<ManuInstructions ProductModelID="1" ProductModelName="SomeBike" >
<Location LocationID="L1" >
<Step>Manu step 1 at Loc 1</Step>
<Step>Manu step 2 at Loc 1</Step>
<Step>Manu step 3 at Loc 1</Step>
</Location>
<Location LocationID="L2" >
<Step>Manu step 1 at Loc 2</Step>
<Step>Manu step 2 at Loc 2</Step>
<Step>Manu step 3 at Loc 2</Step>
</Location>
</ManuInstructions>'
SELECT @x.query('
for $step in /ManuInstructions/Location[1]/Step
return string($step)
')
结果如下：
Manu step 1 at Loc 1 Manu step 2 at Loc 1 Manu step 3 at Loc 1
以下查询与上一个查询相似，只不过它是针对 ProductModel 表中的 Instructions 列（类型化的 xml 列）指定的。 该查询循环访问特定产品的第一个工作中心位置的所有制造步骤、 <step> 元素。
SELECT Instructions.query('
declare namespace AWMI="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelManuInstructions";
for $Step in //AWMI:root/AWMI:Location[1]/AWMI:step
return
string($Step)
') as Result
FROM Production.ProductModel
where ProductModelID=7
请注意上述查询的以下方面：
$Step是迭代器变量。路径表达式
//AWMI:root/AWMI:Location[1]/AWMI:step生成输入序列。 此序列是第一个元素节点的 <step> 元素节点子级的 <Location> 序列。不使用可选的谓词子句
where。表达式
return从 <step> 元素返回字符串值。
XQuery) (字符串函数用于检索节点的<step>字符串值。
下面是部分结果：
Insert aluminum sheet MS-2341 into the T-85A framing tool.
Attach Trim Jig TJ-26 to the upper and lower right corners of
the aluminum sheet. ....
以下是其他允许使用的输入序列的示例：
declare @x xml
set @x=''
SELECT @x.query('
for $a in (1, 2, 3)
return $a')
-- result = 1 2 3
declare @x xml
set @x=''
SELECT @x.query('
for $a in
for $b in (1, 2, 3)
return $b
return $a')
-- result = 1 2 3
declare @x xml
set @x='<ROOT><a>111</a></ROOT>'
SELECT @x.query('
for $a in (xs:string( "test"), xs:double( "12" ), data(/ROOT/a ))
return $a')
-- result test 12 111
在 SQL Server 中，不允许使用异类序列。 尤其不允许使用由原子值和节点混合组成的序列。
在转换 XML 格式时，迭代经常与 XML 构造 语法一起使用，如下一个查询所示。
在 AdventureWorks 示例数据库中，存储在 Production.ProductModel 表的“说明”列中的制造说明具有以下形式：
<Location LocationID="10" LaborHours="1.2"
SetupHours=".2" MachineHours=".1">
<step>describes 1st manu step</step>
<step>describes 2nd manu step</step>
...
</Location>
...
以下查询构造具有作为子元素返回的工作中心位置属性的元素的新 XML <Location> ：
<Location>
<LocationID>10</LocationID>
<LaborHours>1.2</LaborHours>
<SetupHours>.2</SetupHours>
<MachineHours>.1</MachineHours>
</Location>
...
以下是查询语句：
SELECT Instructions.query('
declare namespace AWMI="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelManuInstructions";
for $WC in /AWMI:root/AWMI:Location
return
<Location>
<LocationID> { data($WC/@LocationID) } </LocationID>
<LaborHours> { data($WC/@LaborHours) } </LaborHours>
<SetupHours> { data($WC/@SetupHours) } </SetupHours>
<MachineHours> { data($WC/@MachineHours) } </MachineHours>
</Location>
') as Result
FROM Production.ProductModel
where ProductModelID=7
请注意上述查询的以下方面：
FLWOR 语句检索特定产品的元素序列 <
Location> 。(XQuery) 的数据函数用于提取每个属性的值，以便它们将作为文本节点而不是属性添加到生成的 XML 中。
RETURN 子句中的表达式将构造所需的 XML。
这是部分结果：
<Location>
<LocationID>10</LocationID>
<LaborHours>2.5</LaborHours>
<SetupHours>0.5</SetupHours>
<MachineHours>3</MachineHours>
</Location>
<Location>
...
<Location>
...
使用 let 子句
可以使用 let 子句来命名可通过引用变量来引用的重复表达式。 每次在查询中引用 let 变量时，都会将分配给该变量的表达式插入到查询中。 也就是说，引用该表达式多少次，就执行多少次此语句。
在 AdventureWorks2022 数据库中，生产说明包含有关所需的工具以及在何处使用这些工具的信息。 以下查询使用 let 子句列出构建生产模型所需的工具以及各工具的使用位置。
SELECT Instructions.query('
declare namespace AWMI="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelManuInstructions";
for $T in //AWMI:tool
let $L := //AWMI:Location[.//AWMI:tool[.=data($T)]]
return
<tool desc="{data($T)}" Locations="{data($L/@LocationID)}"/>
') as Result
FROM Production.ProductModel
where ProductModelID=7
使用 where 子句
可以使用 where 子句筛选迭代结果。 下面的示例说明了这一点。
在生产自行车时，生产过程经过了一系列生产车间。 每个生产车间定义一个生产步骤序列。 以下查询仅检索那些生产某个自行车型号并且生产步骤少于三步的生产车间。 也就是说，它们的元素少于三个 <step> 。
SELECT Instructions.query('
declare namespace AWMI="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelManuInstructions";
for $WC in /AWMI:root/AWMI:Location
where count($WC/AWMI:step) < 3
return
<Location >
{ $WC/@LocationID }
</Location>
') as Result
FROM Production.ProductModel
where ProductModelID=7
请注意上述查询的以下方面：
关键字 (keyword)
where使用 count () 函数对每个工作中心位置的子元素数<step>进行计数。return表达式将构造您希望从迭代结果生成的 XML。
结果如下：
<Location LocationID="30"/>
where 子句中的表达式的结果使用下列规则按指定的顺序转换为布尔值。 这些规则与路径表达式中的谓词规则相同，只不过不允许使用整数：
如果
where表达式返回一个空序列，则其有效的布尔值为 False。如果
where表达式返回一个简单的布尔类型值，则该值为有效的布尔值。如果
where表达式返回至少包含一个节点的序列，则有效的布尔值为 True。否则，它将出现静态错误。
FLWOR 中的多个变量绑定
可以用单个 FLWOR 表达式将多个变量绑定到输入序列。 在下面的示例中，查询针对非类型化的 xml 变量指定。 FLOWR 表达式返回每个<Location>元素中的第一个<Step>元素子元素。
declare @x xml
set @x='<ManuInstructions ProductModelID="1" ProductModelName="SomeBike" >
<Location LocationID="L1" >
<Step>Manu step 1 at Loc 1</Step>
<Step>Manu step 2 at Loc 1</Step>
<Step>Manu step 3 at Loc 1</Step>
</Location>
<Location LocationID="L2" >
<Step>Manu step 1 at Loc 2</Step>
<Step>Manu step 2 at Loc 2</Step>
<Step>Manu step 3 at Loc 2</Step>
</Location>
</ManuInstructions>'
SELECT @x.query('
for $Loc in /ManuInstructions/Location,
$FirstStep in $Loc/Step[1]
return
string($FirstStep)
')
请注意上述查询的以下方面：
表达式
for定义$Loc和 $FirstStep变量。two和/ManuInstructions/Location$FirstStep in $Loc/Step[1]表达式相互关联，$FirstStep的值取决于$Loc的值。与 关联的
$Loc表达式生成元素序列Location<>。 对于每个 <Location> 元素，$FirstStep生成一个 <Step> 元素序列，即一个单一实例。$Loc在与$FirstStep变量相关联的表达式中指定。
结果如下：
Manu step 1 at Loc 1
Manu step 1 at Loc 2
以下查询类似，只不过它是针对 ProductModel 表的“说明”列类型化 xml 列指定的。 XML 构造 (XQuery) 用于生成所需的 XML。
SELECT Instructions.query('
declare default element namespace "https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelManuInstructions";
for $WC in /root/Location,
$S in $WC/step
return
<Step LocationID= "{$WC/@LocationID }" >
{ $S/node() }
</Step>
') as Result
FROM Production.ProductModel
WHERE ProductModelID=7
请注意上述查询的以下方面：
for子句定义了两个变量：$WC和$S。 在生产某个自行车产品型号时，与$WC相关联的表达式将生成一系列生产车间。 分配给$S变量的路径表达式将为$WC中的每个生产车间序列生成一个相应的步骤序列。return 语句构造 XML，该 XML 具有一个 <
Step> 包含制造步骤的元素，并将 LocationID 作为其属性。声明默认元素命名空间在 XQuery prolog 中使用，以便生成的 XML 中的所有命名空间声明都显示在顶级元素中。 这使结果的可读性更强。 有关默认命名空间的详细信息，请参阅 处理 XQuery 中的命名空间。
下面是部分结果：
<Step xmlns=
"https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelManuInstructions"
LocationID="10">
Insert <material>aluminum sheet MS-2341</material> into the <tool>T-
85A framing tool</tool>.
</Step>
...
<Step xmlns=
"https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelManuInstructions"
LocationID="20">
Assemble all frame components following blueprint
<blueprint>1299</blueprint>.
</Step>
...
使用 order by 子句
通过使用 FLWOR 表达式中的 order by 子句可在 XQuery 中进行排序。 传递给 子句的 order by 排序表达式必须返回其类型对 gt 运算符有效的值。 每个排序表达式必须针对每一项生成一个单独的序列。 默认情况下，按升序进行排序。 您也可以选择为每个排序表达式指定升序或降序顺序。
注意
SQL Server中 XQuery 实现执行的字符串值的排序比较始终使用二进制 Unicode 代码点排序规则来执行。
以下查询将从 AdditionalContactInfo 列检索有关特定客户的所有电话号码。 结果按电话号码进行排序。
USE AdventureWorks2022;
GO
SELECT AdditionalContactInfo.query('
declare namespace act="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ContactTypes";
declare namespace aci="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ContactInfo";
for $a in /aci:AdditionalContactInfo//act:telephoneNumber
order by $a/act:number[1] descending
return $a
') As Result
FROM Person.Person
WHERE BusinessEntityID=291;
请注意，原子化 (XQuery) 进程先检索元素的<number>原子值，然后再将其传递给 。order by 可以使用 data () 函数编写表达式，但这不是必需的。
order by data($a/act:number[1]) descending
结果如下：
<act:telephoneNumber xmlns:act="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ContactTypes">
<act:number>333-333-3334</act:number>
</act:telephoneNumber>
<act:telephoneNumber xmlns:act="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ContactTypes">
<act:number>333-333-3333</act:number>
</act:telephoneNumber>
可以使用 WITH XMLNAMESPACES 声明命名空间，而不是在查询 prolog 中声明。
WITH XMLNAMESPACES (
'https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ContactTypes' AS act,
'https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ContactInfo' AS aci)
SELECT AdditionalContactInfo.query('
for $a in /aci:AdditionalContactInfo//act:telephoneNumber
order by $a/act:number[1] descending
return $a
') As Result
FROM Person.Person
WHERE BusinessEntityID=291;
还可以按属性值进行排序。 例如，以下查询检索新创建的 <Location> 元素，这些元素的 LocationID 和 LaborHours 属性按 LaborHours 属性降序排序。 结果，将首先返回工时最长的生产车间。
SELECT Instructions.query('
declare namespace AWMI="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelManuInstructions";
for $WC in /AWMI:root/AWMI:Location
order by $WC/@LaborHours descending
return
<Location>
{ $WC/@LocationID }
{ $WC/@LaborHours }
</Location>
') as Result
FROM Production.ProductModel
WHERE ProductModelID=7;
结果如下：
<Location LocationID="60" LaborHours="4"/>
<Location LocationID="50" LaborHours="3"/>
<Location LocationID="10" LaborHours="2.5"/>
<Location LocationID="20" LaborHours="1.75"/>
<Location LocationID="30" LaborHours="1"/>
<Location LocationID="45" LaborHours=".5"/>
在以下查询中，将按元素名称对结果进行排序。 此查询将从产品目录中检索特定产品的规范。 规范是 元素的子级 <Specifications> 。
SELECT CatalogDescription.query('
declare namespace
pd="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription";
for $a in /pd:ProductDescription/pd:Specifications/*
order by local-name($a)
return $a
') as Result
FROM Production.ProductModel
where ProductModelID=19;
请注意上述查询的以下方面：
表达式
/p1:ProductDescription/p1:Specifications/*返回 的元素子级Specifications<>。order by (local-name($a))表达式将按元素名称的本地部分对序列进行排序。
结果如下：
<Color>Available in most colors</Color>
<Material>Almuminum Alloy</Material>
<ProductLine>Mountain bike</ProductLine>
<RiderExperience>Advanced to Professional riders</RiderExperience>
<Style>Unisex</Style>
其排序表达式返回空值的节点将被列在序列的开头，如以下示例中所示：
declare @x xml
set @x='<root>
<Person Name="A" />
<Person />
<Person Name="B" />
</root>
'
select @x.query('
for $person in //Person
order by $person/@Name
return $person
')
结果如下：
<Person />
<Person Name="A" />
<Person Name="B" />
您可以指定多个排序条件，如以下示例中所示。 此示例中的查询先按 Title 对元素进行排序，然后按 Administrator 属性值排序 <Employee> 。
declare @x xml
set @x='<root>
<Employee ID="10" Title="Teacher" Gender="M" />
<Employee ID="15" Title="Teacher" Gender="F" />
<Employee ID="5" Title="Teacher" Gender="M" />
<Employee ID="11" Title="Teacher" Gender="F" />
<Employee ID="8" Title="Administrator" Gender="M" />
<Employee ID="4" Title="Administrator" Gender="F" />
<Employee ID="3" Title="Teacher" Gender="F" />
<Employee ID="125" Title="Administrator" Gender="F" /></root>'
SELECT @x.query('for $e in /root/Employee
order by $e/@Title ascending, $e/@Gender descending
return
$e
')
结果如下：
<Employee ID="8" Title="Administrator" Gender="M" />
<Employee ID="4" Title="Administrator" Gender="F" />
<Employee ID="125" Title="Administrator" Gender="F" />
<Employee ID="10" Title="Teacher" Gender="M" />
<Employee ID="5" Title="Teacher" Gender="M" />
<Employee ID="11" Title="Teacher" Gender="F" />
<Employee ID="15" Title="Teacher" Gender="F" />
<Employee ID="3" Title="Teacher" Gender="F" />
实现限制
限制如下：
排序表达式必须经过同类类型化。 这是通过静态检查来确定的。
无法控制对空序列的排序。
不支持对
order by使用 empty least、empty greatest 和 collation 关键字
另请参阅
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈