Установка ClickHouse на Debian/Ubuntu

Рекомендуется использовать официальные предкомпилированные пакеты deb для Debian или Ubuntu.

Настройка репозитория Debian

Чтобы установить ClickHouse, выполните следующие команды:

# Установите необходимые пакеты \{#install-prerequisite-packages}
sudo apt-get install -y apt-transport-https ca-certificates curl gnupg

# Загрузите GPG‑ключ ClickHouse и сохраните его в ключевом хранилище \{#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

# Добавьте GPG-ключ ClickHouse для аутентификации пакетов \{#add-the-clickhouse-gpg-key-to-authenticate-packages}
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv 8919F6BD2B48D754

# Добавьте репозиторий ClickHouse в список источников APT \{#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 Keeper, так как он включён в ClickHouse Server.

Чтобы установить 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-пакеты описаны ниже:

Package	Description
clickhouse-common-static	Устанавливает скомпилированные бинарные файлы ClickHouse.
clickhouse-server	Создает символическую ссылку для clickhouse-server и устанавливает конфигурацию сервера по умолчанию.
clickhouse-client	Создает символическую ссылку для clickhouse-client и другие клиентские утилиты, а также устанавливает файлы конфигурации клиента.
clickhouse-common-static-dbg	Устанавливает скомпилированные бинарные файлы ClickHouse с отладочной информацией.
clickhouse-keeper	Используется для установки ClickHouse Keeper на выделенные узлы ClickHouse Keeper. Если вы запускаете ClickHouse Keeper на том же сервере, что и сервер ClickHouse, устанавливать этот пакет не нужно. Устанавливает 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