FLWOR 陳述式與反覆運算 (XQuery)

使用 let 子句

您可以使用 let 子句命名您可以藉由參考此變數來參考的重複運算式。請注意在 SQL Server 2008 中，每次在查詢中參考 let 變數時，指派給此變數的運算式都會插入此查詢中。這表示陳述式將不會只執行一次，而是在每次參考運算式時都執行。

在 AdventureWorks 資料庫中，製造指示包含有關所需的工具及工具之使用位置的資訊。下列查詢會使用 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 子句篩選反覆運算的結果。在下一個範例中使用 AdventureWorks 範例資料庫來說明此用法。

在製造腳踏車時，製造程序將經過一系列的工作中心位置。每個工作中心位置都會定義一系列的製造步驟。下列查詢只會擷取那些製造腳踏車型號以及少於三個製造步驟的工作中心位置。也就是，它們少於三個 <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

下列為上一個查詢的注意事項：

• where 關鍵字使用 count() 函數以計數在每個工作中心位置中的 <step> 子元素數目。

• return 運算式可從反覆運算的結果建構 XML。

以下是結果：

<Location LocationID="30"/> 

在 where 子句中的運算式結果將依指定順序使用下列規則轉換成布林值。這些規則與在路徑運算式中的述詞規則相同，除了不允許整數以外：

1. 如果 where 運算式傳回空白時序，其有效的布林值為 False。

2. 如果 where 運算式傳回一個簡單的布林類型值，該值為有效的布林值。

3. 如果 where 運算式傳回包含至少一個節點的時序，有效的布林值則為 True。

4. 否則，就會引發靜態錯誤。

在 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]，與 $Loc 值相依的 $FirstStep 值相互關聯。

• 與 $Loc 關聯的運算式會產生 <Location> 元素的序列。對於每個 <Location> 元素而言，$FirstStep 會產生一個 <Step> 元素之序列，即單一。

• 在運算式中指定的 $Loc 與 $FirstStep 變數關聯。

結果如下：

Manu step 1 at Loc 1 
Manu step 1 at Loc 2

下列是類似的查詢，除了它是針對 ProductModel 資料表的 Instructions 資料行 (具類型的 xml 資料行) 所指定。XML 建構 (XQuery) 是用以產生所需的 XML。

SELECT Instructions.query('
     declare default 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 中的每個工作中心位置產生步驟的序列。

• 傳回陳述式會建構具有 <Step> 元素的 XML，該元素包含製造步驟以及做為其屬性的 LocationID。

• 宣告預設的元素命名空間是在 XQuery 初構中使用，這樣在產生的 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>
...

使用依子句排序的順序

使用 FLWOR 運算式中的 order by 子句來執行 XQuery 中的排序。傳遞給 order by 子句的排序運算式必須傳回對 gt 運算子有效的類型值。每個排序運算式必須一個項目產生一個序列。依預設，會以遞增順序執行順序。您可以為每個排序運算式選擇性地指定遞增或遞減順序。

下列查詢會從 AdditionalContactInfo 資料行擷取特定客戶的所有電話號碼。結果將依電話號碼進行排序。

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.Contact
WHERE ContactID=3

請注意自動化 (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 來宣告前置詞，而不是在查詢初構中宣告命名空間。

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.Contact
WHERE ContactID=3

您也可以依屬性值進行排序。例如，下列查詢會擷取新建立的 <Location> 元素，它包含依 LaborHours 屬性的遞減順序排序的 LocationID 與 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" />

實作限制

請參閱

概念