mirror of
https://github.com/ClickHouse/ClickHouse.git
synced 2024-11-19 14:11:58 +00:00
Merge remote-tracking branch 'upstream/master' into fix25
This commit is contained in:
proller
commit
818ee0d987
@ -15,29 +15,29 @@
|
||||
|
||||
## toDecimal32(value, S), toDecimal64(value, S), toDecimal128(value, S)
|
||||
|
||||
Converts `value` to [Decimal](../../data_types/decimal.md) of precision `S`. The `value` can be a number or a string. The `S` (scale) parameter specifies the number of decimal places.
|
||||
Converts `value` to the [Decimal](../../data_types/decimal.md) data type with precision of `S`. The `value` can be a number or a string. The `S` (scale) parameter specifies the number of decimal places.
|
||||
|
||||
## toDecimal(32|64|128)OrNull
|
||||
|
||||
Converts an input string to the value of [Nullable(Decimal(P,S))](../../data_types/decimal.md) data type. This family of functions include:
|
||||
Converts an input string to a [Nullable(Decimal(P,S))](../../data_types/decimal.md) data type value. This family of functions include:
|
||||
|
||||
- `toDecimal32OrNull(expr, S)` — Results with `Nullable(Decimal32(S))` data type.
|
||||
- `toDecimal64OrNull(expr, S)` — Results with `Nullable(Decimal64(S))` data type.
|
||||
- `toDecimal128OrNull(expr, S)` — Results with `Nullable(Decimal128(S))` data type.
|
||||
- `toDecimal32OrNull(expr, S)` — Results in `Nullable(Decimal32(S))` data type.
|
||||
- `toDecimal64OrNull(expr, S)` — Results in `Nullable(Decimal64(S))` data type.
|
||||
- `toDecimal128OrNull(expr, S)` — Results in `Nullable(Decimal128(S))` data type.
|
||||
|
||||
These functions should be used instead of `toDecimal*()` functions, if you prefer to get the `NULL` value instead of exception, when input value parsing error.
|
||||
These functions should be used instead of `toDecimal*()` functions, if you prefer to get a `NULL` value instead of an exception in the event of an input value parsing error.
|
||||
|
||||
**Parameters**
|
||||
|
||||
- `expr` — [Expression](../syntax.md#syntax-expressions), returning a value of the [String](../../data_types/string.md) data type. ClickHouse expects the textual representation of the decimal number. For example, "1.111".
|
||||
- `expr` — [Expression](../syntax.md#syntax-expressions), returns a value in the [String](../../data_types/string.md) data type. ClickHouse expects the textual representation of the decimal number. For example, `'1.111'`.
|
||||
- `S` — Scale, the number of decimal places in the resulting value.
|
||||
|
||||
**Returned value**
|
||||
|
||||
The value of `Nullable(Decimal(P,S))` data type. `P` equals to numeric part of the function name. For example, for the `toDecimal32OrNull` function `P = 32`. The value contains:
|
||||
A value in the `Nullable(Decimal(P,S))` data type. The value contains:
|
||||
|
||||
- Number with `S` decimal places, if ClickHouse could interpret input string as a number.
|
||||
- `NULL`, if ClickHouse couldn't interpret input string as a number or if the input number contains more decimal places then `S`.
|
||||
- Number with `S` decimal places, if ClickHouse interprets the input string as a number.
|
||||
- `NULL`, if ClickHouse can't interpret the input string as a number or if the input number contains more than `S` decimal places.
|
||||
|
||||
**Examples**
|
||||
|
||||
@ -63,23 +63,23 @@ SELECT toDecimal32OrNull(toString(-1.111), 2) AS val, toTypeName(val)
|
||||
|
||||
Converts an input value to the [Decimal(P,S)](../../data_types/decimal.md) data type. This family of functions include:
|
||||
|
||||
- `toDecimal32OrZero( expr, S)` — Results with `Decimal32(S)` data type.
|
||||
- `toDecimal64OrZero( expr, S)` — Results with `Decimal64(S)` data type.
|
||||
- `toDecimal128OrZero( expr, S)` — Results with `Decimal128(S)` data type.
|
||||
- `toDecimal32OrZero( expr, S)` — Results in `Decimal32(S)` data type.
|
||||
- `toDecimal64OrZero( expr, S)` — Results in `Decimal64(S)` data type.
|
||||
- `toDecimal128OrZero( expr, S)` — Results in `Decimal128(S)` data type.
|
||||
|
||||
These functions should be used instead of `toDecimal*()` functions, if you prefer to get the `0` value instead of exception, when input value parsing error.
|
||||
These functions should be used instead of `toDecimal*()` functions, if you prefer to get a `0` value instead of an exception in the event of an input value parsing error.
|
||||
|
||||
**Parameters**
|
||||
|
||||
- `expr` — [Expression](../syntax.md#syntax-expressions), returning a value of the [String](../../data_types/string.md) data type. ClickHouse expects the textual representation of the decimal number. For example, `'1.111'`.
|
||||
- `expr` — [Expression](../syntax.md#syntax-expressions), returns a value in the [String](../../data_types/string.md) data type. ClickHouse expects the textual representation of the decimal number. For example, `'1.111'`.
|
||||
- `S` — Scale, the number of decimal places in the resulting value.
|
||||
|
||||
**Returned value**
|
||||
|
||||
The value of `Nullable(Decimal(P,S))` data type. `P` equals to numeric part of the function name. For example, for the `toDecimal32OrZero` function `P = 32`. The value contains:
|
||||
A value in the `Nullable(Decimal(P,S))` data type. The value contains:
|
||||
|
||||
- Number with `S` decimal places, if ClickHouse could interpret input string as a number.
|
||||
- 0 with `S` decimal places, if ClickHouse couldn't interpret input string as a number or if the input number contains more decimal places then `S`.
|
||||
- Number with `S` decimal places, if ClickHouse interprets the input string as a number.
|
||||
- 0 with `S` decimal places, if ClickHouse can't interpret the input string as a number or if the input number contains more than `S` decimal places.
|
||||
|
||||
**Example**
|
||||
|
||||
@ -139,10 +139,6 @@ SELECT
|
||||
|
||||
Also see the `toUnixTimestamp` function.
|
||||
|
||||
## toDecimal32(value, S), toDecimal64(value, S), toDecimal128(value, S)
|
||||
|
||||
Converts `value` to [Decimal](../../data_types/decimal.md) of precision `S`. The `value` can be a number or a string. The `S` (scale) parameter specifies the number of decimal places.
|
||||
|
||||
## toFixedString(s, N)
|
||||
|
||||
Converts a String type argument to a FixedString(N) type (a string with fixed length N). N must be a constant.
|
||||
|
||||
@ -32,15 +32,16 @@ The query response contains the `result` column with a single row. The row has a
|
||||
- 0 - The data in the table is corrupted.
|
||||
- 1 - The data maintains integrity.
|
||||
|
||||
The `CHECK TABLE` query is only supported for the following table engines:
|
||||
The `CHECK TABLE` query supports the following table engines:
|
||||
|
||||
- [Log](../operations/table_engines/log.md)
|
||||
- [TinyLog](../operations/table_engines/tinylog.md)
|
||||
- [StripeLog](../operations/table_engines/stripelog.md)
|
||||
- [MergeTree family](../operations/table_engines/mergetree.md)
|
||||
|
||||
These engines do not provide automatic data recovery on failure. Use the `CHECK TABLE` query to track data loss in a timely manner.
|
||||
The `*Log` engines do not provide automatic data recovery on failure. Use the `CHECK TABLE` query to track data loss in a timely manner.
|
||||
|
||||
To avoid data loss use the [MergeTree](../operations/table_engines/mergetree.md) family tables.
|
||||
For the `MergeTree` family engines the `CHECK TABLE` query shows a check status for every individual table data part at the local server.
|
||||
|
||||
**If the data is corrupted**
|
||||
|
||||
@ -57,7 +58,7 @@ If the table is corrupted, you can copy the non-corrupted data to another table.
|
||||
DESC|DESCRIBE TABLE [db.]table [INTO OUTFILE filename] [FORMAT format]
|
||||
```
|
||||
|
||||
Returns the following `String` type columns:
|
||||
Returns the following `String` type columns:
|
||||
|
||||
- `name` — Column name.
|
||||
- `type`— Column type.
|
||||
|
||||
@ -1,4 +1,3 @@
|
||||
|
||||
# Функции преобразования типов
|
||||
|
||||
## toUInt8, toUInt16, toUInt32, toUInt64
|
||||
@ -7,15 +6,106 @@
|
||||
|
||||
## toFloat32, toFloat64
|
||||
|
||||
## toUInt8OrZero, toUInt16OrZero, toUInt32OrZero, toUInt64OrZero, toInt8OrZero, toInt16OrZero, toInt32OrZero, toInt64OrZero, toFloat32OrZero, toFloat64OrZero
|
||||
|
||||
## toDate, toDateTime
|
||||
|
||||
## toUInt8OrZero, toUInt16OrZero, toUInt32OrZero, toUInt64OrZero, toInt8OrZero, toInt16OrZero, toInt32OrZero, toInt64OrZero, toFloat32OrZero, toFloat64OrZero
|
||||
|
||||
## toUInt8OrNull, toUInt16OrNull, toUInt32OrNull, toUInt64OrNull, toInt8OrNull, toInt16OrNull, toInt32OrNull, toInt64OrNull, toFloat32OrNull, toFloat64OrNull, toDateOrNull, toDateTimeOrNull
|
||||
|
||||
## toDecimal32(value, S), toDecimal64(value, S), toDecimal128(value, S)
|
||||
Приводит строку или число value к типу [Decimal](../../data_types/decimal.md) указанной точности.
|
||||
Параметр S (scale) определяет число десятичных знаков после запятой.
|
||||
|
||||
Преобразует тип `value` в тип [Decimal](../../data_types/decimal.md), имеющий точность `S`. `value` может быть числом или строкой. Параметр `S` (scale) устанавливает количество десятичных знаков.
|
||||
|
||||
## toDecimal(32|64|128)OrNull
|
||||
|
||||
Преобразует входную строку в значение с типом данных [Nullable (Decimal (P, S))](../../data_types/decimal.md). Семейство функций включает в себя:
|
||||
|
||||
- `toDecimal32OrNull(expr, S)` — Возвращает значение типа `Nullable(Decimal32(S))`.
|
||||
- `toDecimal64OrNull(expr, S)` — Возвращает значение типа `Nullable(Decimal64(S))`.
|
||||
- `toDecimal128OrNull(expr, S)` — Возвращает значение типа `Nullable(Decimal128(S))`.
|
||||
|
||||
Эти функции следует использовать вместо функций `toDecimal*()`, если при ошибке обработки входного значения вы хотите получать `NULL` вместо исключения.
|
||||
|
||||
**Параметры**
|
||||
|
||||
- `expr` — [выражение](../syntax.md#syntax-expressions), возвращающее значение типа [String](../../data_types/string.md). ClickHouse ожидает текстовое представление десятичного числа. Например, `'1.111'`.
|
||||
- `S` — количество десятичных знаков в результирующем значении.
|
||||
|
||||
**Возвращаемое значение**
|
||||
|
||||
Значение типа `Nullable(Decimal(P,S))`. Значение содержит:
|
||||
|
||||
- Число с `S` десятичными знаками, если ClickHouse распознал число во входной строке.
|
||||
- `NULL`, если ClickHouse не смог распознать число во входной строке или входное число содержит больше чем `S` десятичных знаков.
|
||||
|
||||
**Примеры**
|
||||
|
||||
```sql
|
||||
SELECT toDecimal32OrNull(toString(-1.111), 5) AS val, toTypeName(val)
|
||||
```
|
||||
|
||||
```text
|
||||
┌──────val─┬─toTypeName(toDecimal32OrNull(toString(-1.111), 5))─┐
|
||||
│ -1.11100 │ Nullable(Decimal(9, 5)) │
|
||||
└──────────┴────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
```sql
|
||||
SELECT toDecimal32OrNull(toString(-1.111), 2) AS val, toTypeName(val)
|
||||
```
|
||||
|
||||
```text
|
||||
┌──val─┬─toTypeName(toDecimal32OrNull(toString(-1.111), 2))─┐
|
||||
│ ᴺᵁᴸᴸ │ Nullable(Decimal(9, 2)) │
|
||||
└──────┴────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
## toDecimal(32|64|128)OrZero
|
||||
|
||||
Преобразует тип входного значения в [Decimal (P, S)](../../data_types/decimal.md). Семейство функций включает в себя:
|
||||
|
||||
- `toDecimal32OrZero( expr, S)` — возвращает значение типа `Decimal32(S)`.
|
||||
- `toDecimal64OrZero( expr, S)` — возвращает значение типа `Decimal64(S)`.
|
||||
- `toDecimal128OrZero( expr, S)` — возвращает значение типа `Decimal128(S)`.
|
||||
|
||||
Эти функции следует использовать вместо функций `toDecimal*()`, если при ошибке обработки входного значения вы хотите получать `0` вместо исключения.
|
||||
|
||||
**Параметры**
|
||||
|
||||
- `expr` — [выражение](../syntax.md#syntax-expressions), возвращающее значение типа [String](../../data_types/string.md). ClickHouse ожидает текстовое представление десятичного числа. Например, `'1.111'`.
|
||||
- `S` — количество десятичных знаков в результирующем значении.
|
||||
|
||||
**Возвращаемое значение**
|
||||
|
||||
Значение типа `Nullable(Decimal(P,S))`. `P` равно числовой части имени функции. Например, для функции `toDecimal32OrZero`, `P = 32`. Значение содержит:
|
||||
|
||||
- Число с `S` десятичными знаками, если ClickHouse распознал число во входной строке.
|
||||
- 0 c `S` десятичными знаками, если ClickHouse не смог распознать число во входной строке или входное число содержит больше чем `S` десятичных знаков.
|
||||
|
||||
**Пример**
|
||||
|
||||
```sql
|
||||
SELECT toDecimal32OrZero(toString(-1.111), 5) AS val, toTypeName(val)
|
||||
```
|
||||
|
||||
```text
|
||||
┌──────val─┬─toTypeName(toDecimal32OrZero(toString(-1.111), 5))─┐
|
||||
│ -1.11100 │ Decimal(9, 5) │
|
||||
└──────────┴────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
```sql
|
||||
SELECT toDecimal32OrZero(toString(-1.111), 2) AS val, toTypeName(val)
|
||||
```
|
||||
|
||||
```text
|
||||
┌──val─┬─toTypeName(toDecimal32OrZero(toString(-1.111), 2))─┐
|
||||
│ 0.00 │ Decimal(9, 2) │
|
||||
└──────┴────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
## toString
|
||||
|
||||
Функции преобразования между числами, строками (но не фиксированными строками), датами и датами-с-временем.
|
||||
Все эти функции принимают один аргумент.
|
||||
|
||||
@ -39,7 +129,7 @@ YYYY-MM-DD hh:mm:ss
|
||||
|
||||
Дополнительно, функция toString от аргумента типа DateTime может принимать второй аргумент String - имя тайм-зоны. Пример: `Asia/Yekaterinburg` В этом случае, форматирование времени производится согласно указанной тайм-зоне.
|
||||
|
||||
``` sql
|
||||
```sql
|
||||
SELECT
|
||||
now() AS now_local,
|
||||
toString(now(), 'Asia/Yekaterinburg') AS now_yekat
|
||||
@ -54,15 +144,17 @@ SELECT
|
||||
Также смотрите функцию `toUnixTimestamp`.
|
||||
|
||||
## toFixedString(s, N)
|
||||
|
||||
Преобразует аргумент типа String в тип FixedString(N) (строку фиксированной длины N). N должно быть константой.
|
||||
Если строка имеет меньше байт, чем N, то она дополняется нулевыми байтами справа. Если строка имеет больше байт, чем N - кидается исключение.
|
||||
|
||||
## toStringCutToZero(s)
|
||||
|
||||
Принимает аргумент типа String или FixedString. Возвращает String, вырезая содержимое строки до первого найденного нулевого байта.
|
||||
|
||||
Пример:
|
||||
|
||||
``` sql
|
||||
```sql
|
||||
SELECT toFixedString('foo', 8) AS s, toStringCutToZero(s) AS s_cut
|
||||
```
|
||||
|
||||
@ -72,7 +164,7 @@ SELECT toFixedString('foo', 8) AS s, toStringCutToZero(s) AS s_cut
|
||||
└───────────────┴───────┘
|
||||
```
|
||||
|
||||
``` sql
|
||||
```sql
|
||||
SELECT toFixedString('foo\0bar', 8) AS s, toStringCutToZero(s) AS s_cut
|
||||
```
|
||||
|
||||
@ -89,6 +181,7 @@ SELECT toFixedString('foo\0bar', 8) AS s, toStringCutToZero(s) AS s_cut
|
||||
## reinterpretAsFloat32, reinterpretAsFloat64
|
||||
|
||||
## reinterpretAsDate, reinterpretAsDateTime
|
||||
|
||||
Функции принимают строку и интерпретируют байты, расположенные в начале строки, как число в host order (little endian). Если строка имеет недостаточную длину, то функции работают так, как будто строка дополнена необходимым количеством нулевых байт. Если строка длиннее, чем нужно, то лишние байты игнорируются. Дата интерпретируется, как число дней с начала unix-эпохи, а дата-с-временем - как число секунд с начала unix-эпохи.
|
||||
|
||||
## reinterpretAsString
|
||||
@ -100,7 +193,7 @@ SELECT toFixedString('foo\0bar', 8) AS s, toStringCutToZero(s) AS s_cut
|
||||
|
||||
Пример:
|
||||
|
||||
``` sql
|
||||
```sql
|
||||
SELECT
|
||||
'2016-06-15 23:00:00' AS timestamp,
|
||||
CAST(timestamp AS DateTime) AS datetime,
|
||||
|
||||
@ -107,7 +107,7 @@ class SSHConnection(object):
|
||||
def debsign(path, gpg_passphrase, gpg_sec_key_path, gpg_pub_key_path, gpg_user):
|
||||
try:
|
||||
with GpgKey(gpg_sec_key_path, gpg_pub_key_path):
|
||||
cmd = ('debsign -k {key} -p"gpg --verbose --no-use-agent --batch '
|
||||
cmd = ('debsign -k \'{key}\' -p"gpg --verbose --no-use-agent --batch '
|
||||
'--no-tty --passphrase {passphrase}" {path}/*.changes').format(
|
||||
key=gpg_user, passphrase=gpg_passphrase, path=path)
|
||||
logging.info("Build debsign cmd '%s'", cmd)
|
||||
|
||||
Loading…
Reference in New Issue
Block a user