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

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

Ознакомьтесь с рекомендациями

Перед установкой ClickHouse ознакомьтесь со следующими рекомендациями:

• Swap: Отключите файл подкачки операционной системы в продакшен-среде.
• Disk space: Для установки ClickHouse требуется не менее 2,5 ГБ дискового пространства.
• Network: Для распределённых развертываний (кластеризации) используйте сеть с пропускной способностью не менее 10 Гбит/с. Пропускная способность сети критически важна для обработки распределённых запросов с большими объёмами промежуточных данных, а также для репликации.

Оценка требований к хранилищу

Чтобы оценить объём дискового пространства, необходимый для ваших данных:

1. Оцените объём данных: Возьмите выборку данных и вычислите средний размер строки, затем умножьте его на количество строк, которое вы планируете хранить.
2. Примените коэффициент сжатия: Загрузите выборку в ClickHouse и сравните исходный размер данных с размером таблицы на диске. Например, данные clickstream обычно сжимаются в 6–10 раз.
3. Учтите реплики: Если вы планируете хранить данные в нескольких репликах, умножьте расчётный объём на количество реплик.

Более подробные требования к оборудованию см. в разделе "Подбор размера и рекомендации по оборудованию"

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

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

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

# Скачайте GPG-ключ ClickHouse и сохраните его в хранилище ключей
curl -fsSL 'https://packages.clickhouse.com/rpm/lts/repodata/repomd.xml.key' | sudo gpg --dearmor -o /usr/share/keyrings/clickhouse-keyring.gpg

# Определите архитектуру системы
ARCH=$(dpkg --print-architecture)

# Добавьте репозиторий ClickHouse в источники apt
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
sudo apt-get update

• Вы можете заменить stable на lts, чтобы использовать другой тип релиза в зависимости от ваших потребностей.
• Вы можете скачать и установить пакеты вручную с packages.clickhouse.com.

Устаревший способ установки deb-пакетов через дистрибутивы

# Установите необходимые пакеты
sudo apt-get install apt-transport-https ca-certificates dirmngr

# Добавьте GPG-ключ ClickHouse для аутентификации пакетов
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv 8919F6BD2B48D754

# Добавьте репозиторий ClickHouse в источники apt
echo "deb https://packages.clickhouse.com/deb stable main" | sudo tee \
    /etc/apt/sources.list.d/clickhouse.list
    
# Обновите списки пакетов apt
sudo apt-get update

# Установите пакеты сервера и клиента ClickHouse
sudo apt-get install -y clickhouse-server clickhouse-client

# Запустите службу сервера ClickHouse
sudo service clickhouse-server start

# Запустите клиент командной строки ClickHouse
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.

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