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
| Valor | Se muestra como |
|---|---|
NULL | el literal NULL, en un color atenuado |
| BLOB | <blob N bytes> |
| GEOMETRY | <geometry N bytes> |
| Flotante con valor entero | 3.0 |
| Timestamp | 2026-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) |
| Interval | notación de DuckDB, como 1 day 02:00:00 |
| Lista / struct / mapa | formateado 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 tiene | Auto dibuja |
|---|---|
| Una columna de latitud y otra de longitud | Un 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 cosa | Un 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
queryy otroplotque 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ímite | Comportamiento |
|---|---|
| 12 series | Las columnas numéricas de más se descartan |
| 1.500 puntos | La serie se agrupa en intervalos y se promedia dentro de cada uno |
| 200 barras | Las barras sobrantes se truncan, no se fusionan |
| 8 sectores circulares | Los más pequeños se agrupan en "otros" |
| 20.000 puntos de mapa | Los 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:
| Parte | Qué muestra |
|---|---|
| Nombre y tipo | El nombre de la columna y su tipo de DuckDB |
| Nulos | La 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 |
| Rango | Mínimo – máximo, o el valor único cuando son iguales |
| Mediana | Para números, fechas y marcas de tiempo |
| Distribución | Un 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:
SUMMARIZEpara las estadísticas y luego unSELECTpara 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 porSELECT,WITH,FROM,VALUES,TABLE,PIVOToUNPIVOT(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,FILTERoHASH_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.
