콘텐츠로 이동

결과와 차트 ​

편집기 아래 패널에는 결과, 차트, 개요 세 개의 탭이 있습니다. 탭 오른쪽에는 결과의 크기(N rows · M columns)와 CSV 내보내기, Parquet 내보내기 버튼이 있습니다.

결과 탭에는 편집기의 실행 계획과 프로파일링 버튼이 만드는 출력도 표시됩니다. 실행 계획과 프로파일링 출력을 참고하세요.

결과 표 ​

표는 # 행 번호 열로 시작하고 이어서 쿼리 결과 열이 나옵니다. 숫자 열은 오른쪽 정렬입니다. 처음 너비는 머리글과 처음 200개 행을 기준으로 계산하며, 중국어나 일본어 문자는 두 문자 너비로 셉니다. 기본 인터페이스 크기에서 너비는 80~360픽셀이고 다른 크기에서는 비례해 조정됩니다. 열 경계를 끌어 너비를 바꿀 수 있지만 # 열은 크기를 바꿀 수 없습니다. 열이 패널보다 넓으면 그 아래에 가로 스크롤 막대가 계속 보입니다.

열 머리글의 화살표를 클릭하면 불러온 행을 그 열로 정렬합니다: 내림차순, 그다음 오름차순, 그다음 쿼리 원래 순서로 돌아갑니다. 숫자 열은 숫자로 정렬하고 나머지는 텍스트로 정렬합니다(ISO 날짜와 시간도 순서가 맞습니다). NULL은 마지막에 오고 값이 같은 행은 쿼리의 순서를 유지합니다. 필터를 걸어도 정렬은 유지되고, 다음 결과는 정렬되지 않은 상태로 시작합니다. 정렬은 필터와 마찬가지로 클라이언트 쪽에서 합니다. 불러온 행보다 많은 행을 정렬하려면 ORDER BY를 쓰세요.

셀 표시 ​

값표시
NULLNULL 문자열, 흐린 색
BLOB<blob N bytes>
GEOMETRY<geometry N bytes>
정수 값을 가진 부동소수점3.0
타임스탬프2026-09-17 04:21:09.5 — UTC이며 로컬 시간이 아닙니다; 소수부는 값에 있는 만큼 표시됩니다(TIMESTAMP_NS는 9자리)
Interval1 day 02:00:00 같은 DuckDB 표기
List / struct / map보기 좋게 정리해 표시

타임스탬프를 SQL에서 비교하는 게 아니라 눈으로 볼 때는 UTC로 표시된다는 점을 기억하세요.

필터 ​

필터 상자는 불러온 행의 모든 셀에서 대소문자를 구분하지 않고 부분 문자열을 찾습니다. 클라이언트 쪽에서 동작하므로 데이터베이스에 쿼리를 보내지 않고, 실제 결과 전체가 아니라 불러온 행만 대상으로 합니다.

필터는 Enter를 누르거나 상자를 비울 때 적용되며, 키를 누를 때마다 적용되지는 않습니다. 필터가 적용된 동안 표에는 옆에 visible / total rows가 표시됩니다.

행 수 제한 ​

결과는 다음 중 먼저 걸리는 쪽에서 잘립니다:

  • 100,000행
  • 2,000,000셀 — 따라서 열이 400개인 결과는 약 5,000행만 나옵니다

셀 예산이 있는 이유는 행 수 제한만으로는 작업량이 제한되지 않기 때문입니다. 카디널리티가 높은 열에 PIVOT을 하면 서로 다른 값마다 열이 하나씩 생기고, 수천만 개의 셀을 포맷하는 작업은 멈춘 것처럼 보입니다.

잘렸다는 사실은 실제로 불러온 행 수를 알려 주는 배너로 표시됩니다. 페이지 나누기도 "더 불러오기"도 없습니다 — 대신 쿼리 범위를 좁히세요.

복사 ​

셀 위에 마우스를 올리면 복사 버튼이 나타나 그 셀의 텍스트를 클립보드에 넣습니다. 셀을 오른쪽 클릭하면 셀 복사, 행 복사(탭으로 구분), 열 복사(표시 순서대로 한 줄에 하나씩)가 있습니다. 행 번호를 오른쪽 클릭하면 그 행을 복사합니다. 복사는 현재 필터와 정렬을 따릅니다. 대시보드 테이블도 같은 세 가지 복사 작업을 제공합니다. 범위 선택도 "SQL로 복사"도 없습니다. 행이나 열 하나보다 많을 때는 내보내기를 쓰세요.

내보내기 ​

Export CSV와 Export Parquet는 경로 입력란이 있는 작은 대화 상자를 열며, ~/Desktop/export.csv 또는 ~/Desktop/export.parquet가 미리 채워져 있습니다.

두 가지 알아둘 점:

  • 내보내기는 현재 행을 만든 SQL을 다시 실행하므로 파일에는 쿼리의 전체 결과가 들어갑니다. 필터된 보기도, 잘린 표도 아닙니다.
  • 파일 선택 창도 덮어쓰기 확인도 없습니다. 경로를 입력하면 그대로 기록됩니다.

