mirror of
https://github.com/ClickHouse/ClickHouse.git
synced 2024-11-26 01:22:04 +00:00
Add ru docs for uuid and array functions.
This commit is contained in:
parent
b52b77179b
commit
36878cd377
@ -18,7 +18,7 @@ empty([x])
|
|||||||
An array is considered empty if it contains all empty elements.
|
An array is considered empty if it contains all empty elements.
|
||||||
|
|
||||||
!!! note "Note"
|
!!! note "Note"
|
||||||
Can be optimized by enabling the [optimize_functions_to_subcolumns](../../operations/settings/settings.md#optimize-functions-to-subcolumns) setting. With `optimize_functions_to_subcolumns = 1` the function reads only [size0](../../sql-reference/data-types/array.md#array-size) subcolumn instead of reading and processing the whole array column. The query `SELECT empty(arr) FROM table;` transforms to `SELECT arr.size0 = 0 FROM TABLE;`.
|
Can be optimized by enabling the [optimize_functions_to_subcolumns](../../operations/settings/settings.md#optimize-functions-to-subcolumns) setting. With `optimize_functions_to_subcolumns = 1` the function reads only [size0](../../sql-reference/data-types/array.md#array-size) subcolumn instead of reading and processing the whole array column. The query `SELECT empty(arr) FROM TABLE;` transforms to `SELECT arr.size0 = 0 FROM TABLE;`.
|
||||||
|
|
||||||
The function also works for [strings](string-functions.md#empty) or [UUID](uuid-functions.md#empty).
|
The function also works for [strings](string-functions.md#empty) or [UUID](uuid-functions.md#empty).
|
||||||
|
|
||||||
@ -57,6 +57,7 @@ Checks whether the input array is non-empty.
|
|||||||
``` sql
|
``` sql
|
||||||
notEmpty([x])
|
notEmpty([x])
|
||||||
```
|
```
|
||||||
|
|
||||||
An array is considered non-empty if it contains at least one non-empty element.
|
An array is considered non-empty if it contains at least one non-empty element.
|
||||||
|
|
||||||
!!! note "Note"
|
!!! note "Note"
|
||||||
|
@ -7,20 +7,90 @@ toc_title: "Массивы"
|
|||||||
|
|
||||||
## empty {#function-empty}
|
## empty {#function-empty}
|
||||||
|
|
||||||
Возвращает 1 для пустого массива, и 0 для непустого массива.
|
Проверяет, является ли входной массив пустым.
|
||||||
Тип результата - UInt8.
|
|
||||||
Функция также работает для строк.
|
|
||||||
|
|
||||||
Функцию можно оптимизировать, если включить настройку [optimize_functions_to_subcolumns](../../operations/settings/settings.md#optimize-functions-to-subcolumns). При `optimize_functions_to_subcolumns = 1` функция читает только подстолбец [size0](../../sql-reference/data-types/array.md#array-size) вместо чтения и обработки всего столбца массива. Запрос `SELECT empty(arr) FROM table` преобразуется к запросу `SELECT arr.size0 = 0 FROM TABLE`.
|
**Синтаксис**
|
||||||
|
|
||||||
|
``` sql
|
||||||
|
empty([x])
|
||||||
|
```
|
||||||
|
|
||||||
|
Массив считается пустым, если он содержит все пустые элементы.
|
||||||
|
|
||||||
|
!!! note "Примечание"
|
||||||
|
Функцию можно оптимизировать, если включить настройку [optimize_functions_to_subcolumns](../../operations/settings/settings.md#optimize-functions-to-subcolumns). При `optimize_functions_to_subcolumns = 1` функция читает только подстолбец [size0](../../sql-reference/data-types/array.md#array-size) вместо чтения и обработки всего столбца массива. Запрос `SELECT empty(arr) FROM TABLE` преобразуется к запросу `SELECT arr.size0 = 0 FROM TABLE`.
|
||||||
|
|
||||||
|
Функция также поддерживает работу с типами [String](string-functions.md#empty) и [UUID](uuid-functions.md#empty).
|
||||||
|
|
||||||
|
**Параметры**
|
||||||
|
|
||||||
|
- `[x]` — массив на входе функции. [Array](../data-types/array.md).
|
||||||
|
|
||||||
|
**Возвращаемое значение**
|
||||||
|
|
||||||
|
- Возвращает `1` для пустого массива или `0` — для непустого массива.
|
||||||
|
|
||||||
|
Тип: [UInt8](../data-types/int-uint.md).
|
||||||
|
|
||||||
|
**Пример**
|
||||||
|
|
||||||
|
Запрос:
|
||||||
|
|
||||||
|
```sql
|
||||||
|
SELECT empty([]);
|
||||||
|
```
|
||||||
|
|
||||||
|
Ответ:
|
||||||
|
|
||||||
|
```text
|
||||||
|
┌─empty(array())─┐
|
||||||
|
│ 1 │
|
||||||
|
└────────────────┘
|
||||||
|
```
|
||||||
|
|
||||||
## notEmpty {#function-notempty}
|
## notEmpty {#function-notempty}
|
||||||
|
|
||||||
Возвращает 0 для пустого массива, и 1 для непустого массива.
|
Проверяет, является ли входной массив непустым.
|
||||||
Тип результата - UInt8.
|
|
||||||
Функция также работает для строк.
|
|
||||||
|
|
||||||
|
**Синтаксис**
|
||||||
|
|
||||||
|
``` sql
|
||||||
|
notEmpty([x])
|
||||||
|
```
|
||||||
|
|
||||||
|
Массив считается непустым, если он содержит хотя бы один непустой элемент.
|
||||||
|
|
||||||
|
!!! note "Примечание"
|
||||||
Функцию можно оптимизировать, если включить настройку [optimize_functions_to_subcolumns](../../operations/settings/settings.md#optimize-functions-to-subcolumns). При `optimize_functions_to_subcolumns = 1` функция читает только подстолбец [size0](../../sql-reference/data-types/array.md#array-size) вместо чтения и обработки всего столбца массива. Запрос `SELECT notEmpty(arr) FROM table` преобразуется к запросу `SELECT arr.size0 != 0 FROM TABLE`.
|
Функцию можно оптимизировать, если включить настройку [optimize_functions_to_subcolumns](../../operations/settings/settings.md#optimize-functions-to-subcolumns). При `optimize_functions_to_subcolumns = 1` функция читает только подстолбец [size0](../../sql-reference/data-types/array.md#array-size) вместо чтения и обработки всего столбца массива. Запрос `SELECT notEmpty(arr) FROM table` преобразуется к запросу `SELECT arr.size0 != 0 FROM TABLE`.
|
||||||
|
|
||||||
|
Функция также поддерживает работу с типами [String](string-functions.md#notempty) и [UUID](uuid-functions.md#notempty).
|
||||||
|
|
||||||
|
**Параметры**
|
||||||
|
|
||||||
|
- `[x]` — массив на входе функции. [Array](../data-types/array.md).
|
||||||
|
|
||||||
|
**Возвращаемое значение**
|
||||||
|
|
||||||
|
- Возвращает `1` для непустого массива или `0` — для пустого массива.
|
||||||
|
|
||||||
|
Тип: [UInt8](../data-types/int-uint.md).
|
||||||
|
|
||||||
|
**Пример**
|
||||||
|
|
||||||
|
Запрос:
|
||||||
|
|
||||||
|
```sql
|
||||||
|
SELECT notEmpty([1,2]);
|
||||||
|
```
|
||||||
|
|
||||||
|
Результат:
|
||||||
|
|
||||||
|
```text
|
||||||
|
┌─notEmpty([1, 2])─┐
|
||||||
|
│ 1 │
|
||||||
|
└──────────────────┘
|
||||||
|
```
|
||||||
|
|
||||||
## length {#array_functions-length}
|
## length {#array_functions-length}
|
||||||
|
|
||||||
Возвращает количество элементов в массиве.
|
Возвращает количество элементов в массиве.
|
||||||
|
@ -35,6 +35,90 @@ SELECT * FROM t_uuid
|
|||||||
└──────────────────────────────────────┘
|
└──────────────────────────────────────┘
|
||||||
```
|
```
|
||||||
|
|
||||||
|
## empty {#empty}
|
||||||
|
|
||||||
|
Проверяет, является ли входной UUID пустым.
|
||||||
|
|
||||||
|
**Синтаксис**
|
||||||
|
|
||||||
|
```sql
|
||||||
|
empty(UUID)
|
||||||
|
```
|
||||||
|
|
||||||
|
UUID считается пустым, если он содержит все нули (нулевой UUID).
|
||||||
|
|
||||||
|
Функция также поддерживает работу с типами [Array](array-functions.md#empty) и [String](string-functions.md#empty).
|
||||||
|
|
||||||
|
**Параметры**
|
||||||
|
|
||||||
|
- `x` — UUID на входе функции. [UUID](../data-types/uuid.md).
|
||||||
|
|
||||||
|
**Возвращаемое значение**
|
||||||
|
|
||||||
|
- Возвращает `1` для пустого UUID или `0` — для непустого UUID.
|
||||||
|
|
||||||
|
Тип: [UInt8](../data-types/int-uint.md).
|
||||||
|
|
||||||
|
**Пример**
|
||||||
|
|
||||||
|
Для генерации UUID-значений предназначена функция [generateUUIDv4](#uuid-function-generate).
|
||||||
|
|
||||||
|
Запрос:
|
||||||
|
|
||||||
|
```sql
|
||||||
|
SELECT empty(generateUUIDv4());
|
||||||
|
```
|
||||||
|
|
||||||
|
Ответ:
|
||||||
|
|
||||||
|
```text
|
||||||
|
┌─empty(generateUUIDv4())─┐
|
||||||
|
│ 0 │
|
||||||
|
└─────────────────────────┘
|
||||||
|
```
|
||||||
|
|
||||||
|
## notEmpty {#notempty}
|
||||||
|
|
||||||
|
Проверяет, является ли входной UUID непустым.
|
||||||
|
|
||||||
|
**Синтаксис**
|
||||||
|
|
||||||
|
```sql
|
||||||
|
notEmpty(UUID)
|
||||||
|
```
|
||||||
|
|
||||||
|
UUID считается пустым, если он содержит все нули (нулевой UUID).
|
||||||
|
|
||||||
|
Функция также поддерживает работу с типами [Array](array-functions.md#notempty) и [String](string-functions.md#notempty).
|
||||||
|
|
||||||
|
**Параметры**
|
||||||
|
|
||||||
|
- `x` — UUID на входе функции. [UUID](../data-types/uuid.md).
|
||||||
|
|
||||||
|
**Возвращаемое значение**
|
||||||
|
|
||||||
|
- Возвращает `1` для непустого UUID или `0` — для пустого UUID.
|
||||||
|
|
||||||
|
Тип: [UInt8](../data-types/int-uint.md).
|
||||||
|
|
||||||
|
**Пример**
|
||||||
|
|
||||||
|
Для генерации UUID-значений предназначена функция [generateUUIDv4](#uuid-function-generate).
|
||||||
|
|
||||||
|
Запрос:
|
||||||
|
|
||||||
|
```sql
|
||||||
|
SELECT notEmpty(generateUUIDv4());
|
||||||
|
```
|
||||||
|
|
||||||
|
Результат:
|
||||||
|
|
||||||
|
```text
|
||||||
|
┌─notEmpty(generateUUIDv4())─┐
|
||||||
|
│ 1 │
|
||||||
|
└────────────────────────────┘
|
||||||
|
```
|
||||||
|
|
||||||
## toUUID (x) {#touuid-x}
|
## toUUID (x) {#touuid-x}
|
||||||
|
|
||||||
Преобразует значение типа String в тип UUID.
|
Преобразует значение типа String в тип UUID.
|
||||||
|
Loading…
Reference in New Issue
Block a user