2020-12-23 15:32:35 +00:00
|
|
|
|
---
|
2022-08-26 17:37:11 +00:00
|
|
|
|
slug: /ru/engines/table-engines/integrations/embedded-rocksdb
|
2022-04-09 13:29:05 +00:00
|
|
|
|
sidebar_position: 9
|
|
|
|
|
sidebar_label: EmbeddedRocksDB
|
2020-12-23 15:32:35 +00:00
|
|
|
|
---
|
|
|
|
|
|
2021-01-26 19:24:06 +00:00
|
|
|
|
# Движок EmbeddedRocksDB {#EmbeddedRocksDB-engine}
|
2020-12-23 15:32:35 +00:00
|
|
|
|
|
|
|
|
|
Этот движок позволяет интегрировать ClickHouse с [rocksdb](http://rocksdb.org/).
|
|
|
|
|
|
2020-12-25 12:05:23 +00:00
|
|
|
|
## Создание таблицы {#table_engine-EmbeddedRocksDB-creating-a-table}
|
2020-12-23 15:32:35 +00:00
|
|
|
|
|
|
|
|
|
``` sql
|
|
|
|
|
CREATE TABLE [IF NOT EXISTS] [db.]table_name [ON CLUSTER cluster]
|
|
|
|
|
(
|
|
|
|
|
name1 [type1] [DEFAULT|MATERIALIZED|ALIAS expr1],
|
|
|
|
|
name2 [type2] [DEFAULT|MATERIALIZED|ALIAS expr2],
|
|
|
|
|
...
|
2021-07-29 15:20:55 +00:00
|
|
|
|
) ENGINE = EmbeddedRocksDB
|
2020-12-25 12:08:22 +00:00
|
|
|
|
PRIMARY KEY(primary_key_name);
|
2020-12-23 15:32:35 +00:00
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
Обязательные параметры:
|
|
|
|
|
|
2021-01-26 19:24:06 +00:00
|
|
|
|
- `primary_key_name` может быть любое имя столбца из списка столбцов.
|
2021-07-29 15:20:55 +00:00
|
|
|
|
- Указание первичного ключа `primary key` является обязательным. Он будет сериализован в двоичном формате как ключ `rocksdb`.
|
2021-01-26 19:24:06 +00:00
|
|
|
|
- Поддерживается только один столбец в первичном ключе.
|
2021-07-29 15:20:55 +00:00
|
|
|
|
- Столбцы, которые отличаются от первичного ключа, будут сериализованы в двоичном формате как значение `rockdb` в соответствующем порядке.
|
2021-01-26 19:24:06 +00:00
|
|
|
|
- Запросы с фильтрацией по ключу `equals` или `in` оптимизируются для поиска по нескольким ключам из `rocksdb`.
|
2020-12-23 15:32:35 +00:00
|
|
|
|
|
|
|
|
|
Пример:
|
|
|
|
|
|
|
|
|
|
``` sql
|
|
|
|
|
CREATE TABLE test
|
|
|
|
|
(
|
|
|
|
|
`key` String,
|
|
|
|
|
`v1` UInt32,
|
|
|
|
|
`v2` String,
|
|
|
|
|
`v3` Float32,
|
|
|
|
|
)
|
|
|
|
|
ENGINE = EmbeddedRocksDB
|
2020-12-25 12:08:35 +00:00
|
|
|
|
PRIMARY KEY key;
|
2021-01-26 19:24:06 +00:00
|
|
|
|
```
|