Ir al contenido

Resultados y gráficos ​

El panel bajo el editor tiene tres pestañas: Resultados, Gráfico y Resumen. A la derecha de las pestañas están el tamaño del resultado (N rows · M columns) y los botones Exportar CSV y Exportar Parquet.

La pestaña Resultados también muestra lo que producen los botones Explain y Perfil del editor — consulta Salida de Explain y Perfil.

La cuadrícula de resultados ​

La cuadrícula empieza con una columna de número de fila #, seguida de las columnas del resultado de la consulta. Las columnas numéricas se alinean a la derecha. Los anchos iniciales se calculan a partir de los encabezados y de las primeras 200 filas, contando los caracteres chinos o japoneses como dos caracteres de ancho. Los anchos van de 80 a 360 píxeles con el tamaño de interfaz predeterminado y se escalan en proporción con los demás tamaños. Arrastra los bordes de las columnas para ajustar los anchos; la columna # no se puede redimensionar. Cuando las columnas son más anchas que el panel, una barra de desplazamiento horizontal se queda a la vista bajo ellas.

Pulsa las flechas del encabezado de una columna para ordenar por ella las filas cargadas: descendente, luego ascendente y luego de vuelta al orden de la consulta. Las columnas de números se ordenan como números y todo lo demás como texto (lo que pone en orden las fechas y horas ISO), NULL va al final y las filas con valores iguales mantienen el orden de la consulta. Un filtro conserva la ordenación, y el siguiente resultado empieza sin ordenar. La ordenación es en el cliente, igual que el filtro: para ordenar más filas de las que se cargaron, usa ORDER BY.

Representación de celdas ​

ValorSe muestra como
NULLel literal NULL, en un color atenuado
BLOB<blob N bytes>
GEOMETRY<geometry N bytes>
Flotante con valor entero3.0
Timestamp2026-09-17 04:21:09.5 — en UTC, no en hora local; la fracción tiene tantos dígitos como el valor (nueve para TIMESTAMP_NS)
Intervalnotación de DuckDB, como 1 day 02:00:00
Lista / struct / mapaformateado con sangría

Vale la pena recordar la representación en UTC si miras marcas de tiempo a ojo en lugar de compararlas en SQL.

Filtrado ​

El cuadro de filtro hace una coincidencia de subcadena sin distinguir mayúsculas en todas las celdas de las filas cargadas. Es en el cliente: nunca consulta la base de datos y solo cubre las filas que se cargaron, no el tamaño real del resultado.

El filtro se aplica al pulsar Intro o al vaciar el cuadro, no en cada pulsación. Mientras hay un filtro aplicado, la cuadrícula muestra visible / total rows al lado.

Límites de filas ​

Los resultados se truncan por el que antes se cumpla de estos:

  • 100.000 filas
  • 2.000.000 de celdas — así, un resultado de 400 columnas produce solo unas 5.000 filas

El presupuesto de celdas existe porque un tope de filas por sí solo no acota el trabajo: un PIVOT sobre una columna de alta cardinalidad devuelve una columna por cada valor distinto, y formatear decenas de millones de celdas parecería un cuelgue.

El truncamiento se avisa en un banner que cita el número real de filas que se cargaron. No hay paginación ni "cargar más" — acota la consulta en su lugar.

Copiar ​

Al pasar el cursor por una celda aparece un botón de copiar que pone el texto de esa celda en el portapapeles. Haz clic derecho en una celda para Copiar celda, Copiar fila (separada por tabuladores) o Copiar columna (un valor por línea, en el orden mostrado). Haz clic derecho en un número de fila para copiar su fila. Las copias siguen el filtro y la ordenación actuales. Las tablas de los paneles ofrecen las mismas tres acciones de copia. No hay selección de rango ni "copiar como SQL"; para más de una fila o una columna, usa Exportar.

Exportar ​

Export CSV y Export Parquet abren un pequeño diálogo con un campo de ruta, rellenado de antemano con ~/Desktop/export.csv o ~/Desktop/export.parquet.

Dos cosas que conviene saber:

  • La exportación vuelve a ejecutar el SQL que produjo las filas actuales, así que el archivo contiene el conjunto de resultados completo de la consulta — no la vista filtrada ni la cuadrícula truncada.
  • No hay selector de archivos ni aviso de sobrescritura. Escribes una ruta y se escribe.

