# Resultados y gráficos

> Filtra y copia resultados de consultas de DuckLocal, perfila cada columna, dibuja gráficos de barras, líneas, dispersión, sectores y mapas, y exporta resultados a CSV o Parquet.

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

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](#explain-and-profile).

## 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](settings-and-data.md#interface-size) 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](#filtering) 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 {#filtering}

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 {#row-limits}

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](#export).

## Exportar {#export}

`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 {#charts}

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**](#pick-columns) 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 {#pick-columns}

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](dashboards.md).

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 {#overview}

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:
  `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](#row-limits) — 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](schema-and-history.md#right-click-menu).

## Salida de Explain y Perfil {#explain-and-profile}

Los [botones **Explain** y **Perfil**](sql-editor.md#explain-and-profile) 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.
