결과 테이블
쿼리 실행 결과를 고성능 가상화 테이블로 표시합니다.
@tanstack/react-table과 @tanstack/react-virtual을 사용하여 수십만 행의 데이터도 끊김 없이 렌더링하며, 컬럼 정렬과 CSV 내보내기 기능을 제공합니다.

주요 기능
- 가상화 렌더링: 화면에 보이는 행만 DOM에 렌더링하여 대용량 결과도 빠르게 표시합니다.
- 컬럼 정렬: 컬럼 헤더를 클릭하여 오름차순/내림차순으로 정렬할 수 있습니다.
- 컬럼 리사이즈: 컬럼 경계를 드래그하여 너비를 자유롭게 조절할 수 있습니다.
- CSV 내보내기: 결과 데이터를 CSV 파일로 다운로드할 수 있습니다.
- 행 수 표시: 전체 결과 행 수와 실행 시간이 상태바에 표시됩니다.
- 에러 표시: 쿼리 실패 시 에러 메시지가 결과 영역에 명확하게 표시됩니다.
사용 방법
결과 확인
- SQL 에디터에서 쿼리를 작성하고 실행 버튼을 클릭합니다.
- 하단 패널에 결과 테이블이 표시됩니다.
- 실행 상태(
running,succeeded,failed,cancelled)가 탭에 아이콘으로 표시됩니다.
정렬
- 정렬하려는 컬럼의 헤더를 클릭합니다.
- 첫 클릭은 오름차순, 두 번째 클릭은 내림차순, 세 번째 클릭은 정렬 해제입니다.
- 정렬 방향은 헤더의 화살표 아이콘으로 확인할 수 있습니다.
CSV 내보내기
- 결과 테이블 상단의 내보내기 버튼을 클릭합니다.
- 현재 결과 데이터가 CSV 형식으로 브라우저에 다운로드됩니다.
패널 크기 조절
- 에디터와 결과 테이블 사이의 구분선을 드래그하여 각 영역의 비율을 조절할 수 있습니다.
결과 상태
| 상태 | 설명 |
|---|---|
running | 쿼리 실행 중 (스피너 표시) |
succeeded | 실행 완료 (결과 테이블 표시) |
failed | 실행 실패 (에러 메시지 표시) |
cancelled | 사용자에 의해 취소됨 |
관련 API
POST /api/v1/query/execute-- 쿼리 실행GET /api/v1/query/{query_id}/results-- 결과 조회GET /api/v1/query/history-- 쿼리 실행 이력
노트
가상화 렌더링 덕분에 10만 행 이상의 결과도 스크롤 성능이 유지됩니다. 다만, 전체 결과를 내보내려면 CSV 내보내기를 사용하세요.