본문으로 건너뛰기

결과 테이블

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

쿼리 결과

주요 기능

  • 가상화 렌더링: 화면에 보이는 행만 DOM에 렌더링하여 대용량 결과도 빠르게 표시합니다.
  • 컬럼 정렬: 컬럼 헤더를 클릭하여 오름차순/내림차순으로 정렬할 수 있습니다.
  • 컬럼 리사이즈: 컬럼 경계를 드래그하여 너비를 자유롭게 조절할 수 있습니다.
  • CSV 내보내기: 결과 데이터를 CSV 파일로 다운로드할 수 있습니다.
  • 행 수 표시: 전체 결과 행 수와 실행 시간이 상태바에 표시됩니다.
  • 에러 표시: 쿼리 실패 시 에러 메시지가 결과 영역에 명확하게 표시됩니다.

사용 방법

결과 확인

  1. SQL 에디터에서 쿼리를 작성하고 실행 버튼을 클릭합니다.
  2. 하단 패널에 결과 테이블이 표시됩니다.
  3. 실행 상태(running, succeeded, failed, cancelled)가 탭에 아이콘으로 표시됩니다.

정렬

  1. 정렬하려는 컬럼의 헤더를 클릭합니다.
  2. 첫 클릭은 오름차순, 두 번째 클릭은 내림차순, 세 번째 클릭은 정렬 해제입니다.
  3. 정렬 방향은 헤더의 화살표 아이콘으로 확인할 수 있습니다.

CSV 내보내기

  1. 결과 테이블 상단의 내보내기 버튼을 클릭합니다.
  2. 현재 결과 데이터가 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 내보내기를 사용하세요.