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

clickhouse-local は、埋め込まれたClickHouseのバージョンを持つCLIです。サーバーのインストールを必要とせずに、ユーザーにClickHouseの力を提供します。このガイドでは、chDBを使ってclickhouse-localデータベースを使用する方法を学びます。

セットアップ

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

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

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

ipythonを使用して、ガイドの残りの部分のコマンドを実行します。以下のコマンドで起動できます：

clickhouse-localのダウンロードとインストールは、ClickHouseのダウンロードとインストールと同じです。以下のコマンドを実行することで行えます：

データをディレクトリに永続化するためにclickhouse-localを起動するには、--pathを渡す必要があります：

デフォルトのデータベースはメモリ内にのみデータを保存するため、データをディスクに永続化するには名前付きデータベースを作成する必要があります。

テーブルを作成して、ランダムな数値をいくつか挿入しましょう：

どのようなデータがあるか確認するためのクエリを書くことにしましょう：

これが終わったら、CLIからexit;してください。1つのプロセスのみがこのディレクトリのロックを保持できます。これを行わないと、chDBからデータベースに接続しようとしたときに以下のエラーが発生します：

ipythonシェルに戻り、chDBからsessionモジュールをインポートします：

demo.chdbを指すセッションを初期化します：

次に、数値の分位数を返す同じクエリを実行できます：

また、このデータベースにchDBからデータを挿入することもできます：

その後、chDBまたはclickhouse-localから分位数クエリを再実行できます。