> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-home-button.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
> Этот движок позволяет интегрировать ClickHouse с RocksDB
# Движок таблицы EmbeddedRocksDB
export const CloudNotSupportedBadge = () => {
return
Not supported in ClickHouse Cloud
;
};
Этот движок позволяет интегрировать ClickHouse с [RocksDB](http://rocksdb.org/).
## Создание таблицы
```sql theme={null}
CREATE TABLE [IF NOT EXISTS] [db.]table_name [ON CLUSTER cluster]
(
name1 [type1] [DEFAULT|MATERIALIZED|ALIAS expr1],
name2 [type2] [DEFAULT|MATERIALIZED|ALIAS expr2],
...
) ENGINE = EmbeddedRocksDB([ttl, rocksdb_dir, read_only]) PRIMARY KEY(primary_key_name)
[ SETTINGS name=value, ... ]
```
Параметры движка:
* `ttl` - время жизни значений. TTL указывается в секундах. Если TTL равен 0, используется обычный экземпляр RocksDB (без TTL).
* `rocksdb_dir` - путь к каталогу существующей RocksDB или путь назначения для создаваемой RocksDB. Таблица открывается с указанным `rocksdb_dir`.
* `read_only` - если `read_only` установлено в true, используется режим только для чтения. Для хранилища с TTL compaction не будет запускаться ни вручную, ни автоматически, поэтому записи с истекшим сроком жизни не будут удаляться.
* `primary_key_name` – любое имя столбца в списке столбцов.
* `primary key` должен быть указан; поддерживается только один столбец в первичном ключе. Первичный ключ будет сериализован в бинарном виде как `rocksdb key`.
* столбцы, кроме первичного ключа, будут сериализованы в бинарном виде как значение `rocksdb` в соответствующем порядке.
* запросы с фильтрацией по ключу через `equals` или `in` будут оптимизированы в поиск по нескольким ключам в `rocksdb`.
Настройки движка:
* `optimize_for_bulk_insert` – таблица оптимизирована для массовых вставок (конвейер вставки будет создавать SST-файлы и импортировать их в базу данных rocksdb вместо записи в memtables); значение по умолчанию: `1`.
* `bulk_insert_block_size` - минимальный размер SST-файлов (в строках), создаваемых при массовой вставке; значение по умолчанию: `1048449`.
Пример:
```sql theme={null}
CREATE TABLE test
(
`key` String,
`v1` UInt32,
`v2` String,
`v3` Float32
)
ENGINE = EmbeddedRocksDB
PRIMARY KEY key
```
## Метрики
Также есть таблица `system.rocksdb`, в которой представлена статистика RocksDB:
```sql theme={null}
SELECT
name,
value
FROM system.rocksdb
┌─name──────────────────────┬─value─┐
│ no.file.opens │ 1 │
│ number.block.decompressed │ 1 │
└───────────────────────────┴───────┘
```
## Конфигурация
Вы также можете изменить любые [параметры RocksDB](https://github.com/facebook/rocksdb/wiki/Option-String-and-Option-Map) с помощью config:
```xml theme={null}
8
2
```
По умолчанию оптимизация приблизительного простого подсчёта отключена, что может повлиять на производительность запросов `count()`. Чтобы включить эту
оптимизацию, задайте `optimize_trivial_approximate_count_query = 1`. Этот параметр также влияет на `system.tables` для движка EmbeddedRocksDB:
включите его, чтобы видеть приблизительные значения `total_rows` и `total_bytes`.
## Поддерживаемые операции
### Вставки
При вставке новых строк в `EmbeddedRocksDB`, если ключ уже существует, значение обновляется; в противном случае создаётся новый ключ.
Пример:
```sql theme={null}
INSERT INTO test VALUES ('some key', 1, 'value', 3.2);
```
### Удаление
Строки можно удалить с помощью запроса `DELETE` или команды `TRUNCATE`.
```sql theme={null}
DELETE FROM test WHERE key LIKE 'some%' AND v1 > 1;
```
```sql theme={null}
ALTER TABLE test DELETE WHERE key LIKE 'some%' AND v1 > 1;
```
```sql theme={null}
TRUNCATE TABLE test;
```
### Обновления
Значения можно изменять с помощью запроса `ALTER TABLE`. Первичный ключ изменять нельзя.
```sql theme={null}
ALTER TABLE test UPDATE v1 = v1 * 10 + 2 WHERE key LIKE 'some%' AND v3 > 3.1;
```
### Операции JOIN
Поддерживается специальный `direct` JOIN с таблицами EmbeddedRocksDB.
Этот `direct` JOIN позволяет избежать создания хеш-таблицы в памяти и обращаться
к данным напрямую в EmbeddedRocksDB.
При больших JOIN использование памяти при `direct` JOIN может быть значительно ниже,
поскольку хеш-таблица не создаётся.
Чтобы включить `direct` JOIN:
```sql theme={null}
SET join_algorithm = 'direct, hash'
```
Когда для `join_algorithm` задано значение `direct, hash`, по возможности будет использоваться direct JOIN,
а в остальных случаях — hash.
#### Пример
##### Создайте и заполните таблицу EmbeddedRocksDB
```sql theme={null}
CREATE TABLE rdb
(
`key` UInt32,
`value` Array(UInt32),
`value2` String
)
ENGINE = EmbeddedRocksDB
PRIMARY KEY key
```
```sql theme={null}
INSERT INTO rdb
SELECT
toUInt32(sipHash64(number) % 10) AS key,
[key, key+1] AS value,
('val2' || toString(key)) AS value2
FROM numbers_mt(10);
```
##### Создайте и заполните таблицу для выполнения JOIN с таблицей `rdb`
```sql theme={null}
CREATE TABLE t2
(
`k` UInt16
)
ENGINE = TinyLog
```
```sql theme={null}
INSERT INTO t2 SELECT number AS k
FROM numbers_mt(10)
```
##### Установите для алгоритма JOIN значение `direct`
```sql theme={null}
SET join_algorithm = 'direct'
```
##### INNER JOIN
```sql theme={null}
SELECT *
FROM
(
SELECT k AS key
FROM t2
) AS t2
INNER JOIN rdb ON rdb.key = t2.key
ORDER BY key ASC
```
```response theme={null}
┌─key─┬─rdb.key─┬─value──┬─value2─┐
│ 0 │ 0 │ [0,1] │ val20 │
│ 2 │ 2 │ [2,3] │ val22 │
│ 3 │ 3 │ [3,4] │ val23 │
│ 6 │ 6 │ [6,7] │ val26 │
│ 7 │ 7 │ [7,8] │ val27 │
│ 8 │ 8 │ [8,9] │ val28 │
│ 9 │ 9 │ [9,10] │ val29 │
└─────┴─────────┴────────┴────────┘
```
### Подробнее о JOIN
* [настройка `join_algorithm`](/ru/reference/settings/session-settings#join_algorithm)
* [оператор JOIN](/ru/reference/statements/select/join)