[go: up one dir, main page]
メインコンテンツまでスキップ
メインコンテンツまでスキップ

clickhouse-local データベースの使用

clickhouse-local は、埋め込み版の ClickHouse を持つ CLI です。これにより、サーバーをインストールすることなく ClickHouse の機能をユーザーに提供します。このガイドでは、chDB から clickhouse-local データベースを使用する方法を学びます。

セットアップ​

まずは仮想環境を作成します：

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] │
└───────────────────────────────────────┘

これが完了したら、CLI から exit; することを忘れないでください。このディレクトリにロックを保持できるのは一つのプロセスだけだからです。それを行わないと、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 シェルに戻り、chDB から session モジュールをインポートします：

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 から分位数クエリを再実行できます。