# 결과와 차트

> DuckLocal 쿼리 결과를 필터링하고 복사하고, 모든 열을 프로파일링하고, 막대, 선, 산점도, 원형, 지도 차트를 그리고, 결과를 CSV나 Parquet로 내보내는 방법입니다.

Source: https://ducklocal.app/docs/ko/results-and-charts

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

**결과** 탭에는 편집기의 **실행 계획**과 **프로파일링** 버튼이 만드는 출력도 표시됩니다.
[실행 계획과 프로파일링 출력](#explain-and-profile)을 참고하세요.

## 결과 표

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

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

### 셀 표시

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

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

### 필터 {#filtering}

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

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

## 행 수 제한 {#row-limits}

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

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

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

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

## 복사

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

## 내보내기 {#export}

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

두 가지 알아둘 점:

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

## 차트 {#charts}

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

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

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

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

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

### 열 선택 {#pick-columns}

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

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

열을 고르지 않았을 때 결과가 잘려 있으면 차트에 **표에 불러온 처음 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개 지도 점 | 초과한 점은 제외 |

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

## 열 개요 {#overview}

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

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

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

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

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

동작 방식:

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

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

## 실행 계획과 프로파일링 출력 {#explain-and-profile}

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

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

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

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

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