• 發行項

sum 函數 (XQuery)

傳回數字序列的總和。

語法

fn:sum($arg as xdt:anyAtomicType*) as xdt:anyAtomicType

引數

  • $arg
    將計算其總和之不可部份完成值的順序。

備註

傳遞到 sum() 之不可部份完成值的所有類型，必須為相同基底類型的子類型。可接受的基底類型為三個內建的數值基底類型或 xdt:untypedAtomic。xdt:untypedAtomic 類型的值會轉換為 xs:double。如果混合了這些類型，或傳遞了其他類型的其他值，則會引發靜態錯誤。

sum() 的結果會收到所傳入類型的基底類型，例如 xdt:untypedAtomic 的狀況會收到 xs:double，即使輸入為選擇性的空序列也是如此。如果輸入在靜態上是空的，則結果是 0，並具有靜態和動態的 xs:integer 類型。

sum() 函數會傳回數值的總和。如果 xdt:untypedAtomic 值無法轉換為 xs:double，則會忽略輸入序列 $arg 中的這個值。如果輸入是動態計算出的空序列，則會傳回所用基底類型的值 0。

發生溢位或超出範圍的例外狀況時，此函數會傳回執行階段錯誤。

範例

本主題針對儲存在 AdventureWorks 資料庫中之各種 xml 類型資料行的 XML 執行個體，提供 XQuery 範例。如需這些資料行中每個資料行的概觀，請參閱＜在 AdventureWorks 資料庫中的 xml 資料類型表示法＞。

A. 使用 sum() XQuery 函數，尋找製造過程中所有工作中心位置的總合併工時數

下列查詢會尋找有儲存製造指示的所有產品型號之製造過程中，所有工作中心位置的總工時數。

SELECT Instructions.query('       
   declare namespace AWMI="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelManuInstructions";       
  <ProductModel PMID= "{ sql:column("Production.ProductModel.ProductModelID") }"       
  ProductModelName = "{ sql:column("Production.ProductModel.Name") }" >       
   <TotalLaborHrs>       
     { sum(//AWMI:Location/@LaborHours) }       
   </TotalLaborHrs>       
 </ProductModel>       
    ') as Result       
FROM Production.ProductModel       
WHERE Instructions is not NULL

以下是部份結果。

<ProductModel PMID="7" ProductModelName="HL Touring Frame">
   <TotalLaborHrs>12.75</TotalLaborHrs>
</ProductModel>
<ProductModel PMID="10" ProductModelName="LL Touring Frame">
  <TotalLaborHrs>13</TotalLaborHrs>
</ProductModel>
...

若不想傳回 XML 格式的結果，您可以撰寫查詢來產生關聯式結果，如下列查詢所示：

SELECT ProductModelID,       
        Name,       
        Instructions.value('declare namespace 
      AWMI="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelManuInstructions";       
    sum(//AWMI:Location/@LaborHours)', 'float') as TotalLaborHours       
FROM Production.ProductModel       
WHERE Instructions is not NULL

以下是部份結果：

ProductModelID Name                 TotalLaborHours       
-------------- -------------------------------------------------
7              HL Touring Frame           12.75                 
10             LL Touring Frame           13                    
43             Touring Rear Wheel         3                     
...

實作限制

以下這些是限制：

  • 只支援 sum() 的單一引數版本。

  • 如果輸入是動態計算出的空序列，則會傳回所用基底類型的值 0，而不是 xs:integer 類型。

  • sum() 函數會將所有整數對應到 xs:decimal。

  • 不支援值為 xs:duration 類型的 sum() 函數。

  • 不支援在基底類型界限之間混合類型的序列。

  • sum((xs:double(“INF”), xs:double(“-INF”))) 會引發值域錯誤。