Результаты и графики
Панель под редактором имеет три вкладки: Результаты, График и Обзор. Справа от вкладок находятся размер результата (N rows · M columns) и кнопки Экспорт CSV и Экспорт Parquet.
Вкладка Результаты также показывает то, что выдают кнопки Explain и Profile редактора — см. Вывод Explain и Profile.
Таблица результатов
Таблица начинается со столбца с номером строки #, за которым идут столбцы результата запроса. Числовые столбцы выровнены по правому краю. Начальная ширина вычисляется по заголовкам и первым 200 строкам, причём китайские и японские символы считаются как два символа ширины. При размере интерфейса по умолчанию ширина составляет от 80 до 360 пикселей и пропорционально масштабируется при других размерах. Перетаскивайте границы столбцов, чтобы менять ширину; столбец # изменить нельзя. Когда столбцы шире панели, под ними остаётся видимой горизонтальная полоса прокрутки.
Нажмите стрелки в заголовке столбца, чтобы отсортировать по нему загруженные строки: по убыванию, затем по возрастанию, затем снова в порядке запроса. Числовые столбцы сортируются как числа, всё остальное — как текст (это упорядочивает даты и время в формате ISO), NULL идёт последним, а строки с одинаковыми значениями сохраняют порядок запроса. Фильтр сохраняет сортировку, а следующий результат начинается без неё. Сортировка выполняется на клиенте, как и фильтр: чтобы отсортировать больше строк, чем было загружено, используйте 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.
Фильтрация
Поле фильтра ищет подстроку без учёта регистра по всем ячейкам загруженных строк. Оно работает на клиенте: никогда не обращается к базе данных и охватывает только загруженные строки, а не истинный размер результата.
Фильтр применяется при нажатии 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 и Split заставляют DuckDB вместо этого группировать весь результат.
Выбор типа графика над графиком начинается с Auto, который делает выбор по столбцам результата:
| В результате есть | Auto строит |
|---|---|
| Столбец широты и столбец долготы | Карту |
| Временной первый столбец (date / timestamp) | График области; x — столбец 0, по одной серии на числовой столбец |
| Всё остальное | Столбчатую диаграмму; столбец 0 — подпись, первый числовой столбец — значение |
«Числовой столбец» включает первый столбец: если столбец 0 — число (час, год, ID), он становится значением столбчатой диаграммы, а не её подписью. Приведите его к тексту (year::VARCHAR или format('{:02d}:00', hour(ts))), чтобы он стал подписью.
Bar (столбцы), Line (линии), Area (область) и Scatter (точки) доступны в один щелчок для любого результата; Pie (круговая) — для результата, первый столбец которого не время, а Map (карта) — для результата с координатами. Выбор сохраняется между запусками; когда новый результат не позволяет его построить — карта без координат — график откатывается к выбору Auto, не забывая ваш.
Выбор столбцов
Меню X, Y и Split над графиком определяют, что он рисует. Y — это число строк либо сумма, среднее, минимум или максимум числа. Затем DuckDB группирует весь результат, а не загруженные строки, и сохраняет 200 крупнейших категорий (или первые 50 000 упорядоченных значений) и 12 крупнейших серий. Уведомление сообщает, что осталось за пределами.
- Если выбран Split, в списке типов появляются Stacked (с накоплением) и Heatmap (тепловая карта), а Pie из него исчезает.
- Histogram (гистограмма) предлагается, когда есть число, которое можно разбить по интервалам. DuckDB разбивает весь результат.
- Копировать как .dash копирует ваш выбор в виде блоков
queryиplot, которые рисуют тот же график в дашборде.
Без выбора график по обрезанному результату сообщает Построено по первым 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 точек карты | Лишние точки не показываются |
Заголовок всегда сообщает, сколько точек было нарисовано, так что проверяйте его, прежде чем доверять форме кривой.
Обзор столбцов
Вкладка Обзор описывает все столбцы текущего результата сразу: насколько они заполнены, сколько значений принимают, их диапазон и как выглядят их значения.
Строка заголовка выглядит так: Current result · N rows · M columns · took …. Затем каждый столбец получает одну строку:
| Часть | Что показывает |
|---|---|
| Имя и тип | Имя столбца и его тип DuckDB |
| Nulls | Доля строк со значением NULL, с небольшой полосой; выделяется, когда больше 0 % |
| Distinct | ~N distinct — оценка DuckDB числа различных значений |
| Диапазон | Минимум – максимум или единственное значение, когда они равны |
| Медиана | Для чисел, дат и меток времени |
| Распределение | Небольшой график, описанный ниже |
Распределение зависит от типа столбца:
- Числа, даты и метки времени получают гистограмму примерно из 12 столбцов одинаковой ширины. Столбец с единственным значением вместо этого показывает это значение.
- Текст и логические значения показывают 5 самых частых значений, каждое со своей долей строк; наведите курсор на значение, чтобы увидеть точное число. После примерно 10 000 различных значений они оцениваются и перечисляются под заголовком Частые значения (оценка), без долей.
- Списки, структуры, карты и объединения не получают графика.
Как это работает:
- Обзор выполняет запрос заново, целиком, в два прохода:
SUMMARIZEдля статистики, затем одинSELECTдля распределения каждого столбца. Так он охватывает полный результат, а не только строки, которые таблица сохранила в рамках своих ограничений на строки — и медленный запрос снова будет медленным. Запрос, который не детерминирован (random(),USING SAMPLE), описывается таким, каким он получился во втором прогоне. - Он вычисляется при открытии вкладки и заново для каждого нового результата, пока вкладка открыта.
- Суммировать можно только запрос, который помещается внутрь
FROM ( … ): тот, что начинается сSELECT,WITH,FROM,VALUES,TABLE,PIVOTилиUNPIVOT(ведущие комментарии--пропускаются). Всё остальное —SHOW,DESCRIBE,PRAGMA,CALL,SUMMARIZE— получает сообщение Суммировать можно только результат запроса (SELECT, WITH, FROM…): обзор выполняет его заново.
Чтобы получить обзор целой таблицы, представления или зарегистрированного файла, не написав запрос, нажмите на него правой кнопкой на боковой панели и выберите Обзор столбцов. Это поместит FROM <name>; в редактор, выполнит его и откроет эту вкладку. См. Контекстное меню.
Вывод Explain и Profile
Кнопки Explain и Profile на панели инструментов редактора показывают свой вывод на вкладке Результаты, переключаясь на неё, если была открыта другая. Любая из них заменяет таблицу; выполните запрос снова, чтобы вернуть его строки.
Explain показывает план DuckDB как обычный моноширинный текст под строкой EXPLAIN · took ….
Profile показывает план, который действительно выполнялся, в виде дерева, по строке на оператор, каждый с отступом под оператором, для которого он работает:
- полоса, показывающая долю оператора в общем времени всех операторов;
- собственное время оператора, без времени его дочерних операторов;
- его имя, например
TABLE_SCAN,FILTERилиHASH_GROUP_BY; N rows— сколько строк он произвёл;est. N— оценка оптимизатора для этих строк, если в плане она есть. Она выделяется, когда отличается более чем в 10 раз в любую сторону (наведите курсор, чтобы увидеть Оценка отличается более чем в 10×): ошибка такого размера — частая причина медленного соединения;- ниже — то, с чем работал оператор: фильтры, ключи соединения, проекции.
Строка заголовка выглядит так: Profile · took … · operators … — сначала время по часам, затем сумма собственного времени операторов. Они различаются, потому что операторы одного конвейера выполняются вперемешку; полосы показывают доли второго. Рядом Hottest: NAME (time) называет оператор, который сам по себе стоил больше всего, и его строка рисуется красным.
