SQL 콘솔

SQL 콘솔 (SQL Console)

SQL 콘솔은 쿼리 실행과 데이터 탐색을 위한 임베디드 웹 UI예요. ClickHouse HTTP 포트의 /ui 경로(예: http://localhost:8123/ui)에서 제공돼요.

출처: 문서

본문

SQL 콘솔은 쿼리를 실행하고 데이터를 탐색하기 위한 임베디드 웹 UI예요. ClickHouse HTTP 포트의 /ui 경로(예: http://localhost:8123/ui)에서 제공돼요.

참고: SQL 콘솔은 실험적 기능이에요.

개요 (Overview)

SQL 콘솔은 정적 번들로 컴파일되어 ClickHouse 바이너리에 직접 임베드되는 단일 페이지 애플리케이션(SPA)이에요. 이는 ClickStack이 /clickstack에 임베드되는 방식과 비슷해요. 모든 에셋은 ClickHouse 바이너리 자체에서 제공되며, 서드파티 CDN은 로드되지 않아요.

열려면 어떤 ClickHouse HTTP 포트의 /ui로 이동하세요(예: http://localhost:8123/ui).

제공 방식 (How it is served)

번들은 빌드 시 gzip으로 압축되어 #embed로 임베드되므로, /ui의 모든 응답은 Content-Encoding: gzip 헤더를 갖게 돼요. SQL 콘솔은 클라이언트 측 라우팅을 수행하는 단일 페이지 애플리케이션이므로, 임베드된 에셋에 매핑되지 않고 파일처럼 보이지 않는(즉 확장자가 없는) /ui 아래의 요청은 index.html 제공으로 폴백돼요. 누락된 에셋처럼 보이는 경로에 대한 요청(예: /ui/nonexistent.js)은 HTTP 상태 404 Not Found를 반환해요.

/ui 경로는 정확히 일치하거나 /, ?, # 경계가 따라올 때만 일치하므로, /uix 같은 형제 라우트는 SPA 폴백에 가로채지지 않아요.

다른 웹 UI와의 관계 (Relationship to the other web UIs)

ClickHouse는 HTTP 포트에서 제공되는 몇 가지 내장 웹 인터페이스를 함께 제공해요:

/play — 가벼운 Web SQL UI.
/dashboard — 내장 대시보드.
/clickstack — 임베드된 ClickStack UI.
/ui — 여기서 설명하는 SQL 콘솔.

이 모든 것에 대한 링크는 ClickHouse HTTP 서버 랜딩 페이지에서 볼 수 있어요.

인증 (Authentication)

SQL 콘솔은 HTTP 프로토콜과 동일한 Session 및 접근 제어 검사로 인증해요. /ui에서 정적 UI 에셋을 제공하는 것은 인증이 필요 없지만, UI가 실행하는 쿼리는 다른 HTTP 요청처럼 인증돼요.