mirror of
https://github.com/ClickHouse/ClickHouse.git
synced 2024-11-28 18:42:26 +00:00
Merge pull request #14508 from olgarev/revolg-DOCSUP-1675-Doc_the_cast_keep_nullable_setting
DOCSUP-1675 Docs for the cast_keep_nullable setting
This commit is contained in:
commit
7d2f96ade9
@ -2030,6 +2030,55 @@ Possible values:
|
|||||||
|
|
||||||
Default value: `120` seconds.
|
Default value: `120` seconds.
|
||||||
|
|
||||||
|
## cast_keep_nullable {#cast_keep_nullable}
|
||||||
|
|
||||||
|
Enables or disables keeping of the `Nullable` data type in [CAST](../../sql-reference/functions/type-conversion-functions.md#type_conversion_function-cast) operations.
|
||||||
|
|
||||||
|
If set, `CAST(something_nullable AS Type)` returns `Nullable(Type)`.
|
||||||
|
|
||||||
|
Possible values:
|
||||||
|
|
||||||
|
- 0 — The final type of `CAST` exactly the destination data type specified.
|
||||||
|
- 1 — The final type of `CAST` becomes `Nullable(DestinationDataType)`.
|
||||||
|
|
||||||
|
Default value: `0`.
|
||||||
|
|
||||||
|
**Examples**
|
||||||
|
|
||||||
|
The following query exactly results in the destination data type:
|
||||||
|
|
||||||
|
```sql
|
||||||
|
SET cast_keep_nullable = 0;
|
||||||
|
SELECT CAST(toNullable(toInt32(0)) AS Int32) as x, toTypeName(x);
|
||||||
|
```
|
||||||
|
|
||||||
|
Result:
|
||||||
|
|
||||||
|
```text
|
||||||
|
┌─x─┬─toTypeName(CAST(toNullable(toInt32(0)), 'Int32'))─┐
|
||||||
|
│ 0 │ Int32 │
|
||||||
|
└───┴───────────────────────────────────────────────────┘
|
||||||
|
```
|
||||||
|
|
||||||
|
The following query results in the `Nullable` modification on the destination data type:
|
||||||
|
|
||||||
|
```sql
|
||||||
|
SET cast_keep_nullable = 1;
|
||||||
|
SELECT CAST(toNullable(toInt32(0)) AS Int32) as x, toTypeName(x);
|
||||||
|
```
|
||||||
|
|
||||||
|
Result:
|
||||||
|
|
||||||
|
```text
|
||||||
|
┌─x─┬─toTypeName(CAST(toNullable(toInt32(0)), 'Int32'))─┐
|
||||||
|
│ 0 │ Nullable(Int32) │
|
||||||
|
└───┴───────────────────────────────────────────────────┘
|
||||||
|
```
|
||||||
|
|
||||||
|
**See Also**
|
||||||
|
|
||||||
|
- [CAST](../../sql-reference/functions/type-conversion-functions.md#type_conversion_function-cast) operator
|
||||||
|
|
||||||
## output_format_pretty_max_value_width {#output_format_pretty_max_value_width}
|
## output_format_pretty_max_value_width {#output_format_pretty_max_value_width}
|
||||||
|
|
||||||
Limits the width of value displayed in [Pretty](../../interfaces/formats.md#pretty) formats. If the value width exceeds the limit, the value is cut.
|
Limits the width of value displayed in [Pretty](../../interfaces/formats.md#pretty) formats. If the value width exceeds the limit, the value is cut.
|
||||||
|
@ -1990,4 +1990,53 @@ SELECT range(number) FROM system.numbers LIMIT 5 FORMAT PrettyCompactNoEscapes;
|
|||||||
|
|
||||||
Значение по умолчанию: `120` секунд.
|
Значение по умолчанию: `120` секунд.
|
||||||
|
|
||||||
|
## cast_keep_nullable {#cast_keep_nullable}
|
||||||
|
|
||||||
|
Включает или отключает сохранение типа `Nullable` для аргумента функции [CAST](../../sql-reference/functions/type-conversion-functions.md#type_conversion_function-cast).
|
||||||
|
|
||||||
|
Если настройка включена, то функция `CAST(something_nullable AS Type)` возвращает `Nullable(Type)`.
|
||||||
|
|
||||||
|
Возможные значения:
|
||||||
|
|
||||||
|
- 0 — функция `CAST` преобразует аргумент строго к указанному типу.
|
||||||
|
- 1 — функция `CAST` преобразует аргумент к типу `Nullable` для указанного типа.
|
||||||
|
|
||||||
|
Значение по умолчанию: `0`.
|
||||||
|
|
||||||
|
**Примеры**
|
||||||
|
|
||||||
|
Запрос возвращает аргумент, преобразованный строго к указанному типу:
|
||||||
|
|
||||||
|
```sql
|
||||||
|
SET cast_keep_nullable = 0;
|
||||||
|
SELECT CAST(toNullable(toInt32(0)) AS Int32) as x, toTypeName(x);
|
||||||
|
```
|
||||||
|
|
||||||
|
Результат:
|
||||||
|
|
||||||
|
```text
|
||||||
|
┌─x─┬─toTypeName(CAST(toNullable(toInt32(0)), 'Int32'))─┐
|
||||||
|
│ 0 │ Int32 │
|
||||||
|
└───┴───────────────────────────────────────────────────┘
|
||||||
|
```
|
||||||
|
|
||||||
|
Запрос возвращает аргумент, преобразованный к типу `Nullable` для указанного типа:
|
||||||
|
|
||||||
|
```sql
|
||||||
|
SET cast_keep_nullable = 1;
|
||||||
|
SELECT CAST(toNullable(toInt32(0)) AS Int32) as x, toTypeName(x);
|
||||||
|
```
|
||||||
|
|
||||||
|
Результат:
|
||||||
|
|
||||||
|
```text
|
||||||
|
┌─x─┬─toTypeName(CAST(toNullable(toInt32(0)), 'Int32'))─┐
|
||||||
|
│ 0 │ Nullable(Int32) │
|
||||||
|
└───┴───────────────────────────────────────────────────┘
|
||||||
|
```
|
||||||
|
|
||||||
|
**См. также**
|
||||||
|
|
||||||
|
- Функция [CAST](../../sql-reference/functions/type-conversion-functions.md#type_conversion_function-cast)
|
||||||
|
|
||||||
[Оригинальная статья](https://clickhouse.tech/docs/ru/operations/settings/settings/) <!--hide-->
|
[Оригинальная статья](https://clickhouse.tech/docs/ru/operations/settings/settings/) <!--hide-->
|
||||||
|
@ -61,6 +61,7 @@ bitmapSubsetLimit(bitmap, range_start, cardinality_limit)
|
|||||||
**Параметры**
|
**Параметры**
|
||||||
|
|
||||||
- `bitmap` – Битмап. [Bitmap object](#bitmap_functions-bitmapbuild).
|
- `bitmap` – Битмап. [Bitmap object](#bitmap_functions-bitmapbuild).
|
||||||
|
|
||||||
- `range_start` – Начальная точка подмножества. [UInt32](../../sql-reference/functions/bitmap-functions.md#bitmap-functions).
|
- `range_start` – Начальная точка подмножества. [UInt32](../../sql-reference/functions/bitmap-functions.md#bitmap-functions).
|
||||||
- `cardinality_limit` – Верхний предел подмножества. [UInt32](../../sql-reference/functions/bitmap-functions.md#bitmap-functions).
|
- `cardinality_limit` – Верхний предел подмножества. [UInt32](../../sql-reference/functions/bitmap-functions.md#bitmap-functions).
|
||||||
|
|
||||||
@ -97,7 +98,8 @@ bitmapContains(haystack, needle)
|
|||||||
**Параметры**
|
**Параметры**
|
||||||
|
|
||||||
- `haystack` – [объект Bitmap](#bitmap_functions-bitmapbuild), в котором функция ищет значение.
|
- `haystack` – [объект Bitmap](#bitmap_functions-bitmapbuild), в котором функция ищет значение.
|
||||||
- `needle` – значение, которое функция ищет. Тип — [UInt32](../../sql-reference/functions/bitmap-functions.md#bitmap-functions).
|
- `needle` – значение, которое функция ищет. Тип — [UInt32](../../sql-reference/data-types/int-uint.md).
|
||||||
|
|
||||||
|
|
||||||
**Возвращаемые значения**
|
**Возвращаемые значения**
|
||||||
|
|
||||||
|
Loading…
Reference in New Issue
Block a user