차트 ​

열을 고르기 전에는 차트가 이미 표 안에 있는 행을 쿼리가 반환한 순서대로, 집계 없이 그립니다. X, Y, 분할 메뉴를 쓰면 DuckDB가 결과 전체를 대신 그룹화합니다.

차트 위의 차트 선택기는 자동에서 시작하며, 결과의 열을 보고 고릅니다:

결과에 있는 것자동으로 그리는 것
위도와 경도 열지도
시간 형식의 첫 열(date / timestamp)영역 차트; x는 0번 열, 숫자 열마다 시리즈 하나
그 밖의 경우막대 차트; 0번 열은 레이블, 첫 숫자 열은 값

"숫자 열"에는 첫 열도 포함됩니다. 0번 열이 숫자(시간, 연도, ID)라면 막대 차트의 레이블이 아니라 값이 됩니다. 레이블로 쓰려면 텍스트로 캐스트하세요(year::VARCHAR, 또는 format('{:02d}:00', hour(ts))).

막대, 선, 영역, 산점도는 어떤 결과에서든 한 번의 클릭으로 선택할 수 있습니다. 원형은 첫 열이 시간이 아닌 결과에, 지도는 좌표가 있는 결과에 제공됩니다. 선택은 실행이 바뀌어도 유지됩니다. 새 결과가 그 차트를 그릴 수 없을 때(좌표 없는 지도)는 선택을 잊지 않은 채 자동의 선택으로 대체됩니다.

열 선택 ​

차트 위의 X, Y, 분할 메뉴가 무엇을 그릴지 정합니다. Y는 행 수이거나 숫자의 합계, 평균, 최솟값, 최댓값입니다. 그러면 DuckDB가 불러온 행이 아니라 결과 전체를 그룹화하고, 가장 큰 200개 범주(또는 정렬된 값 중 앞 50,000개)와 가장 큰 12개 시리즈를 유지합니다. 무엇이 빠졌는지는 알림으로 알려 줍니다.

  • 분할을 고르면 누적과 히트맵이 차트 선택기에 추가되고 원형은 빠집니다.
  • 구간을 나눌 숫자가 있으면 히스토그램이 제공됩니다. DuckDB가 결과 전체를 구간화합니다.
  • .dash로 복사는 선택한 내용을 query와 plot 블록으로 복사해 대시보드에서 같은 차트를 그립니다.

열을 고르지 않았을 때 결과가 잘려 있으면 차트에 표에 불러온 처음 N개 행으로 그렸으며 전체 결과가 아닙니다라고 표시됩니다. 잘린 시계열은 백그라운드에서 다시 실행되어 모든 행의 평균을 냅니다.

차트 종류와 제한 ​

원형 차트는 레이블마다 첫 숫자 열의 값을 큰 것부터 그립니다. 0, 음수, 누락된 값은 조각으로 그리지 않고 알림에 개수를 표시합니다. 조각이 8개를 넘으면 가장 큰 7개만 남고 나머지는 "기타"로 합쳐집니다.

지도는 열 이름으로 좌표를 찾습니다:

  • 위도: lat, latitude, 또는 이를 포함하는 이름(geo_lat, start_lat) — 纬度도 됩니다.
  • 경도: lng, lon, long, longitude, 마찬가지로 — 经度도 됩니다.

각 행은 점 하나이며, 점에 맞춰 조정된 Web Mercator 투영 위에 도 단위로 표시된 위도/경도 격자를 배경으로 그립니다. 서로 다른 값이 몇 가지뿐인 텍스트 열이 있으면 그 값으로 점에 색을 입힙니다. 점 위에 마우스를 올리면 그 행이 표시됩니다.

점 아래에 OpenStreetMap 기본 지도를 그릴 수 있습니다. 보기 → 온라인 기본 지도 (OpenStreetMap) 로 켭니다. 타일을 불러오려면 네트워크가 필요하므로 기본은 꺼져 있습니다. 요청은 대략 어느 지역을 보는지 드러낼 뿐 행 데이터는 보내지 않습니다. 타일은 일주일 동안 캐시되고, 오프라인에서는 위도/경도 격자만 그립니다.

값 셀이 숫자가 아닌 행(예: NULL)은 그리기 전에 제외됩니다.

제한은 모두 차트 제목 아래 알림 줄에 표시됩니다:

제한동작
12개 시리즈초과한 숫자 열은 그리지 않음
1,500개 점시리즈를 구간으로 나누고 구간마다 평균
200개 막대초과한 막대는 합치지 않고 잘라 냄
8개 원형 조각가장 작은 것들이 "기타"로 합쳐짐
20,000개 지도 점초과한 점은 제외

제목에는 항상 몇 개의 점을 그렸는지 표시되므로, 곡선 모양을 믿기 전에 확인하세요.

