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

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

Добро пожаловать в ClickHouse!

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

Давайте начнем?

Скачайте 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 (что позволяет выполнять ad-hoc запросы и оставлять ваши данные в S3), или...
  2. вставить получившуюся таблицу в таблицу MergeTree (когда вы будете готовы переместить ваши данные в ClickHouse)

Ad-hoc запрос выглядит следующим образом:

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

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


Исследуйте​