全部產品

IoT Platform：彙總函式

更新時間：Jun 30, 2024

彙總（Aggregate）函數的輸入與輸出是多對一的關係，即將多條輸入記錄彙總成一條輸出值。本文介紹資料分析支援的彙總函式的命令格式、參數說明及樣本。

說明物聯網資料分析中，僅在指標配置中支援彙總函式。具體操作，請參見新增指標。

AVG

命令格式

double avg(double <colname>)
decimal avg(decimal <colname>)

命令說明
計算平均值。
參數說明
value：必填。可為DOUBLE或DECIMAL類型。如果輸入為STRING或BIGINT類型，會隱式轉換為DOUBLE類型後參與運算，其它類型返回報錯。當value值為NULL時，不參與計算。BOOLEAN類型不允許參與運算。
傳回值
如果輸入DECIMAL類型，返回DECIMAL類型。輸入其他合法的類型時，會返回DOUBLE類型。
樣本
擷取日溫度（temperature）的平均溫度。
```
avg(temperature);
```

COUNT

命令格式
```
bigint count([distinct|all] <value>)
```
命令說明
計算記錄數。
參數說明
- distinct|all：可選。表示在計數時是否去除重複記錄，預設為all，即計算全部記錄。如果指定distinct，則只計算唯一值數量。
- value：必填。可以為任意類型。當value值為NULL時，該行不參與計算。
傳回值說明
返回BIGINT類型。
樣本
- 樣本1：計算每日上報溫度（temperature）數量。
```
count(temperature);
```
- 樣本2：通過distinct去重，計算不同溫度數量。
```
count(distinct temperature);
```

MAX

命令格式
```
max(<colname>)
```
命令說明
計算最大值。
參數說明
value：必填。列值可以為任意類型。當value值為NULL時，該行不參與計算。BOOLEAN類型不允許參與運算。
傳回值說明
傳回值的類型與value類型相同。
樣本
計算每日上報溫度（temperature）最大值。
```
max(temperature);
```

MIN

命令格式
```
min(<value>)
```
命令說明
計算最小值。
參數說明
value：必填。列值可以為任意類型。當value值為NULL時，該行不參與計算。BOOLEAN類型不允許參與計算。
傳回值說明
傳回值的類型與value類型相同。
樣本
計算每日上報溫度（temperature）最小值。
```
min(temperature);
```

SUM

命令格式
```
sum(<value>)
```
命令說明
計算匯總值。
參數說明
value：必填。列值可以為DOUBLE、DECIMAL或BIGINT類型。如果輸入為STRING類型，會隱式轉換為DOUBLE類型後參與運算。當value值為NULL時，該行不參與計算。BOOLEAN類型不允許參與計算。
傳回值說明
輸入BIGINT類型時，返回BIGINT類型。輸入為DOUBLE或STRING類型時，返回DOUBLE類型。
樣本
計算每日上報溫度（temperature）總和。
```
sum(temperature);
```