> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-vortex-format.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Документация по встроенному интерфейсу SQL Console, доступному на HTTP-сервере ClickHouse по пути `/ui`

# SQL Console

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

<Note>
  SQL Console — экспериментальная возможность.
</Note>

<h2 id="overview">
  Обзор
</h2>

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

Чтобы открыть консоль, перейдите по пути `/ui` на любом HTTP-порту ClickHouse (например, `http://localhost:8123/ui`).

<h2 id="how-it-is-served">
  Как он раздаётся
</h2>

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

Путь `/ui` сопоставляется либо точно, либо когда за ним следует граница `/`, `?` или `#`, поэтому соседние маршруты вроде `/uix` не перехватываются механизмом fallback для SPA.

<h2 id="relationship-to-other-web-uis">
  Связь с другими веб-интерфейсами
</h2>

ClickHouse поставляется с несколькими встроенными веб-интерфейсами, доступными по HTTP-порту:

* [`/play`](/ru/interfaces/web-sql) — легковесный интерфейс Web SQL.
* `/dashboard` — встроенные панели мониторинга.
* `/clickstack` — встроенный интерфейс ClickStack.
* `/ui` — описанная здесь SQL Console.

Ссылки на все из них доступны на стартовой странице HTTP-сервера ClickHouse.

<h2 id="authentication">
  Аутентификация
</h2>

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