# Результаты и графики

> Фильтруйте и копируйте результаты запросов DuckLocal, профилируйте каждый столбец, стройте столбчатые, линейные, точечные, круговые графики и карты, а также экспортируйте результаты в CSV или Parquet.

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

Панель под редактором имеет три вкладки: **Результаты**, **График** и
**Обзор**. Справа от вкладок находятся размер результата
(`N rows · M columns`) и кнопки **Экспорт CSV** и **Экспорт Parquet**.

Вкладка **Результаты** также показывает то, что выдают кнопки **Explain** и
**Profile** редактора — см. [Вывод Explain и Profile](#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` |
| Timestamp | `2026-09-17 04:21:09.5` — **в UTC, а не в местном времени**; в дробной части столько цифр, сколько в значении (девять для TIMESTAMP_NS) |
| Interval | нотация DuckDB, например `1 day 02:00:00` |
| List / struct / map | с форматированием |

Отображение в UTC стоит запомнить, если вы просматриваете метки времени на глаз, а не сравниваете их в SQL.

### Фильтрация {#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** и **Split**](#pick-columns) заставляют DuckDB вместо этого группировать весь результат.

Выбор типа графика над графиком начинается с **Auto**, который делает выбор по столбцам результата:

| В результате есть | Auto строит |
| --- | --- |
| Столбец широты и столбец долготы | Карту |
| Временной первый столбец (date / timestamp) | График области; x — столбец 0, по одной серии на числовой столбец |
| Всё остальное | Столбчатую диаграмму; столбец 0 — подпись, первый числовой столбец — значение |

«Числовой столбец» включает первый столбец: если столбец 0 — число (час, год, ID), он становится значением столбчатой диаграммы, а не её подписью. Приведите его к тексту (`year::VARCHAR` или `format('{:02d}:00', hour(ts))`), чтобы он стал подписью.

**Bar** (столбцы), **Line** (линии), **Area** (область) и **Scatter** (точки) доступны в один щелчок для любого результата; **Pie** (круговая) — для результата, первый столбец которого не время, а **Map** (карта) — для результата с координатами. Выбор сохраняется между запусками; когда новый результат не позволяет его построить — карта без координат — график откатывается к выбору Auto, не забывая ваш.

### Выбор столбцов {#pick-columns}

Меню **X**, **Y** и **Split** над графиком определяют, что он рисует. **Y** — это число строк либо сумма, среднее, минимум или максимум числа. Затем DuckDB группирует весь результат, а не загруженные строки, и сохраняет 200 крупнейших категорий (или первые 50 000 упорядоченных значений) и 12 крупнейших серий. Уведомление сообщает, что осталось за пределами.

- Если выбран **Split**, в списке типов появляются **Stacked** (с накоплением) и **Heatmap** (тепловая карта), а **Pie** из него исчезает.
- **Histogram** (гистограмма) предлагается, когда есть число, которое можно разбить по интервалам. DuckDB разбивает весь результат.
- **Копировать как .dash** копирует ваш выбор в виде блоков `query` и `plot`, которые рисуют тот же график в [дашборде](dashboards.md).

Без выбора график по обрезанному результату сообщает **Построено по первым N строкам, загруженным таблицей, а не по всему результату**. Обрезанный временной ряд выполняется заново в фоне и усредняется по всем строкам.

### Типы графиков и ограничения

**Круговая диаграмма** рисует значение первого числового столбца по каждой подписи, начиная с наибольшего. Нулевые, отрицательные и отсутствующие значения не рисуются как секторы, и уведомление считает их; после 8 секторов 7 крупнейших сохраняют свои секторы, а остальные объединяются в «other».

**Карта** выбирается по именам столбцов:

- **Широта:** `lat`, `latitude` или любое имя, содержащее их (`geo_lat`,
  `start_lat`) — `纬度` тоже подходит.
- **Долгота:** `lng`, `lon`, `long`, `longitude`, аналогично — `经度` тоже
  подходит.

Каждая строка — точка в проекции Web Mercator, подогнанной под точки, поверх сетки широты и долготы с подписями в градусах; текстовый столбец с небольшим числом различных значений раскрашивает их. Наведите курсор на точку, чтобы увидеть её строку.

Под точками можно нарисовать подложку OpenStreetMap: включите её с помощью **Вид → Онлайн-подложка карты (OpenStreetMap)**. По умолчанию она выключена, потому что для загрузки тайлов нужна сеть — запросы раскрывают примерно просматриваемую область, но никогда ваши строки. Тайлы кэшируются на неделю; без сети карта рисуется только поверх сетки широты и долготы.

Строки, в которых ячейки значений не числовые — например, `NULL`, — отбрасываются перед построением.

Ограничения, о каждом из которых сообщает строка уведомления под заголовком графика:

| Ограничение | Поведение |
| --- | --- |
| 12 серий | Лишние числовые столбцы отбрасываются |
| 1 500 точек | Серия разбивается по интервалам и **усредняется** внутри каждого |
| 200 столбцов | Лишние столбцы обрезаются, а не объединяются |
| 8 секторов круговой диаграммы | Наименьшие объединяются в «other» |
| 20 000 точек карты | Лишние точки не показываются |

Заголовок всегда сообщает, сколько точек было нарисовано, так что проверяйте его, прежде чем доверять форме кривой.

## Обзор столбцов {#overview}

Вкладка **Обзор** описывает все столбцы текущего результата сразу: насколько они заполнены, сколько значений принимают, их диапазон и как выглядят их значения.

Строка заголовка выглядит так: `Current result · N rows · M columns · took …`. Затем каждый столбец получает одну строку:

| Часть | Что показывает |
| --- | --- |
| Имя и тип | Имя столбца и его тип DuckDB |
| Nulls | Доля строк со значением `NULL`, с небольшой полосой; выделяется, когда больше 0 % |
| Distinct | `~N distinct` — оценка DuckDB числа различных значений |
| Диапазон | Минимум – максимум или единственное значение, когда они равны |
| Медиана | Для чисел, дат и меток времени |
| Распределение | Небольшой график, описанный ниже |

Распределение зависит от типа столбца:

- **Числа, даты и метки времени** получают гистограмму примерно из 12 столбцов
  одинаковой ширины. Столбец с единственным значением вместо этого показывает это значение.
- **Текст и логические значения** показывают 5 самых частых значений, каждое со своей долей строк; наведите курсор на значение, чтобы увидеть точное число. После примерно 10 000 различных значений они оцениваются и перечисляются под заголовком *Частые значения (оценка)*, без долей.
- **Списки, структуры, карты и объединения** не получают графика.

Как это работает:

- **Обзор выполняет запрос заново**, целиком, в два прохода: `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 и Profile {#explain-and-profile}

[Кнопки **Explain** и **Profile**](sql-editor.md#explain-and-profile) на панели инструментов редактора показывают свой вывод на вкладке **Результаты**, переключаясь на неё, если была открыта другая. Любая из них заменяет таблицу; выполните запрос снова, чтобы вернуть его строки.

**Explain** показывает план DuckDB как обычный моноширинный текст под строкой `EXPLAIN · took …`.

**Profile** показывает план, который действительно выполнялся, в виде дерева, по строке на оператор, каждый с отступом под оператором, для которого он работает:

- полоса, показывающая долю оператора в общем времени всех операторов;
- собственное время оператора, без времени его дочерних операторов;
- его имя, например `TABLE_SCAN`, `FILTER` или `HASH_GROUP_BY`;
- `N rows` — сколько строк он произвёл;
- `est. N` — оценка оптимизатора для этих строк, если в плане она есть.
  Она выделяется, когда отличается более чем в 10 раз в любую сторону (наведите
  курсор, чтобы увидеть *Оценка отличается более чем в 10×*): ошибка такого
  размера — частая причина медленного соединения;
- ниже — то, с чем работал оператор: фильтры, ключи соединения, проекции.

Строка заголовка выглядит так: `Profile · took … · operators …` — сначала время по часам, затем сумма собственного времени операторов. Они различаются, потому что операторы одного конвейера выполняются вперемешку; полосы показывают доли второго. Рядом `Hottest: NAME (time)` называет оператор, который сам по себе стоил больше всего, и его строка рисуется красным.
