Перейти к основному содержимому
Перейти к основному содержимому

Установка ClickHouse с помощью Homebrew

Примечание

Установка с использованием формулы Homebrew устарела и будет отключена 2026-09-01. Мы рекомендуем вместо этого использовать метод быстрой установки, который работает на любой платформе.

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

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

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

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

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

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

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

Установка с использованием community-формулы Homebrew​

Чтобы установить ClickHouse на macOS с помощью Homebrew, вы можете использовать формулу Homebrew, поддерживаемую сообществом ClickHouse.

brew install --cask clickhouse

Исправление ошибки проверки разработчика в macOS​

Если вы устанавливаете ClickHouse с помощью brew, вы можете столкнуться с ошибкой со стороны macOS. По умолчанию macOS не запускает приложения или инструменты, созданные разработчиком, подлинность которого не может быть подтверждена.

При попытке выполнить любую команду clickhouse вы можете увидеть такую ошибку:

Диалоговое окно ошибки проверки разработчика в macOS

Чтобы обойти эту ошибку проверки, нужно убрать приложение из карантина macOS — либо найдя соответствующую настройку в окне System Settings, используя терминал, либо переустановив ClickHouse.

Процесс через системные настройки​

Самый простой способ убрать исполняемый файл clickhouse из карантина:

  1. Откройте System Settings.

  2. Перейдите в Privacy & Security:

    Стандартный вид настроек Privacy & Security в macOS

  3. Пролистайте окно вниз до сообщения вида "clickhouse-macos-aarch64" was blocked from use because it isn't from an identified developer".

  4. Нажмите Allow Anyway.

    Настройки Privacy & Security в macOS с кнопкой Allow Anyway

  5. Введите пароль пользователя macOS.

Теперь вы должны иметь возможность запускать команды clickhouse в терминале.

Процесс через терминал​

Иногда нажатие кнопки Allow Anyway не решает эту проблему, и в этом случае вы можете выполнить этот процесс через командную строку. Или вы можете просто предпочитать использовать командную строку!

Сначала выясните, куда Homebrew установил исполняемый файл clickhouse:

which clickhouse

Должно получиться что-то вроде этого:

/opt/homebrew/bin/clickhouse

Удалите файл clickhouse из карантина, выполнив xattr -d com.apple.quarantine с путем, полученным из предыдущей команды:

xattr -d com.apple.quarantine /opt/homebrew/bin/clickhouse

Теперь вы можете запустить исполняемый файл clickhouse:

clickhouse

Должно получиться примерно следующее:

Use one of the following commands:
clickhouse local [args]
clickhouse client [args]
clickhouse benchmark [args]

Устранение проблемы путем повторной установки ClickHouse​

В brew есть параметр командной строки, который изначально предотвращает помещение установленных бинарных файлов в карантин.

Сначала удалите ClickHouse:

brew uninstall clickhouse

Теперь переустановите ClickHouse с параметром --no-quarantine:

brew install --no-quarantine clickhouse