Web UI 고정 컬럼
Web UI 고정 컬럼 (Pinned Columns)
ClickHouse 내장 Web SQL UI에서 테이블을 가로로 스크롤해도 선택한 컬럼이 계속 보이도록 고정할 수 있습니다. 결과 영역의 가까운 가장자리에 컬럼을 붙여두어 식별자·이름·날짜 같은 핵심 컬럼을 놓치지 않게 해 줍니다.
출처: 문서
본문
내장 Web SQL UI(play.html, ClickHouse HTTP 포트의 /play 경로에서 제공됨)는 결과 테이블을 옆으로 스크롤해도 선택한 컬럼을 계속 보이게 유지할 수 있습니다. 고정된 컬럼은 스크롤되어 사라지는 대신 결과 영역의 가까운 가장자리에 붙어 있으므로, 핵심 컬럼 — 식별자, 이름, 날짜 — 이 읽고 있는 가장 오른쪽 컬럼 옆에 계속 보입니다.
컬럼 고정하기
모든 컬럼 헤더 왼쪽에 📌 압정 아이콘이 나타납니다. 아이콘을 클릭하면 컬럼이 고정되고, 다시 클릭하면 해제됩니다. 이 아이콘은 실제 버튼이라 키보드 사용자는 탭으로 이동해 키보드로 토글할 수 있고, 고정 상태를 보조 기술(assistive technology)에 노출합니다.
호버링 포인터(마우스)가 있는 기기에서는 헤더에 호버하거나 토글이 포커스될 때만 아이콘이 표시됩니다. 호버가 없는 터치·조잡한 포인터 기기에서는 아이콘이 항상 표시되어 바로 탭할 수 있습니다. 고정된 컬럼은 아이콘을 완전한 강도로 계속 표시해 고정 상태임을 알려줍니다.
고정이 가능한 경우
고정은 테이블이 가로로 스크롤될 만큼 충분히 넓을 때만 제공됩니다. 테이블 전체가 뷰포트에 들어오면 스크롤해 벗어날 것이 없으므로 고정 토글이 비활성화되고 키보드 탭 순서에서도 제외됩니다. 결과가 가로 스크롤 가능해지면 — 넓은 결과, 좁은 창, 가로로 늘어나는 스트리밍 결과 — 토글이 활성화됩니다.
스크롤 시 고정 컬럼 동작
고정된 컬럼은 가로 스크롤 중 콘텐츠와 함께 미끄러지다가 뷰포트를 벗어나려는 순간 가까운 가장자리 — 왼쪽 컬럼은 왼쪽 가장자리, 오른쪽 컬럼은 오른쪽 가장자리 — 에 붙어 계속 보입니다. 여러 고정 컬럼은 원래 순서대로 가장자리에 쌓이며, 각각 스크롤되는 콘텐츠와 테두리로 구분됩니다. 고정된 셀은 그 아래를 스크롤하는 일반 셀(선택된 셀 포함) 위에 그려져 항상 읽을 수 있습니다.
결과 간 공유
고정 상태는 컬럼 이름으로 추적되어 페이지의 모든 결과 테이블에서 공유됩니다. per-column 색상 코딩 모드와 같은 방식입니다. 한 결과에서 id라는 컬럼을 고정하면 다른 결과와 동일 컬럼을 반환하는 이후 쿼리의 id 컬럼도 고정으로 유지됩니다.
지속성 (Persistence)
고정 집합은 페이지 URL, 브라우저 히스토리, 탭별 결과 스냅샷에 기억됩니다. 그래서 페이지를 새로고침하거나 링크를 공유하거나 뒤로/앞으로 탐색해도 유지됩니다. 간결함을 위해 고정된 컬럼만 저장되고, 빈 집합은 URL이나 히스토리 상태에 아무것도 추가하지 않습니다.
제한사항
- 세로(전치, transposed) 단일 행 레이아웃에는 가로 스크롤 컬럼이 없어 고정을 제공하지 않습니다.