mirror of
https://github.com/ClickHouse/ClickHouse.git
synced 2024-11-21 15:12:02 +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.
|
||||
|
||||
## 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}
|
||||
|
||||
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` секунд.
|
||||
|
||||
## 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-->
|
||||
|
@ -61,6 +61,7 @@ bitmapSubsetLimit(bitmap, range_start, cardinality_limit)
|
||||
**Параметры**
|
||||
|
||||
- `bitmap` – Битмап. [Bitmap object](#bitmap_functions-bitmapbuild).
|
||||
|
||||
- `range_start` – Начальная точка подмножества. [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), в котором функция ищет значение.
|
||||
- `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