Gráficos ​

Hasta que elijas columnas, un gráfico se dibuja con las filas que ya están en la cuadrícula, en el orden en que las devolvió la consulta, sin agregación. Los menús X, Y y Split hacen que DuckDB agrupe el resultado entero en su lugar.

El selector de gráfico encima del gráfico empieza en Auto, que elige según las columnas del resultado:

El resultado tieneAuto dibuja
Una columna de latitud y otra de longitudUn mapa
Una primera columna temporal (date / timestamp)Un gráfico de área; x es la columna 0, una serie por columna numérica
Cualquier otra cosaUn gráfico de barras; la columna 0 es la etiqueta y la primera columna numérica es el valor

"Columna numérica" incluye la primera columna: si la columna 0 es un número — una hora, un año, un ID — se convierte en el valor del gráfico de barras, no en su etiqueta. Cámbiala a texto (year::VARCHAR, o format('{:02d}:00', hour(ts))) para que sea la etiqueta.

Barra, Línea, Área y Dispersión están a un clic para cualquier resultado; Circular para un resultado cuya primera columna no sea una hora, y Mapa para uno con coordenadas. La elección se mantiene entre ejecuciones; cuando un resultado nuevo no puede dibujarla — un mapa sin coordenadas — el gráfico vuelve a la elección de Auto sin olvidar la tuya.

Elegir columnas ​

Los menús X, Y y Split encima del gráfico eligen lo que dibuja. Y es el recuento de filas, o la suma, la media, el mínimo o el máximo de un número. DuckDB entonces agrupa el resultado entero en lugar de las filas cargadas, y conserva las 200 categorías mayores (o los primeros 50.000 valores ordenados) y las 12 series mayores. Un aviso dice qué quedó fuera.

  • Con un Split elegido, Apilado y Mapa de calor se suman al selector de gráfico, y Circular sale de él.
  • Histograma se ofrece cuando hay un número que agrupar en intervalos. DuckDB agrupa el resultado entero.
  • Copiar como .dash copia tu elección como un bloque query y otro plot que dibujan el mismo gráfico en un panel.

Sin elección, un gráfico de un resultado recortado dice Dibujado con las primeras N filas que cargó la cuadrícula, no con el resultado completo. Una serie temporal recortada se ejecuta otra vez en segundo plano y se promedia sobre todas las filas.

Tipos de gráfico y límites ​

Un circular dibuja el valor de la primera columna numérica por etiqueta, de mayor a menor. Los valores cero, negativos y ausentes no se dibujan como sectores, y un aviso los cuenta; a partir de 8 sectores, los 7 mayores conservan su sector y el resto se agrupa en "otros".

Un mapa se elige por nombres de columna:

  • Latitud: lat, latitude, o cualquier nombre que los contenga (geo_lat, start_lat) — 纬度 también vale.
  • Longitud: lng, lon, long, longitude, igual — 经度 también vale.

Cada fila es un punto en una proyección Web Mercator ajustada a los puntos, sobre una rejilla de latitud/longitud con etiquetas en grados; una columna de texto con pocos valores distintos los colorea. Pasa el cursor por un punto para ver su fila.

Bajo los puntos se puede dibujar un mapa base de OpenStreetMap: actívalo con Ver → Mapa base en línea (OpenStreetMap). Está desactivado por defecto porque cargar teselas necesita red — las peticiones revelan aproximadamente la zona que se está viendo, nunca tus filas. Las teselas se guardan en caché una semana; sin conexión, el mapa se dibuja solo sobre la rejilla de latitud/longitud.

Las filas cuyas celdas de valor no son numéricas — NULL, por ejemplo — se descartan antes de dibujar.

Límites, todos anunciados en una línea de aviso bajo el título del gráfico:

LímiteComportamiento
12 seriesLas columnas numéricas de más se descartan
1.500 puntosLa serie se agrupa en intervalos y se promedia dentro de cada uno
200 barrasLas barras sobrantes se truncan, no se fusionan
8 sectores circularesLos más pequeños se agrupan en "otros"
20.000 puntos de mapaLos puntos sobrantes se omiten

