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

Использование базы данных 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.