clickhouse-local

Принимает на вход данные, которые можно представить в табличном виде и выполняет над ними операции, заданные на языке запросов ClickHouse.

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

clickhouse-local при настройке по умолчанию не имеет доступа к данным, которыми управляет сервер ClickHouse, установленный на этом же хосте, однако можно подключить конфигурацию сервера с помощью ключа --config-file.

Предупреждение

Мы не рекомендуем подключать серверную конфигурацию к clickhouse-local, поскольку данные можно легко повредить неосторожными действиями.

Для временных данных по умолчанию создается специальный каталог.

Вызов программы

Основной формат вызова:

Ключи команды:

• -S, --structure — структура таблицы, в которую будут помещены входящие данные.
• --input-format — формат входящих данных. По умолчанию — TSV.
• -f, --file — путь к файлу с данными. По умолчанию — stdin.
• -q, --query — запросы на выполнение. Разделитель запросов — ;.
• --queries-file - путь к файлу с запросами для выполнения. Необходимо задать либо параметр query, либо queries-file.
• -N, --table — имя таблицы, в которую будут помещены входящие данные. По умолчанию - table.
• --format, --output-format — формат выходных данных. По умолчанию — TSV.
• -d, --database — база данных по умолчанию. Если не указано, используется значение _local.
• --stacktrace — вывод отладочной информации при исключениях.
• --echo — перед выполнением запрос выводится в консоль.
• --verbose — подробный вывод при выполнении запроса.
• --logger.console — логирование действий в консоль.
• --logger.log — логирование действий в файл с указанным именем.
• --logger.level — уровень логирования.
• --ignore-error — не прекращать обработку если запрос выдал ошибку.
• -c, --config-file — путь к файлу конфигурации. По умолчанию clickhouse-local запускается с пустой конфигурацией. Конфигурационный файл имеет тот же формат, что и для сервера ClickHouse, и в нём можно использовать все конфигурационные параметры сервера. Обычно подключение конфигурации не требуется; если требуется установить отдельный параметр, то это можно сделать ключом с именем параметра.
• --no-system-tables — запуск без использования системных таблиц.
• --help — вывод справочной информации о clickhouse-local.
• -V, --version — вывод текущей версии и выход.

Примеры вызова

Вызов выше эквивалентен следующему:

Необязательно использовать ключи stdin или --file. Вы можете открывать любое количество файлов с помощью табличной функции file:

Объём оперативной памяти, занимаемой процессами, которые запустил пользователь (Unix):

Запрос:

Результат:

Запрос данных в файле с помощью SQL

Часто clickhouse-local используется для выполнения специальных запросов к файлам, когда не нужно вставлять данные в таблицу. clickhouse-local может транслировать данные из файла во временную таблицу и выполнить ваш SQL.

Если файл находится на той же машине, что и clickhouse-local, то можно просто указать файл для загрузки. Следующий файл reviews.tsv содержит выборку отзывов о товарах Amazon:

Эта команда является сокращением команды:

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

Функция таблицы file создает таблицу, и вы можете использовать DESCRIBE для просмотра предполагаемой схемы:

Tip

В имени файла разрешается использовать Шаблоны поиска.

Примеры: