Merge branch 'main' into disable-downsampling-force-merge-via-mapping

Author: gmarouli

docs/reference/query-languages/esql/_snippets/commands/examples/stats.csv-spec/multi-mv-group.md

@@ -1,12 +1,18 @@
 % This is generated by ESQL's AbstractFunctionTestCase. Do not edit it. See ../README.md for how to regenerate it.
 
 ```esql
-ROW i=1, a=["a", "b"], b=[2, 3] | STATS MIN(i) BY a, b | SORT a ASC, b ASC
+ROW price = 10, color = ["blue", "pink", "yellow"], size = ["s", "m", "l"]
+| STATS SUM(price) BY color, size
 ```
 
-| MIN(i):integer | a:keyword | b:integer |
+| SUM(price):long | color:keyword | size:keyword |
 | --- | --- | --- |
-| 1 | a | 2 |
-| 1 | a | 3 |
-| 1 | b | 2 |
-| 1 | b | 3 |
+| 10 | blue | l |
+| 10 | blue | m |
+| 10 | blue | s |
+| 10 | pink | l |
+| 10 | pink | m |
+| 10 | pink | s |
+| 10 | yellow | l |
+| 10 | yellow | m |
+| 10 | yellow | s |

docs/reference/query-languages/esql/_snippets/commands/examples/stats.csv-spec/mv-group-values-expand.md

@@ -0,0 +1,13 @@
+% This is generated by ESQL's AbstractFunctionTestCase. Do not edit it. See ../README.md for how to regenerate it.
+
+```esql
+ROW color = ["blue", "pink", "yellow"]
+| MV_EXPAND color
+| STATS VALUES(color) BY color
+```
+
+| VALUES(color):keyword | color:keyword |
+| --- | --- |
+| blue | blue |
+| pink | pink |
+| yellow | yellow |

docs/reference/query-languages/esql/_snippets/commands/examples/stats.csv-spec/mv-group-values.md

@@ -0,0 +1,12 @@
+% This is generated by ESQL's AbstractFunctionTestCase. Do not edit it. See ../README.md for how to regenerate it.
+
+```esql
+ROW color = ["blue", "pink", "yellow"]
+| STATS VALUES(color) BY color
+```
+
+| VALUES(color):keyword | color:keyword |
+| --- | --- |
+| [blue, pink, yellow] | blue |
+| [blue, pink, yellow] | pink |
+| [blue, pink, yellow] | yellow |

docs/reference/query-languages/esql/_snippets/commands/examples/stats.csv-spec/mv-group.md

@@ -1,10 +1,12 @@
 % This is generated by ESQL's AbstractFunctionTestCase. Do not edit it. See ../README.md for how to regenerate it.
 
 ```esql
-ROW i=1, a=["a", "b"] | STATS MIN(i) BY a | SORT a ASC
+ROW price = 10, color = ["blue", "pink", "yellow"]
+| STATS SUM(price) BY color
 ```
 
-| MIN(i):integer | a:keyword |
+| SUM(price):long | color:keyword |
 | --- | --- |
-| 1 | a |
-| 1 | b |
+| 10 | blue |
+| 10 | pink |
+| 10 | yellow |

docs/reference/query-languages/esql/_snippets/commands/layout/stats-by.md

@@ -51,6 +51,10 @@ The following [aggregation functions](/reference/query-languages/esql/functions-
 :::{include} ../../lists/aggregation-functions.md
 :::
 
+When `STATS` is used under the [`TS`](/reference/query-languages/esql/commands/ts.md) source command,
+[time series aggregation functions](/reference/query-languages/esql/functions-operators/time-series-aggregation-functions.md)
+are also supported.
+
 The following [grouping functions](/reference/query-languages/esql/functions-operators/grouping-functions.md) are supported:
 
 :::{include} ../../lists/grouping-functions.md
@@ -110,11 +114,24 @@ It’s also possible to group by multiple values:
 
 :::{include} ../examples/stats.csv-spec/statsGroupByMultipleValues.md
 :::
+
 If all the grouping keys are multivalued then the input row is in all groups:
 
 :::{include} ../examples/stats.csv-spec/multi-mv-group.md
 :::
 
+The input **ROW** is in all groups. The entire row. All the values. Even group
+keys. That means that:
+
+:::{include} ../examples/stats.csv-spec/mv-group-values.md
+:::
+
+The `VALUES` function above sees the whole row - all of the values of the group
+key. If you want to send the group key to the function then `MV_EXPAND` first:
+
+:::{include} ../examples/stats.csv-spec/mv-group-values-expand.md
+:::
+
 Both the aggregating functions and the grouping expressions accept other
 functions. This is useful for using `STATS` on multivalue columns.
 For example, to calculate the average salary change, you can use `MV_AVG` to