Перейти к основному содержимому
Перейти к основному содержимому

Использование базы данных clickhouse-local

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

Настройка​

Давайте сначала создадим виртуальную среду:

python -m venv .venv
source .venv/bin/activate

Теперь мы установим chDB.
Убедитесь, что у вас версия 2.0.2 или выше:

pip install "chdb>=2.0.2"

Теперь мы установим ipython:

pip install ipython

Мы будем использовать ipython для выполнения команд в остальной части руководства, который вы можете запустить, выполнив:

ipython

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

Скачивание и установка clickhouse-local такие же, как скачивание и установка ClickHouse.
Мы можем сделать это, выполнив следующую команду:

curl https://clickhouse.com/ | sh

Чтобы запустить clickhouse-local с сохранением данных в директории, нам нужно передать --path:

./clickhouse -m --path demo.chdb

Прием данных в clickhouse-local​

База данных по умолчанию хранит данные только в памяти, поэтому нам нужно создать именованную базу данных, чтобы убедиться, что любые данные, которые мы вводим, сохраняются на диске.

CREATE DATABASE foo;

Давайте создадим таблицу и вставим несколько случайных чисел:

CREATE TABLE foo.randomNumbers
ORDER BY number AS
SELECT rand() AS number
FROM numbers(10_000_000);

Давайте напишем запрос, чтобы увидеть, какие данные у нас есть:

SELECT quantilesExact(0, 0.5, 0.75, 0.99)(number) AS quants
FROM foo.randomNumbers

┌─quants────────────────────────────────┐
│ [69,2147776478,3221525118,4252096960] │
└───────────────────────────────────────┘

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

ChdbError: Code: 76. DB::Exception: Cannot lock file demo.chdb/status. Another server instance in same directory is already running. (CANNOT_OPEN_FILE)

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

Вернитесь в оболочку ipython и импортируйте модуль session из chDB:

from chdb import session as chs

Инициализируйте сессию, указывая на demo.chdb:

sess = chs.Session("demo.chdb")

Теперь мы можем выполнить тот же запрос, который возвращает квантили чисел:

sess.query("""
SELECT quantilesExact(0, 0.5, 0.75, 0.99)(number) AS quants
FROM foo.randomNumbers
""", "Vertical")

Row 1:
──────
quants: [0,9976599,2147776478,4209286886]

Мы также можем вставить данные в эту базу данных из chDB:

sess.query("""
INSERT INTO foo.randomNumbers
SELECT rand() AS number FROM numbers(10_000_000)
""")

Row 1:
──────
quants: [0,9976599,2147776478,4209286886]

Затем мы можем повторно выполнить запрос на квантили из chDB или clickhouse-local.