Перейти к содержимому

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

Панель под редактором имеет три вкладки: Результаты, График и Обзор. Справа от вкладок находятся размер результата (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
Timestamp2026-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) называет оператор, который сам по себе стоил больше всего, и его строка рисуется красным.

Опубликовано под лицензией Apache-2.0.