// HTTP-интерфейс · аналитика

Клиент ClickHouse для Mac, Windows и Linux

Нативный клиент ClickHouse, который понимает ClickHouse, а не делает вид, что это транзакционная база данных: точные широкие целые числа, планы, показывающие, какие части и гранулы отсёк индекс, аналитика из журнала запросов и честные отказы там, где в ClickHouse нет эквивалента.

Подключается через
HTTP-интерфейс ClickHouse
Порт по умолчанию
8123 или 8443 с TLS
Вход в систему
Пользователь и пароль ClickHouse
Вставьте URL
clickhouse://user:password@host:8123/database

Что SQLly делает для ClickHouse

Каждый инструмент SQLly, который имеет аналог для ClickHouse, работает с системными таблицами ClickHouse. Те, которые не работают — потому что в ClickHouse нет транзакций, обновлений на уровне строк или счётчиков использования индексов — сообщают об этом вместо того, чтобы прерываться на полпути.

Результаты, сохраняющие каждую цифру

Результаты поступают в сетку по мере того, как их отдаёт ClickHouse. Широкие целые и десятичные числа не теряют ни одного разряда, массивы, кортежи и словари (Map) показываются как JSON-текст, а сценарий из нескольких инструкций отчитывается по каждому набору результатов или по записанным строкам.

Потоковая передача результатов →

Планы, показывающие отсечение индексов

Оценочные планы берутся из JSON ClickHouse EXPLAIN и показывают, сколько частей и гранул отсек каждый индекс, — то самое число, которое говорит, оправдывают ли себя ваш первичный ключ и skip-индексы.

Планы запросов →

Живые запросы с возможностью прерывания

Монитор активности показывает, что выполняется, и может это остановить; Cancel на вкладке запроса останавливает запрос на сервере, а Query Insights читает журнал запросов, показывая топ-запросы и недавние сбои.

Монитор активности →

Правки структуры с учётом MergeTree

Редактор структуры таблицы обрабатывает ADD, DROP, RENAME и MODIFY COLUMN и индексы data-skipping, а также помечает изменения ключей для ручной проверки. Перенос данных в ClickHouse создаёт таблицы MergeTree.

Передача данных →

BACKUP, RESTORE и OPTIMIZE

Резервное копирование / восстановление выполняет BACKUP и RESTORE DATABASE на диск резервных копий сервера, и меню «Обслуживание» выполняет OPTIMIZE TABLE … FINAL чтобы слить части таблицы.

Резервное копирование / восстановление →

Пользователи и права в виде скрипта

Представление Security только для чтения показывает пользователей, роли и права ClickHouse и скрипты CREATE USER и GRANT операторы для вашего просмотра и выполнения — контроль доступа ClickHouse остаётся в SQL, где ему и место.

Безопасность →

Подключение к ClickHouse

  1. Скачать SQLly для macOS, Windows или Linux из страницы загрузки и откройте его.
  2. Создайте подключение и выберите ClickHouse. SQLly использует HTTP-интерфейс ClickHouse, поэтому порт по умолчанию 8123 (используйте 8443 с TLS).
  3. Введите хост, пользователя, пароль и, при необходимости, базу данных, или вставьте clickhouse://user:password@host:8123/database URL. Пароль отправляется в связку ключей вашей ОС.
  4. Выберите режим TLS и, если сервер частный, SSH-туннель, прокси или проброс порта Kubernetes — они работают в точности так же, как для PostgreSQL и MySQL.
  5. Тестируйте, сохраняйте и подключайтесь, затем просматривайте базы данных в дереве и открывайте инструменты из подменю «Инструменты» в проводнике или из палитры команд.

Каждый инструмент SQLly в ClickHouse

Это та же матрица движков, которой приложение включает и отключает свои меню, — здесь написано ровно то, что вы получите. Там, где инструмент неприменим к ClickHouse, приложение объясняет почему — и мы тоже.

Инструменты SQLly и их поддержка в DuckDB
Инструмент ClickHouse
Explorer, IntelliSense и информационные карточки при наведении Да
Оценочные планы выполнения Да EXPLAIN json = 1, indexes = 1: показывает части и гранулы, которые каждый индекс исключает.
Монитор активности Да Выполнение запросов с возможностью прерывания (Kill).
Анализ запросов Да Журнал запросов: топ-запросы и последние ошибки.
Дашборд сервера Да
Использование диска и обозреватель объектов Да
Меню обслуживания Да OPTIMIZE TABLE … FINAL.
Сравнение схем и история схем Да
Сравнение данных Да
Передача данных Да Таблицы создаются как MergeTree.
Генератор тестовых данных Да
Редактор структуры таблицы Да Столбцы и индексы пропуска данных; изменения ключей помечены для ручной проверки.
Редактор безопасности (пользователи, роли, права) Частично Представление только для чтения, формирующее скрипты с операторами CREATE USER и GRANT.
Резервное копирование / восстановление Да BACKUP / RESTORE DATABASE на диск резервных копий сервера.
SSH-туннели, прокси и переадресация портов Kubernetes Да
Подключения только для чтения Да
Редактирование строк в сетке результатов Нет В ClickHouse нет построчных UPDATE и DELETE; используйте ALTER TABLE … UPDATE / DELETE на вкладке запроса.
Фактические (выполненные) планы Нет В ClickHouse нет EXPLAIN ANALYZE; прочитайте строки, байты и память выполнения запроса в Query Insights.
Анализатор индексов Нет Счётчиков использования индексов нет; смотрите отсечение индексов в оценочном плане.
Диалоги создания и удаления баз данных Нет Используйте CREATE DATABASE / DROP DATABASE на вкладке запроса.
Режим процедуры Нет Поддерживает только SQL Server и PostgreSQL.
SQL Agent, расширенные события и пошаговые конструкторы Нет Только SQL Server и Azure SQL.
Безопасная обёртка с автооткатом Нет В ClickHouse нет транзакций, поэтому SQLly не будет выполнять запросы при включённой обёртке в транзакцию.

Вопросы о ClickHouse в SQLly

К какому порту ClickHouse подключается SQLly?

SQLly работает с HTTP-интерфейсом ClickHouse: по умолчанию порт 8123, или 8443 с TLS. SSH-туннели, прокси SOCKS и HTTP, проброс портов Kubernetes и четыре режима TLS работают так же, как и для PostgreSQL и MySQL.

Могу ли я редактировать строки ClickHouse в сетке результатов?

Нет. В ClickHouse нет обновления (UPDATE) или удаления (DELETE) на уровне строк, поэтому редактирование строк в сетке не предусмотрено; изменяйте строки с помощью ALTER TABLE … UPDATE или DELETE во вкладке запроса. Редактор структуры таблицы поддерживает ADD, DROP, RENAME и MODIFY COLUMN, а также индексы пропуска данных.

Могу ли я просматривать и останавливать выполняющиеся запросы ClickHouse?

Да. Монитор активности показывает выполняющиеся запросы и может их завершить, кнопка Отмена на вкладке запроса останавливает выполнение запроса на сервере, а Query Insights читает журнал запросов для выявления топ-запросов и последних ошибок.

Почему настройка автоматического отката не работает в ClickHouse?

В ClickHouse нет транзакций, поэтому откат не смог бы ничего отменить, и каждое изменение осталось бы. С включённой настройкой SQLly отказывается выполнять операторы на подключении к ClickHouse и объясняет почему, вместо того чтобы создавать ложное ощущение безопасности.

// попробуйте на своём ClickHouse

Приведите свой ClickHouse домой — к свинке

Начать работать с SQLly на macOS, Windows и Linux можно бесплатно, без аккаунта.