mirror of
https://github.com/ClickHouse/ClickHouse.git
synced 2024-09-28 20:50:49 +00:00
6854bb46f5
Co-authored-by: olgarev <56617294+olgarev@users.noreply.github.com>
65 lines
2.2 KiB
Markdown
65 lines
2.2 KiB
Markdown
---
|
|
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)─┐
|
|
│ │
|
|
│▁▄▄▂▅▇█▁ │
|
|
│ │
|
|
└──────────────────────────────────────────────────────────────────────────┘
|
|
```
|
|
|