Skip to main content
SQL Console — это встроенный веб-интерфейс для выполнения запросов и исследования данных. Он доступен на любом HTTP-порту ClickHouse по пути /ui, например http://localhost:8123/ui.
SQL Console — экспериментальная возможность.

Обзор

SQL Console — это одностраничное приложение (SPA), которое собирается в статический bundle и встраивается непосредственно в бинарный файл ClickHouse — так же, как ClickStack встраивается по пути /clickstack. Все ресурсы отдаются самим бинарным файлом ClickHouse, сторонние CDN не используются. Чтобы открыть консоль, перейдите по пути /ui на любом HTTP-порту ClickHouse (например, http://localhost:8123/ui).

Как он раздаётся

Бандл сжимается gzip на этапе сборки и встраивается через #embed, поэтому каждый ответ от /ui содержит заголовок Content-Encoding: gzip. Поскольку SQL Console — это одностраничное приложение с маршрутизацией на стороне клиента, для запросов к /ui, которым не соответствует ни один встроенный ресурс и которые не похожи на файл (то есть не имеют расширения), возвращается index.html. Запросы к путям, которые выглядят как отсутствующие ресурсы (например, /ui/nonexistent.js), возвращают HTTP-статус 404 Not Found. Путь /ui сопоставляется либо точно, либо когда за ним следует граница /, ? или #, поэтому соседние маршруты вроде /uix не перехватываются механизмом fallback для SPA.

Связь с другими веб-интерфейсами

ClickHouse поставляется с несколькими встроенными веб-интерфейсами, доступными по HTTP-порту:
  • /play — легковесный интерфейс Web SQL.
  • /dashboard — встроенные панели мониторинга.
  • /clickstack — встроенный интерфейс ClickStack.
  • /ui — описанная здесь SQL Console.
Ссылки на все из них доступны на стартовой странице HTTP-сервера ClickHouse.

Аутентификация

SQL Console использует те же проверки Session и контроля доступа, что и HTTP-протокол. Раздача статических ресурсов интерфейса по пути /ui не требует аутентификации; запросы, отправляемые интерфейсом, аутентифицируются так же, как и любой другой HTTP-запрос.
Последнее изменение 26 сентября 2026 г.