# 排序、分組和聚合

## 排序

數組包含有序的值集合。如果需要重新排序值，則必須對數組進行排序。在 JSONata 中，有兩種對數組進行排序的方法：

1. 使用該[`$sort()`]()函數。
2. 使用[order-by]()運算符。

order [-by]()運算符是一種方便的語法，可直接在路徑表達式中使用，按升序或降序對結果序列進行排序。該[`$sort()`]()函數需要編寫更多語法，但更靈活，并支持自定義比較器函數。

## 分組

JSONata[對象構造]()函數語法允許您為任何鍵/值對中的鍵指定表達式（值顯然也可以是表達式）。鍵表達式必須求值為字符串，因為這是對 JSON 對象的限制。鍵和值表達式針對輸入上下文中的每個項目進行求值（請參閱[處理模型]()）。每個鍵/值表達式對的結果都會插入到生成的 JSON 對象中。

如果對任何鍵表達式的求值得出的結果已存在于結果對象中，則其關聯值表達式的結果將與已與該鍵關聯的值分組。請注意，只有在完成所有分組后才會對值表達式進行求值。這樣就可以對每個組的項目集合求值聚合表達式。

**示例**

* 將所有產品銷售按名稱分組，每組包含每件產品的價格

```
Account.Order.Product{`Product Name`: Price} 
// 結果
{
"Bowler Hat": [ 34.45, 34.45 ],
"Trilby hat": 21.67,
"Cloak": 107.99
}
```

* 將所有產品銷售按名稱分組，每組包含每件產品的價格和數量

```
Account.Order.Product { 
  `Product Name`: {"Price": Price, "Qty": Quantity}
}

// 結果  {
"Bowler Hat": {
"Price": [ 34.45, 34.45 ],
"Qty": [ 2, 4 ]
},
"Trilby hat": { "Price": 21.67, "Qty": 1 },
"Cloak": { "Price": 107.99, "Qty": 1 }
}
```

請注意，在上面的例子中，值表達式將所有價格組合在一起，將所有數量組合在一起，放入單獨的數組中。這是因為上下文值是所有分組產品的序列，而表達式 `Price` 將從所有產品中選擇所有價格。如果您想將價格和數量收集到單獨的對象中，則需要評估上下文序列中*每個產品的*對象構造函數。以下示例顯示了這一點。

* 明確使用為 `$.{ ... }` 組中的每個項目創建一個對象。

```
Account.Order.Product { 
    `Product Name`: $.{"Price": Price, "Qty": Quantity}
}

// 結果  
{
"Bowler Hat": [
{ "Price": 34.45, "Qty": 2 },
{ "Price": 34.45, "Qty": 4 }
],
"Trilby hat": { "Price": 21.67, "Qty": 1 },
"Cloak": { "Price": 107.99, "Qty": 1 }
}
```
* 將每組中每種產品的價格乘以數量

```
Account.Order.Product{
  `Product Name`: $.(Price*Quantity)
}
//結果 
{
  "Bowler Hat": [ 68.9, 137.8 ],
  "Trilby hat": 21.67,
  "Cloak": 107.99
}
```

* 每組的總聚合值

```
Account.Order.Product{`Product Name`: $sum($.(Price*Quantity))} 
//結果 
{
"Bowler Hat": 206.7,
"Trilby hat": 21.67,
"Cloak": 107.99
}
```

## 聚合

通常，查詢僅需要從一組匹配值返回聚合結果。有許多聚合函數可用，當應用于一組值時，它們會返回單個聚合值。

**示例**

* 每筆訂單中每件產品的總價

```
$sum(Account.Order.Product.Price)
// 結果
198.56
```

* 更有可能的是希望將每份訂單的價格乘以數量相加

```
$sum(Account.Order.Product.(Price*Quantity)) 
//結果 
336.36 
```

還有其他[數字聚合函數]()可用（即平均值、最小值、最大值）和[字符串聚合器]()。還可以使用[`$reduce()`]()高階函數編寫復雜的自定義聚合器。

6、排序、分組和聚合