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

Быстрый старт

Обзор​

Настройте ClickHouse быстро. Скачайте подходящий бинарный файл для вашей ОС, узнайте, как запустить сервер ClickHouse, создать таблицу, вставить данные в неё и запросить вашу таблицу с помощью клиента ClickHouse.

Предварительные требования​

Вам понадобится curl или другой клиент HTTP командной строки для получения бинарного файла ClickHouse.

Скачайте бинарный файл​

ClickHouse работает на Linux, FreeBSD и macOS, а также запускается на Windows через WSL. Самый простой способ скачать ClickHouse локально - это выполнить следующую команду curl. Она определяет, поддерживается ли ваша операционная система, а затем скачивает подходящий бинарный файл ClickHouse.

примечание

Мы рекомендуем выполнять команду ниже из новой и пустой подкаталога, так как некоторые файлы конфигурации будут созданы в директории, где находится бинарный файл, когда сервер ClickHouse запустится в первый раз.

Вы должны увидеть:

На этом этапе вы можете проигнорировать предложенный запрос выполнить команду install.

примечание

Для пользователей Mac: Если вы получаете ошибки о том, что разработчик бинарного файла не может быть проверен, пожалуйста, посмотрите "Исправление ошибки проверки разработчика в MacOS".

Запустите сервер​

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

Вы должны увидеть, как терминал заполняется логами. Это ожидаемо. В ClickHouse уровень логирования по умолчанию установлен на trace, а не warning.

Запустите клиент​

Используйте clickhouse-client, чтобы подключиться к вашему сервису ClickHouse. Откройте новое окно терминала, перейдите в каталог, где сохранен ваш бинарный файл clickhouse, и выполните следующую команду:

Вы должны увидеть улыбающееся лицо, когда он подключается к вашему сервису, запущенному на localhost:

Создайте таблицу​

Используйте CREATE TABLE, чтобы определить новую таблицу. Типичные команды SQL DDL работают в ClickHouse с одним добавлением - таблицы в ClickHouse требуют клаузы ENGINE. Используйте MergeTree, чтобы воспользоваться преимуществами производительности ClickHouse:

Вставьте данные​

Вы можете использовать знакомую команду INSERT INTO TABLE с ClickHouse, но важно понимать, что каждое вставление в таблицу MergeTree приводит к созданию того, что мы называем частью в ClickHouse. Эти части затем объединяются ClickHouse в фоновом режиме.

В ClickHouse мы стараемся вставлять много строк за раз (десятки тысяч или даже миллионы за раз), чтобы минимизировать количество частей, которые должны быть объединены в фоновом процессе.

В этом руководстве мы пока не будем об этом беспокоиться. Выполните следующую команду чтобы вставить несколько строк данных в вашу таблицу:

Запросите вашу новую таблицу​

Вы можете написать запрос SELECT, как и с любой SQL базой данных:

Обратите внимание, что ответ возвращается в аккуратном табличном формате:

Вставьте свои данные​

Следующий шаг - добавить ваши собственные данные в ClickHouse. У нас много табличных функций и интеграций для приема данных. У нас есть несколько примеров в вкладках ниже, или вы можете ознакомиться с нашей страницей Интеграций для длинного списка технологий, которые интегрируются с ClickHouse.

Используйте s3 таблицу функцию для чтения файлов из S3. Это табличная функция - значит, что результат - это таблица которая может быть:

  1. использована как источник для запроса SELECT (что позволяет выполнять запросы по мере необходимости и оставлять ваши данные в S3), или...
  2. вставить получившуюся таблицу в таблицу MergeTree (когда вы будете готовы перенести ваши данные в ClickHouse)

Запрос по мере необходимости выглядит следующим образом:

Перенос данных в таблицу ClickHouse выглядит следующим образом, где nyc_taxi - это таблица MergeTree:

Посмотрите на нашу коллекцию страниц документации AWS S3 для получения более подробной информации и примеров использования S3 с ClickHouse.


Следующие шаги​