Skip to main content
clickhouse-local — это CLI с встроенной версией ClickHouse. Он дает пользователям возможности ClickHouse без необходимости устанавливать сервер. В этом руководстве мы рассмотрим, как использовать базу данных clickhouse-local из chDB.

Настройка

Сначала создадим виртуальное окружение:
А теперь установим chDB. Убедитесь, что у вас версия 2.0.2 или выше:
А теперь установим IPython:
Мы будем использовать ipython для выполнения команд далее по тексту руководства; запустить его можно командой:

Установка clickhouse-local

Скачивание и установка clickhouse-local выполняются так же, как скачивание и установка ClickHouse. Для этого выполните следующую команду:
Чтобы запустить clickhouse-local так, чтобы данные сохранялись в каталоге, нужно передать --path:

Ингестия данных в clickhouse-local

База данных по умолчанию хранит данные только в памяти, поэтому нужно создать отдельную именованную базу данных, чтобы все загружаемые нами данные сохранялись на диске.
Давайте создадим таблицу и вставим в неё несколько случайных чисел:
Давайте напишем запрос и посмотрим, какие данные у нас есть:
После этого обязательно выйдите из CLI с помощью exit;, поскольку блокировку этого каталога может удерживать только один процесс. Иначе при попытке подключиться к базе данных из chDB мы получим следующую ошибку:

Подключение к базе данных clickhouse-local

Вернитесь в оболочку ipython и импортируйте из chDB модуль session:
Инициализируйте сеанс для demo.chdb:
Затем можно выполнить тот же запрос, который возвращает квантили чисел:
Мы также можем вставлять данные в эту базу данных с помощью chDB:
Затем можно снова выполнить запрос на вычисление квантилей в chDB или clickhouse-local.
Последнее изменение 3 июля 2026 г.