ClickHouse/docs/en/sql-reference/aggregate-functions/reference/deltasum.md

74 lines
1.7 KiB
Markdown
Raw Normal View History

---
toc_priority: 141
---
# deltaSum {#agg_functions-deltasum}
Sums the arithmetic difference between consecutive rows. If the difference is negative, it is ignored.
Note that the underlying data must be sorted in order for this function to work properly.
If you would like to use this function in a materialized view, you most likely want to use the
2021-03-23 19:27:38 +00:00
[deltaSumTimestamp](deltasumtimestamp.md) method instead.
2021-03-23 19:27:38 +00:00
**Syntax**
``` sql
deltaSum(value)
```
**Arguments**
- `value` — Input values, must be [Integer](../../data-types/int-uint.md) or [Float](../../data-types/float.md) type.
**Returned value**
- A gained arithmetic difference of the `Integer` or `Float` type.
**Examples**
Query:
``` sql
2021-03-18 13:16:15 +00:00
SELECT deltaSum(arrayJoin([1, 2, 3]));
```
Result:
``` text
┌─deltaSum(arrayJoin([1, 2, 3]))─┐
│ 2 │
└────────────────────────────────┘
```
Query:
``` sql
2021-03-18 13:16:15 +00:00
SELECT deltaSum(arrayJoin([1, 2, 3, 0, 3, 4, 2, 3]));
```
Result:
``` text
┌─deltaSum(arrayJoin([1, 2, 3, 0, 3, 4, 2, 3]))─┐
│ 7 │
└───────────────────────────────────────────────┘
```
Query:
``` sql
2021-03-18 13:16:15 +00:00
SELECT deltaSum(arrayJoin([2.25, 3, 4.5]));
```
Result:
``` text
┌─deltaSum(arrayJoin([2.25, 3, 4.5]))─┐
│ 2.25 │
└─────────────────────────────────────┘
```
2021-03-18 13:16:15 +00:00
## See Also {#see-also}
- [runningDifference](../../functions/other-functions.md#other_functions-runningdifference)