メインコンテンツへスキップ
メインコンテンツへスキップ

Debian/UbuntuへのClickHouseのインストール

DebianまたはUbuntuでは、公式のプリコンパイル済みdebパッケージの使用を推奨します。

Debian リポジトリの設定​

ClickHouse をインストールするには、次のコマンドを実行します。

# 前提パッケージをインストール \{#install-prerequisite-packages}
sudo apt-get install -y apt-transport-https ca-certificates curl gnupg

# ClickHouse の GPG キーをダウンロードしてキーリングに保存する \{#download-the-clickhouse-gpg-key-and-store-it-in-the-keyring}
curl -fsSL 'https://packages.clickhouse.com/rpm/lts/repodata/repomd.xml.key' | sudo gpg --dearmor -o /usr/share/keyrings/clickhouse-keyring.gpg

# システムのアーキテクチャを取得する \{#get-the-system-architecture}
ARCH=$(dpkg --print-architecture)

# ClickHouse リポジトリを apt のソースリストに追加する \{#add-the-clickhouse-repository-to-apt-sources}
echo "deb [signed-by=/usr/share/keyrings/clickhouse-keyring.gpg arch=${ARCH}] https://packages.clickhouse.com/deb stable main" | sudo tee /etc/apt/sources.list.d/clickhouse.list

# apt パッケージリストを更新する \{#update-apt-package-lists}
sudo apt-get update
  • 必要に応じて、stableをltsに置き換えることで、異なるリリース種別を使用できます。
  • packages.clickhouse.comからパッケージを手動でダウンロードしてインストールすることもできます。

debパッケージをインストールする旧ディストリビューション方式
# 前提パッケージのインストール \{#install-prerequisite-packages}
sudo apt-get install apt-transport-https ca-certificates dirmngr

# パッケージの認証に使用する ClickHouse の GPG キーを追加する \{#add-the-clickhouse-gpg-key-to-authenticate-packages}
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv 8919F6BD2B48D754

# APT のソースリストに ClickHouse リポジトリを追加する \{#add-the-clickhouse-repository-to-apt-sources}
echo "deb https://packages.clickhouse.com/deb stable main" | sudo tee \
    /etc/apt/sources.list.d/clickhouse.list

# apt パッケージリストを更新 \{#update-apt-package-lists}
sudo apt-get update

# ClickHouse サーバーおよびクライアントのパッケージをインストールする \{#install-clickhouse-server-and-client-packages}
sudo apt-get install -y clickhouse-server clickhouse-client

# ClickHouse サーバーのサービスを起動する \{#start-the-clickhouse-server-service}
sudo service clickhouse-server start

# ClickHouse コマンドラインクライアントを起動する \{#launch-the-clickhouse-command-line-client}
clickhouse-client # パスワードを設定している場合は "clickhouse-client --password" を使用します。

ClickHouse サーバーとクライアントのインストール​

sudo apt-get install -y clickhouse-server clickhouse-client

ClickHouse を起動する​

ClickHouse サーバーを起動するには、次のコマンドを実行します。

sudo service clickhouse-server start

ClickHouse クライアントを起動するには、次のコマンドを実行します:

clickhouse-client

サーバーにパスワードを設定している場合は、次のコマンドを実行します。

clickhouse-client --password

スタンドアロン構成の ClickHouse Keeper をインストールする​

ヒント

本番環境では、ClickHouse Keeper を専用ノード上で実行することを強く推奨します。 テスト環境で ClickHouse Server と ClickHouse Keeper を同一サーバー上で実行する場合は、 ClickHouse Server に ClickHouse Keeper が同梱されているため、ClickHouse Keeper を別途インストールする必要はありません。

スタンドアロン構成の ClickHouse Keeper サーバーに clickhouse-keeper をインストールするには、次のコマンドを実行します。

sudo apt-get install -y clickhouse-keeper

ClickHouse Keeper を有効化して起動する​

sudo systemctl enable clickhouse-keeper
sudo systemctl start clickhouse-keeper
sudo systemctl status clickhouse-keeper

パッケージ​

利用可能な各種 deb パッケージの詳細は次のとおりです。

パッケージ名説明
clickhouse-common-staticClickHouse のコンパイル済みバイナリファイルをインストールします。
clickhouse-serverclickhouse-server のシンボリックリンクを作成し、デフォルトのサーバー設定ファイルをインストールします。
clickhouse-clientclickhouse-client およびその他のクライアント関連ツールのシンボリックリンクを作成し、クライアント設定ファイルをインストールします。
clickhouse-common-static-dbgデバッグ情報付きの ClickHouse のコンパイル済みバイナリファイルをインストールします。
clickhouse-keeper専用の ClickHouse Keeper ノードに ClickHouse Keeper をインストールするために使用します。ClickHouse server と同じサーバー上で ClickHouse Keeper を実行している場合、このパッケージをインストールする必要はありません。ClickHouse Keeper 本体とデフォルトの ClickHouse Keeper 設定ファイルをインストールします。

参考文献

特定のバージョンの ClickHouse をインストールする必要がある場合は、同じバージョンのパッケージをすべてインストールする必要があります: sudo apt-get install clickhouse-server=21.8.5.7 clickhouse-client=21.8.5.7 clickhouse-common-static=21.8.5.7