El título siempre indica cuántos puntos se dibujaron, así que compruébalo antes de fiarte de la forma de una curva.

Resumen de columnas ​

La pestaña Resumen describe todas las columnas del resultado actual a la vez: lo llenas que están, cuántos valores toman, su rango y cómo son sus valores.

La línea de encabezado dice Current result · N rows · M columns · took …. Después, cada columna tiene una línea:

ParteQué muestra
Nombre y tipoEl nombre de la columna y su tipo de DuckDB
NulosLa proporción de filas que son NULL, con una barra pequeña; resaltada cuando supera el 0 %
Distintos~N distinct — la estimación de DuckDB del número de valores distintos
RangoMínimo – máximo, o el valor único cuando son iguales
MedianaPara números, fechas y marcas de tiempo
DistribuciónUn gráfico pequeño, descrito abajo

La distribución depende del tipo de la columna:

  • Números, fechas y marcas de tiempo reciben un histograma de unas 12 barras de ancho igual. Una columna con un solo valor lista ese valor en su lugar.
  • Texto y booleanos listan sus 5 valores más comunes, cada uno con su proporción de filas; pasa el cursor por un valor para ver su recuento exacto. A partir de unos 10.000 valores distintos, los valores se estiman y se listan bajo Valores comunes (estimados), sin proporciones.
  • Listas, structs, mapas y uniones no reciben gráfico.

Cómo funciona:

  • El resumen vuelve a ejecutar la consulta, entera, en dos pasadas: SUMMARIZE para las estadísticas y luego un SELECT para la distribución de cada columna. Así cubre el resultado completo, no solo las filas que la cuadrícula conservó bajo sus límites de filas — y una consulta lenta vuelve a ser lenta. Una consulta que no es determinista (random(), USING SAMPLE) se describe tal como salió en esa segunda ejecución.
  • Se calcula al abrir la pestaña, y otra vez para cada resultado nuevo mientras la pestaña está abierta.
  • Solo se puede resumir una consulta que quepa dentro de FROM ( … ): una que empiece por SELECT, WITH, FROM, VALUES, TABLE, PIVOT o UNPIVOT (los comentarios -- iniciales se saltan). Cualquier otra cosa — SHOW, DESCRIBE, PRAGMA, CALL, SUMMARIZE — recibe Solo se puede resumir el resultado de una consulta (SELECT, WITH, FROM…): el resumen la vuelve a ejecutar.

Para resumir una tabla, una vista o un archivo registrado entero sin escribir una consulta, haz clic derecho en él en la barra lateral y elige Resumen de columnas. Eso pone FROM <name>; en el editor, lo ejecuta y abre esta pestaña. Consulta Menú contextual.

Salida de Explain y Perfil ​

Los botones Explain y Perfil de la barra de herramientas del editor muestran su salida en la pestaña Resultados, cambiando a ella si había otra abierta. Cualquiera de los dos reemplaza la cuadrícula; vuelve a ejecutar la consulta para recuperar sus filas.

Explain muestra el plan de DuckDB como texto monoespaciado bajo una línea EXPLAIN · took ….

Perfil muestra el plan que realmente se ejecutó como un árbol, una línea por operador, cada uno sangrado bajo el operador al que alimenta:

  • una barra para la parte del tiempo que se llevó el operador sobre el total de todos los operadores;
  • el tiempo propio del operador, sin contar el de sus hijos;
  • su nombre, como TABLE_SCAN, FILTER o HASH_GROUP_BY;
  • N rows — las filas que produjo;
  • est. N — la estimación del optimizador para esas filas, cuando el plan la tiene. Se resalta cuando falla por más de 10× en cualquier sentido (pasa el cursor por encima para ver Estimación desviada más de 10×): un error de ese tamaño es una causa habitual de que una unión sea lenta;
  • debajo, aquello con lo que trabajó el operador: filtros, claves de unión, proyecciones.

La línea de encabezado dice Profile · took … · operators …: el tiempo de reloj y luego la suma de los tiempos propios de los operadores. Los dos difieren, porque los operadores de una misma tubería se ejecutan intercalados; las barras son partes del segundo. Al lado, Hottest: NAME (time) nombra el operador que más costó por sí solo, y la línea de ese operador se dibuja en rojo.

Publicado bajo la licencia Apache-2.0.