Merge pull request #32249 from kirillikoff/kirillikoff-DOCSUP-14791

DOCSUP-14791: Document the sparkbar aggregate function

docs/en/sql-reference/aggregate-functions/reference/sparkbar.md

@@ -0,0 +1,64 @@
+---
+toc_priority: 311
+toc_title: sparkbar
+---
+
+# sparkbar {#sparkbar}
+
+The function plots a frequency histogram for values `x` and the repetition rate `y` of these values over the interval `[min_x, max_x]`.
+
+
+If no interval is specified, then the minimum `x` is used as the interval start, and the maximum `x` — as the interval end. 
+
+**Syntax**
+
+``` sql
+sparkbar(width[, min_x, max_x])(x, y)
+```
+
+**Parameters**
+
+-   `width` — The number of segments. Type: [Integer](../../../sql-reference/data-types/int-uint.md).
+-   `min_x` — The interval start. Optional parameter.
+-   `max_x` — The interval end. Optional parameter.
+
+**Arguments**
+
+-   `x` — The field with values.
+-   `y` — The field with the frequency of values.
+
+**Returned value**
+
+-   The frequency histogram.
+
+**Example**
+
+Query:
+
+``` sql
+CREATE TABLE spark_bar_data (`cnt` UInt64,`event_date` Date) ENGINE = MergeTree ORDER BY event_date SETTINGS index_granularity = 8192;
+ 
+INSERT INTO spark_bar_data VALUES(1,'2020-01-01'),(4,'2020-01-02'),(5,'2020-01-03'),(2,'2020-01-04'),(3,'2020-01-05'),(7,'2020-01-06'),(6,'2020-01-07'),(8,'2020-01-08'),(2,'2020-01-11');
+
+SELECT sparkbar(9)(event_date,cnt) FROM spark_bar_data;
+
+SELECT sparkbar(9,toDate('2020-01-01'),toDate('2020-01-10'))(event_date,cnt) FROM spark_bar_data;
+```
+
+Result:
+
+``` text
+
+┌─sparkbar(9)(event_date, cnt)─┐
+│                              │
+│ ▁▅▄▃██▅ ▁                   │
+│                              │
+└──────────────────────────────┘
+
+┌─sparkbar(9, toDate('2020-01-01'), toDate('2020-01-10'))(event_date, cnt)─┐
+│                                                                          │
+│▁▄▄▂▅▇█▁                                                                 │
+│                                                                          │
+└──────────────────────────────────────────────────────────────────────────┘
+```
+

docs/ru/sql-reference/aggregate-functions/reference/sparkbar.md

@@ -0,0 +1,66 @@
+---
+toc_priority: 311
+toc_title: sparkbar
+---
+
+# sparkbar {#sparkbar}
+
+Функция строит гистограмму частот по заданным значениям `x` и частоте повторения этих значений `y` на интервале `[min_x, max_x]`. 
+
+Если интервал для построения не указан, то в качестве нижней границы интервала будет взято минимальное значение `x`, а в качестве верхней границы — максимальное значение `x`.
+
+
+**Синтаксис**
+
+``` sql
+sparkbar(width[, min_x, max_x])(x, y)
+```
+
+**Параметры**
+
+-   `width` — Количество столбцов гистограммы. Тип: [Integer](../../../sql-reference/data-types/int-uint.md).
+
+-   `min_x` — Начало интервала. Необязательный параметр.
+-   `max_x` — Конец интервала. Необязательный параметр.
+
+**Аргументы**
+
+-   `x` — Поле со значениями.
+-   `y` — Поле с частотой повторения значений.
+
+
+**Возвращаемые значения**
+
+-   Гистограмма частот.
+
+**Пример**
+
+Запрос:
+
+``` sql
+CREATE TABLE spark_bar_data (`cnt` UInt64,`event_date` Date) ENGINE = MergeTree ORDER BY event_date SETTINGS index_granularity = 8192;
+ 
+INSERT INTO spark_bar_data VALUES(1,'2020-01-01'),(4,'2020-01-02'),(5,'2020-01-03'),(2,'2020-01-04'),(3,'2020-01-05'),(7,'2020-01-06'),(6,'2020-01-07'),(8,'2020-01-08'),(2,'2020-01-11');
+
+SELECT sparkbar(9)(event_date,cnt) FROM spark_bar_data;
+
+SELECT sparkbar(9,toDate('2020-01-01'),toDate('2020-01-10'))(event_date,cnt) FROM spark_bar_data;
+```
+
+Результат:
+
+``` text
+
+┌─sparkbar(9)(event_date, cnt)─┐
+│                              │
+│ ▁▅▄▃██▅ ▁                   │
+│                              │
+└──────────────────────────────┘
+
+┌─sparkbar(9, toDate('2020-01-01'), toDate('2020-01-10'))(event_date, cnt)─┐
+│                                                                          │
+│▁▄▄▂▅▇█▁                                                                 │
+│                                                                          │
+└──────────────────────────────────────────────────────────────────────────┘
+```
+