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

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

Обзор​

Настройте 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.


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