본문으로 건너뛰기

쿼리 탭

SQL 에디터에서 여러 쿼리를 동시에 작업할 수 있도록 탭 기반 인터페이스를 제공합니다. 각 탭은 독립적인 SQL 편집 영역과 실행 결과를 가지며, 자유롭게 탭을 추가하거나 전환할 수 있습니다.

SQL 에디터

주요 기능

  • 다중 탭 지원: 여러 쿼리를 탭으로 분리하여 동시에 작업할 수 있습니다.
  • 탭 추가: + 버튼을 클릭하여 새 쿼리 탭을 즉시 생성합니다.
  • 탭 닫기: 각 탭의 x 버튼으로 더 이상 필요 없는 탭을 닫을 수 있습니다.
  • 탭 이름 변경: 탭 제목을 더블 클릭하면 원하는 이름으로 변경할 수 있습니다.
  • 독립적 실행 컨텍스트: 각 탭은 별도의 쿼리 상태(running, succeeded, failed)를 유지합니다.
  • 상태 보존: 비활성 탭으로 전환해도 편집 내용과 실행 결과가 그대로 유지됩니다.

사용 방법

새 탭 추가

  1. SQL 에디터 상단의 탭 바에서 + 버튼을 클릭합니다.
  2. 새 빈 탭이 생성되고 자동으로 해당 탭으로 전환됩니다.
  3. 기본 이름은 Query 1, Query 2 등으로 순번이 부여됩니다.

탭 이름 변경

  1. 변경하려는 탭의 제목을 더블 클릭합니다.
  2. 텍스트 입력 필드가 나타나면 원하는 이름을 입력합니다.
  3. Enter 키를 누르거나 입력 필드 외부를 클릭하면 이름이 저장됩니다.

탭 닫기

  1. 닫으려는 탭의 x 아이콘을 클릭합니다.
  2. 마지막 탭을 닫으면 자동으로 새 빈 탭이 생성됩니다.

탭 전환

  1. 원하는 탭을 클릭하면 해당 쿼리와 결과가 화면에 표시됩니다.
  2. 이전 탭의 편집 내용과 실행 결과는 그대로 유지됩니다.

탭 상태 관리

각 탭은 zustand 스토어에서 다음 정보를 관리합니다:

항목설명
id탭 고유 식별자
name탭 표시 이름
sql현재 편집 중인 SQL 텍스트
catalog선택된 카탈로그
schema선택된 스키마
status쿼리 실행 상태 (running, succeeded, failed)
isExecuting쿼리 실행 중 여부
result실행 결과 데이터

관련 API

  • POST /api/v1/query/execute -- 쿼리 실행
  • GET /api/v1/query/{query_id}/results -- 실행 결과 조회
  • DELETE /api/v1/query/{query_id} -- 쿼리 취소

키보드 단축키로 빠르게 탭을 관리할 수 있습니다. 자세한 내용은 키보드 단축키 페이지를 참조하세요.