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:
alexey-milovidov 2020-10-14 00:06:03 +03:00 committed by GitHub
commit 7d2f96ade9
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
3 changed files with 101 additions and 1 deletions

View File

@ -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.

View File

@ -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-->

View File

@ -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).
**Возвращаемые значения** **Возвращаемые значения**