열 개요 ​

개요 탭은 현재 결과의 모든 열을 한 번에 설명합니다: 얼마나 채워져 있는지, 값이 몇 가지인지, 범위, 값이 어떻게 분포하는지입니다.

제목 줄은 Current result · N rows · M columns · took …입니다. 그런 다음 열마다 한 줄이 나옵니다:

부분표시 내용
이름과 형식열 이름과 그 DuckDB 형식
NULLNULL인 행의 비율, 작은 막대 포함; 0%를 넘으면 강조
서로 다른 값~N distinct — DuckDB가 추정한 서로 다른 값의 수
범위최솟값 – 최댓값, 같으면 그 값 하나
중앙값숫자, 날짜, 타임스탬프 열만
분포작은 차트, 아래 설명

분포는 열 형식에 따라 다릅니다:

  • 숫자, 날짜, 타임스탬프는 폭이 같은 막대 약 12개로 된 히스토그램을 그립니다. 값이 하나뿐인 열은 그 값을 대신 나열합니다.
  • 텍스트와 불리언은 가장 흔한 값 5개를 각각 전체 행에서 차지하는 비율과 함께 나열합니다. 값 위에 마우스를 올리면 정확한 개수가 나옵니다. 서로 다른 값이 약 10,000개를 넘으면 값은 추정치가 되고 흔한 값(추정) 아래에 비율 없이 나열됩니다.
  • List, struct, map, union은 차트를 그리지 않습니다.

동작 방식:

  • 개요는 쿼리를 전체로 다시 실행하며 두 번 스캔합니다. 통계는 SUMMARIZE로, 각 열의 분포는 SELECT 하나로 구합니다. 따라서 표가 행 수 제한 안에서 유지한 행이 아니라 전체 결과를 다룹니다. 느린 쿼리는 다시 느립니다. 결과가 결정적이지 않은 쿼리(random(), USING SAMPLE)는 두 번째 실행에서 나온 결과를 설명합니다.
  • 탭을 열 때 계산하고, 탭이 열려 있는 동안 새 결과마다 다시 계산합니다.
  • FROM ( … ) 안에 들어갈 수 있는 쿼리만 개요를 만들 수 있습니다: SELECT, WITH, FROM, VALUES, TABLE, PIVOT, UNPIVOT로 시작하는 쿼리입니다(앞쪽 -- 주석은 건너뜁니다). 그 밖의 것(SHOW, DESCRIBE, PRAGMA, CALL, SUMMARIZE)에는 *쿼리의 결과(SELECT, WITH, FROM…)만 개요를 만들 수 있습니다: 개요는 쿼리를 다시 실행합니다.*가 표시됩니다.

쿼리를 쓰지 않고 테이블, 뷰, 등록된 파일 전체를 개요로 보려면 사이드바에서 오른쪽 클릭하고 열 개요를 고르세요. FROM <name>;이 편집기에 들어가고 실행되며 이 탭이 열립니다. 오른쪽 클릭 메뉴를 참고하세요.

실행 계획과 프로파일링 출력 ​

편집기 도구 모음의 실행 계획과 프로파일링 버튼은 출력을 결과 탭에 표시하며, 다른 탭이 열려 있으면 그 탭으로 전환합니다. 둘 다 표를 대체하므로 행을 다시 보려면 쿼리를 다시 실행하세요.

실행 계획은 DuckDB의 계획을 EXPLAIN · took … 줄 아래에 고정폭 일반 텍스트로 보여 줍니다.

프로파일링은 실제로 실행된 계획을 트리로 보여 주며, 연산자마다 한 줄이고 자신에게 데이터를 보내는 연산자 아래에 들여씁니다:

  • 모든 연산자가 쓴 시간 중 그 연산자의 몫을 나타내는 막대;
  • 자식은 제외한 연산자 자체의 시간;
  • TABLE_SCAN, FILTER, HASH_GROUP_BY 같은 연산자 이름;
  • N rows — 그 연산자가 만든 행 수;
  • est. N — 계획에 있으면 그 행 수에 대한 옵티마이저의 추정치입니다. 어느 쪽으로든 10배 넘게 틀리면 강조됩니다(마우스를 올리면 추정이 10배 넘게 틀림). 이 정도 오차는 조인이 느린 흔한 이유입니다.
  • 그 아래에는 연산자가 다룬 내용: 필터, 조인 키, 프로젝션.

제목 줄은 Profile · took … · operators …입니다: 실제 경과 시간, 그다음 연산자 자체 시간의 합입니다. 같은 파이프라인의 연산자는 교차 실행되므로 둘은 다르고, 막대는 두 번째를 기준으로 한 비율입니다. 옆의 Hottest: NAME (time)은 혼자서 가장 많은 시간을 쓴 연산자를 알려 주고, 그 연산자의 줄은 빨간색으로 그려집니다.

Apache-2.0 라이선스로 공개되었습니다.