Using a clickhouse-local database

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

セットアップ

まず、仮想環境を作成しましょう：

次に、chDB をインストールします。
バージョン 2.0.2 以上を確認してください：

次に、ipython をインストールします：

このガイドの残りのコマンドを実行するために 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 から分位数のクエリを再実行できます。