ClickHouse CLI でインストールする

clickhousectl（ClickHouse CLI）を使用してローカルの ClickHouse バージョンをインストールおよび管理します

Windows ユーザー

ClickHouse は Linux と macOS 上でネイティブに動作します。Windows では、これらの手順を Windows Subsystem for Linux (WSL) 内で実行してください。

ClickHouse CLI (clickhousectl) を使用すると、ローカルの ClickHouse バージョンの インストールと管理、サーバーの起動、クエリの実行を行えます。

1. ​

   ClickHouse CLI をインストールする

   curl https://clickhouse.com/cli | sh
   

   利便性のため、chctl エイリアスも自動的に作成されます。

2. ​

   ClickHouse をインストールする

   最新バージョンの ClickHouse をインストールし、デフォルトに設定します。

   clickhousectl local use latest
   

   local use は、そのバージョンがまだインストールされていない場合はインストールし、 デフォルトに設定したうえで、~/.local/bin (PATH 上) に clickhouse の シンボリックリンクを作成します。これにより、clickhouse バイナリを直接 実行できます。このドキュメント内で後続の手順に clickhouse コマンドが出てきても、 そのまま実行できます。

   特定のバージョンを選択することもできます。

   clickhousectl local use 26.5            # Latest 26.5.x.x
   clickhousectl local use 26.5.2.39       # Exact version
   

   use と install の違い

   clickhousectl local use <version> は、バージョンをインストールし、さらにそれを デフォルトに設定して、PATH 上の clickhouse シンボリックリンクを更新します。 デフォルトを変更せず、シンボリックリンクも更新せずにバージョンだけをダウンロード したい場合は、代わりに clickhousectl local install <version> を使用してください。

3. ​

   clickhouse-server を起動する

   clickhousectl local server start
   

   サーバーはバックグラウンドで実行されます。実行中であることを確認するには、次を実行します。

   clickhousectl local server list
   
4. ​

   clickhouse-client を起動する

   clickhousectl local client
   

   次のような表示が出ます。

   ClickHouse client version 24.5.1.117 (official build).
   Connecting to localhost:9000 as user default.
   Connected to ClickHouse server version 24.5.1.
   
   local-host :)
   

   これで、ClickHouse に SQL コマンドを送信する準備が整いました。

   クイックスタート では、テーブルの作成とデータの挿入手順を順を追って説明しています。