メインコンテンツへスキップ
clickhouse-local は、ClickHouse を組み込んだ CLI ツールです。 サーバーをインストールしなくても、ClickHouse の機能を利用できます。 このガイドでは、chDB から clickhouse-local データベースを使用する方法を学びます。

セットアップ

まずは、仮想環境を作成します。
それでは、chDB をインストールします。 バージョン 2.0.2 以上であることを確認してください。
それでは、ipython をインストールしましょう。
このガイドの以降の手順では、コマンドの実行にipythonを使用します。起動するには、次を実行します。

clickhouse-local のインストール

clickhouse-local のダウンロードとインストールは、ClickHouse のダウンロードとインストールと同じです。 次のコマンドを実行します。
データをディレクトリに永続化した状態で clickhouse-local を起動するには、--path を指定する必要があります:

clickhouse-local にデータを取り込む

デフォルトのデータベースはデータをメモリ内にしか保存しないため、取り込んだデータが確実にディスクへ永続化されるよう、名前付きのデータベースを作成する必要があります。
テーブルを作成し、ランダムな数値をいくつか挿入してみましょう:
どのようなデータがあるかを確認するために、クエリを書いてみましょう。
それが終わったら、このディレクトリのロックを保持できるプロセスは1つだけなので、CLI で必ず exit; してください。 そうしないと、chDB からデータベースに接続しようとしたときに、次のエラーが発生します:

clickhouse-local データベースへの接続

ipython シェルに戻り、chDB から session モジュールをインポートします。
demo.chdb を指定したセッションを初期化します:
次に、数値の分位点を返す同じクエリを実行できます:
chDB からこのデータベースにデータを挿入することもできます:
その後、chDB または clickhouse-local で分位点クエリを再実行できます。
最終更新日 2026年6月19日