mirror of
https://github.com/ClickHouse/ClickHouse.git
synced 2024-11-29 02:52:13 +00:00
Translate to Russian
This commit is contained in:
Dmitriy
parent
e40c7017b4
commit
6c58e7ad7b
@ -54,7 +54,7 @@ ClickHouse может принимать (`INSERT`) и отдавать (`SELECT
|
|||||||
| [Native](#native) | ✔ | ✔ |
|
| [Native](#native) | ✔ | ✔ |
|
||||||
| [Null](#null) | ✗ | ✔ |
|
| [Null](#null) | ✗ | ✔ |
|
||||||
| [XML](#xml) | ✗ | ✔ |
|
| [XML](#xml) | ✗ | ✔ |
|
||||||
| [CapnProto](#capnproto) | ✔ | ✗ |
|
| [CapnProto](#capnproto) | ✔ | ✔ |
|
||||||
| [LineAsString](#lineasstring) | ✔ | ✗ |
|
| [LineAsString](#lineasstring) | ✔ | ✗ |
|
||||||
| [Regexp](#data-format-regexp) | ✔ | ✗ |
|
| [Regexp](#data-format-regexp) | ✔ | ✗ |
|
||||||
| [RawBLOB](#rawblob) | ✔ | ✔ |
|
| [RawBLOB](#rawblob) | ✔ | ✔ |
|
||||||
@ -1013,12 +1013,50 @@ test: string with 'quotes' and with some special
|
|||||||
|
|
||||||
## CapnProto {#capnproto}
|
## CapnProto {#capnproto}
|
||||||
|
|
||||||
Cap’n Proto - формат бинарных сообщений, похож на Protocol Buffers и Thrift, но не похож на JSON или MessagePack.
|
CapnProto — формат бинарных сообщений, похож на [Protocol Buffers](https://developers.google.com/protocol-buffers/) и [Thrift](https://ru.wikipedia.org/wiki/Apache_Thrift), но не похож на [JSON](#json) или [MessagePack](https://msgpack.org/).
|
||||||
|
|
||||||
Сообщения Cap’n Proto строго типизированы и не самоописывающиеся, т.е. нуждаются во внешнем описании схемы. Схема применяется «на лету» и кешируется между запросами.
|
Сообщения формата CapnProto строго типизированы и не самоописывающиеся, т.е. нуждаются во внешнем описании схемы. Схема применяется "на лету" и кешируется между запросами.
|
||||||
|
|
||||||
|
Десериализация эффективна и обычно не повышает нагрузку на систему.
|
||||||
|
|
||||||
|
См. также [схема формата](#formatschema).
|
||||||
|
|
||||||
|
### Соответствие типов данных {#data_types-matching-capnproto}
|
||||||
|
|
||||||
|
Таблица ниже содержит поддерживаемые типы данных и их соответствие [типам данных](../sql-reference/data-types/index.md) ClickHouse для запросов `INSERT` и `SELECT`.
|
||||||
|
|
||||||
|
| Тип данных CapnProto (`INSERT`) | Тип данных ClickHouse | Тип данных CapnProto (`SELECT`) |
|
||||||
|
|--------------------------------|-----------------------------------------------------------|--------------------------------|
|
||||||
|
| `UINT8`, `BOOL` | [UInt8](../sql-reference/data-types/int-uint.md) | `UINT8` |
|
||||||
|
| `INT8` | [Int8](../sql-reference/data-types/int-uint.md) | `INT8` |
|
||||||
|
| `UINT16` | [UInt16](../sql-reference/data-types/int-uint.md), [Date](../sql-reference/data-types/date.md) | `UINT16` |
|
||||||
|
| `INT16` | [Int16](../sql-reference/data-types/int-uint.md) | `INT16` |
|
||||||
|
| `UINT32` | [UInt32](../sql-reference/data-types/int-uint.md), [DateTime](../sql-reference/data-types/datetime.md) | `UINT32` |
|
||||||
|
| `INT32` | [Int32](../sql-reference/data-types/int-uint.md) | `INT32` |
|
||||||
|
| `UINT64` | [UInt64](../sql-reference/data-types/int-uint.md) | `UINT64` |
|
||||||
|
| `INT64` | [Int64](../sql-reference/data-types/int-uint.md), [DateTime64](../sql-reference/data-types/datetime.md) | `INT64` |
|
||||||
|
| `FLOAT32` | [Float32](../sql-reference/data-types/float.md) | `FLOAT32` |
|
||||||
|
| `FLOAT64` | [Float64](../sql-reference/data-types/float.md) | `FLOAT64` |
|
||||||
|
| `TEXT, DATA` | [String](../sql-reference/data-types/string.md), [FixedString](../sql-reference/data-types/fixedstring.md) | `TEXT, DATA` |
|
||||||
|
| `union(T, Void), union(Void, T)` | [Nullable(T)](../sql-reference/data-types/date.md) | `union(T, Void), union(Void, T)` |
|
||||||
|
| `ENUM` | [Enum(8\|16)](../sql-reference/data-types/enum.md) | `ENUM` |
|
||||||
|
| `LIST` | [Array](../sql-reference/data-types/array.md) | `LIST` |
|
||||||
|
| `STRUCT` | [Tuple](../sql-reference/data-types/tuple.md) | `STRUCT` |
|
||||||
|
|
||||||
|
Для работы с типом данных `Enum` в формате CapnProto используйте настройку [format_capn_proto_enum_comparising_mode](../operations/settings/settings.md#format-capn-proto-enum-comparising-mode).
|
||||||
|
|
||||||
|
Массивы могут быть вложенными и иметь в качестве аргумента значение типа `Nullable`. Тип `Tuple` также может быть вложенным.
|
||||||
|
|
||||||
|
Неподдерживаемые типы данных: `TIME32`, `FIXED_SIZE_BINARY`, `JSON`, `UUID`.
|
||||||
|
|
||||||
|
Типы данных столбцов в таблицах ClickHouse могут отличаться от типов данных для соответствующих полей CapnProto. При вставке данных ClickHouse интерпретирует типы данных CapnProto согласно таблице соответствия, а затем [приводит](../sql-reference/functions/type-conversion-functions/#type_conversion_function-cast) данные к типу, установленному для столбца таблицы ClickHouse.
|
||||||
|
|
||||||
|
### Вставка и вывод данных {#inserting-and-selecting-data-capnproto}
|
||||||
|
|
||||||
|
Чтобы вставить в ClickHouse данные из файла в формате CapnProto, выполните команду следующего вида:
|
||||||
|
|
||||||
``` bash
|
``` bash
|
||||||
$ cat capnproto_messages.bin | clickhouse-client --query "INSERT INTO test.hits FORMAT CapnProto SETTINGS format_schema='schema:Message'"
|
$ cat capnproto_messages.bin | clickhouse-client --query "INSERT INTO {some_table} FORMAT CapnProto SETTINGS format_schema = 'schema:Message'"
|
||||||
```
|
```
|
||||||
|
|
||||||
Где `schema.capnp` выглядит следующим образом:
|
Где `schema.capnp` выглядит следующим образом:
|
||||||
@ -1030,9 +1068,13 @@ struct Message {
|
|||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
Десериализация эффективна и обычно не повышает нагрузку на систему.
|
Чтобы вставить данные в столбцы типа [Nested](../sql-reference/data-types/nested-data-structures/nested.md) в виде массива структур, нужно включить настройку [input_format_parquet_import_nested](../operations/settings/settings.md#input_format_parquet_import_nested).
|
||||||
|
|
||||||
См. также [схема формата](#formatschema).
|
Чтобы получить данные из таблицы ClickHouse и сохранить их в файл формата CapnProto, используйте команду следующего вида:
|
||||||
|
|
||||||
|
``` bash
|
||||||
|
$ clickhouse-client --query = "SELECT * FROM capnp_tuples FORMAT CapnProto SETTINGS format_schema = '$CLIENT_SCHEMADIR/02030_capnp_tuples:Message'"
|
||||||
|
```
|
||||||
|
|
||||||
## Protobuf {#protobuf}
|
## Protobuf {#protobuf}
|
||||||
|
|
||||||
|
|||||||
@ -3808,3 +3808,14 @@ SELECT * FROM positional_arguments ORDER BY 2,3;
|
|||||||
|
|
||||||
Значение по умолчанию: `0`.
|
Значение по умолчанию: `0`.
|
||||||
|
|
||||||
|
## format_capn_proto_enum_comparising_mode {#format-capn-proto-enum-comparising-mode}
|
||||||
|
|
||||||
|
Определяет, как сопоставить тип данных ClickHouse `Enum` и тип данных `Enum` формата CapnProto из схемы.
|
||||||
|
|
||||||
|
Возможные значения:
|
||||||
|
|
||||||
|
- `'by_values'` — значения в перечислениях должны быть одинаковыми, а имена могут быть разными.
|
||||||
|
- `'by_names'` — имена в перечислениях должны быть одинаковыми, а значения могут быть разными.
|
||||||
|
- `'by_name_case_insensitive'` — имена в перечислениях должны быть одинаковыми без учета регистра, а значения могут быть разными.
|
||||||
|
|
||||||
|
Значение по умолчанию: `'by_values'`.
|
||||||
|
|||||||
Loading…
Reference in New Issue
Block a user