mirror of
https://github.com/hanzoai/datastore.git
synced 2026-09-26 13:55:07 +00:00
69 lines
3.3 KiB
Markdown
69 lines
3.3 KiB
Markdown
---
|
|
toc_priority: 209
|
|
---
|
|
|
|
# quantileBFloat16 {#quantilebfloat16}
|
|
|
|
Приближенно вычисляет [квантиль](https://ru.wikipedia.org/wiki/Квантиль) выборки чисел в формате [bfloat16](https://en.wikipedia.org/wiki/Bfloat16_floating-point_format). `bfloat16` — это формат с плавающей точкой, в котором для представления числа используется 1 знаковый бит, 8 бит для порядка и 7 бит для мантиссы.
|
|
Функция преобразует входное число в 32-битное с плавающей точкой и обрабатывает его старшие 16 бит. Она вычисляет квантиль в формате `bfloat16` и преобразует его в 64-битное число с плавающей точкой, добавляя нулевые биты.
|
|
Эта функция выполняет быстрые приближенные вычисления с относительной ошибкой не более 0.390625%.
|
|
|
|
**Синтаксис**
|
|
|
|
``` sql
|
|
quantileBFloat16[(level)](expr)
|
|
```
|
|
|
|
Синоним: `medianBFloat16`
|
|
|
|
**Аргументы**
|
|
|
|
- `expr` — столбец с числовыми данными. [Integer](../../../sql-reference/data-types/int-uint.md), [Float](../../../sql-reference/data-types/float.md).
|
|
|
|
**Параметры**
|
|
|
|
- `level` — уровень квантиля. Необязательный параметр. Допустимый диапазон значений от 0 до 1. Значение по умолчанию: 0.5. [Float](../../../sql-reference/data-types/float.md).
|
|
|
|
**Возвращаемое значение**
|
|
|
|
- Приближенное значение квантиля.
|
|
|
|
Тип: [Float64](../../../sql-reference/data-types/float.md#float32-float64).
|
|
|
|
**Пример**
|
|
|
|
В таблице есть столбцы с целыми числами и с числами с плавающей точкой:
|
|
|
|
``` text
|
|
┌─a─┬─────b─┐
|
|
│ 1 │ 1.001 │
|
|
│ 2 │ 1.002 │
|
|
│ 3 │ 1.003 │
|
|
│ 4 │ 1.004 │
|
|
└───┴───────┘
|
|
```
|
|
|
|
Запрос для вычисления 0.75-квантиля (верхнего квартиля):
|
|
|
|
``` sql
|
|
SELECT quantileBFloat16(0.75)(a), quantileBFloat16(0.75)(b) FROM example_table;
|
|
```
|
|
|
|
Результат:
|
|
|
|
``` text
|
|
┌─quantileBFloat16(0.75)(a)─┬─quantileBFloat16(0.75)(b)─┐
|
|
│ 3 │ 1 │
|
|
└───────────────────────────┴───────────────────────────┘
|
|
```
|
|
Обратите внимание, что все числа с плавающей точкой в примере были округлены до 1.0 при преобразовании к `bfloat16`.
|
|
|
|
# quantileBFloat16Weighted {#quantilebfloat16weighted}
|
|
|
|
Версия функции `quantileBFloat16`, которая учитывает вес каждого элемента последовательности.
|
|
|
|
**См. также**
|
|
|
|
- [median](../../../sql-reference/aggregate-functions/reference/median.md#median)
|
|
- [quantiles](../../../sql-reference/aggregate-functions/reference/quantiles.md#quantiles)
|