# Resultados e gráficos

> Filtre e copie resultados de consultas do DuckLocal, analise cada coluna, desenhe gráficos de barras, linhas, dispersão, pizza e mapas, e exporte resultados para CSV ou Parquet.

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

O painel abaixo do editor tem três abas: **Resultados**, **Gráfico** e
**Visão geral**. À direita das abas ficam o tamanho do resultado
(`N rows · M columns`) e os botões **Exportar CSV** e **Exportar Parquet**.

A aba **Resultados** também mostra o que os botões **Explain** e **Perfil** do
editor produzem — veja [Saída de Explain e Perfil](#explain-and-profile).

## A grade de resultados

A grade começa com uma coluna `#` de número de linha, seguida pelas colunas do
resultado da consulta. Colunas numéricas ficam alinhadas à direita. As larguras
iniciais são calculadas a partir dos cabeçalhos e das primeiras 200 linhas,
contando caracteres chineses ou japoneses como dois caracteres de largura. As
larguras vão de 80 a 360 pixels no [tamanho de interface](settings-and-data.md#interface-size)
padrão e escalam proporcionalmente nos outros tamanhos. Arraste as bordas das
colunas para ajustar as larguras; a coluna `#` não pode ser redimensionada.
Quando as colunas são mais largas que o painel, uma barra de rolagem horizontal
fica visível sob elas.

Clique nas setas do cabeçalho de uma coluna para ordenar as linhas carregadas
por ela: decrescente, depois crescente e depois de volta à ordem da consulta.
Colunas de números ordenam como números, todo o resto como texto (o que coloca
datas e horas ISO em ordem), `NULL` fica por último, e linhas com valores iguais
mantêm a ordem da consulta. Um [filtro](#filtering) mantém a ordenação, e o
próximo resultado começa sem ordenação. A ordenação é feita no cliente, como o
filtro: para ordenar mais linhas do que as carregadas, use `ORDER BY`.

### Renderização das células

| Valor | Exibido como |
| --- | --- |
| `NULL` | o literal `NULL`, em uma cor atenuada |
| BLOB | `<blob N bytes>` |
| GEOMETRY | `<geometry N bytes>` |
| Float com valor inteiro | `3.0` |
| Timestamp | `2026-09-17 04:21:09.5` — **em UTC, não no horário local**; a fração tem tantos dígitos quanto o valor (nove para TIMESTAMP_NS) |
| Interval | notação do DuckDB, como `1 day 02:00:00` |
| Lista / struct / map | formatado com recuo |

Vale lembrar da renderização em UTC se você olha timestamps a olho em vez de
compará-los em SQL.

### Filtro {#filtering}

A caixa de filtro faz uma correspondência de substring sem diferenciar
maiúsculas **em todas as células** das linhas carregadas. É no cliente: nunca
consulta o banco de dados e cobre apenas as linhas que foram carregadas, não o
tamanho real do resultado.

O filtro é aplicado quando você pressiona Enter ou limpa a caixa, não a cada
tecla. Enquanto há um filtro aplicado, a grade mostra `visible / total rows` ao
lado.

## Limites de linhas {#row-limits}

Os resultados são truncados pelo que acontecer primeiro:

- **100.000 linhas**
- **2.000.000 de células** — assim, um resultado de 400 colunas produz apenas
  cerca de 5.000 linhas

O orçamento de células existe porque um teto de linhas sozinho não limita o
trabalho: um `PIVOT` sobre uma coluna de alta cardinalidade devolve uma coluna
por valor distinto, e formatar dezenas de milhões de células pareceria um
travamento.

O truncamento é avisado em um banner que cita o número real de linhas que foram
carregadas. **Não há paginação nem "carregar mais"** — restrinja a consulta.

## Cópia

Passar o cursor sobre uma célula revela um botão de copiar que coloca o texto
daquela célula na área de transferência. Clique com o botão direito em uma
célula para **Copiar célula**, **Copiar linha** (separada por tabulações) ou
**Copiar coluna** (um valor por linha, na ordem exibida). Clique com o botão
direito em um número de linha para copiar sua linha. As cópias seguem o filtro e
a ordenação atuais. As tabelas dos painéis oferecem as mesmas três ações de
cópia. Não há seleção de intervalo nem "copiar como SQL"; para mais de uma linha
ou de uma coluna, use [Exportar](#export).

## Exportar {#export}

`Export CSV` e `Export Parquet` abrem um pequeno diálogo com um campo de
caminho, pré-preenchido com `~/Desktop/export.csv` ou `~/Desktop/export.parquet`.

Duas coisas para saber:

- A exportação **executa de novo o SQL que produziu as linhas atuais**, então o
  arquivo contém o conjunto completo de resultados da consulta — não a visão
  filtrada nem a grade truncada.
- Não há seletor de arquivos nem aviso de sobrescrita. Você digita um caminho, e
  ele é escrito.

## Gráficos {#charts}

Até você escolher colunas, um gráfico é desenhado a partir das linhas que já
estão na grade, na ordem em que a consulta as devolveu, sem agregação. Os menus
[**X**, **Y** e **Split**](#pick-columns) fazem o DuckDB agrupar o resultado
inteiro.

O seletor de gráfico acima do gráfico começa em **Auto**, que escolhe a partir
das colunas do resultado:

| O resultado tem | O Auto desenha |
| --- | --- |
| Uma coluna de latitude e uma de longitude | Um mapa |
| Uma primeira coluna temporal (date / timestamp) | Um gráfico de área; x é a coluna 0, uma série por coluna numérica |
| Qualquer outra coisa | Um gráfico de barras; a coluna 0 é o rótulo, a primeira coluna numérica é o valor |

"Coluna numérica" inclui a primeira coluna: se a coluna 0 for um número — uma
hora, um ano, um ID — ela vira o valor do gráfico de barras, não o rótulo.
Converta-a para texto (`year::VARCHAR`, ou `format('{:02d}:00', hour(ts))`) para
torná-la o rótulo.

**Barra**, **Linha**, **Área** e **Dispersão** estão a um clique para qualquer
resultado; **Pizza** para um resultado cuja primeira coluna não seja um horário,
e **Mapa** para um que tenha coordenadas. A escolha é mantida entre execuções;
quando um novo resultado não consegue desenhá-la — um mapa sem coordenadas — o
gráfico volta à escolha do Auto sem esquecer a sua.

### Escolher colunas {#pick-columns}

Os menus **X**, **Y** e **Split** acima do gráfico escolhem o que ele desenha.
**Y** é a contagem de linhas, ou a soma, a média, o mínimo ou o máximo de um
número. O DuckDB então agrupa o resultado inteiro em vez das linhas carregadas,
e mantém as 200 maiores categorias (ou os primeiros 50.000 valores ordenados) e
as 12 maiores séries. Um aviso diz o que ficou de fora.

- Com um **Split** escolhido, **Empilhado** e **Mapa de calor** entram no seletor
  de gráfico, e **Pizza** sai dele.
- **Histograma** é oferecido quando há um número para agrupar em intervalos. O
  DuckDB agrupa o resultado inteiro.
- **Copiar como .dash** copia sua escolha como um bloco `query` e um bloco
  `plot` que desenham o mesmo gráfico em um [painel](dashboards.md).

Sem escolha, um gráfico de um resultado cortado diz **Desenhado a partir das
primeiras N linhas que a grade carregou, não do resultado inteiro**. Uma série
temporal cortada é executada de novo em segundo plano e tem a média calculada
sobre todas as linhas.

### Tipos de gráfico e limites

Um **gráfico de pizza** desenha o valor da primeira coluna numérica por rótulo,
do maior para o menor. Valores zero, negativos e ausentes não são desenhados
como fatias, e um aviso os conta; a partir de 8 fatias, as 7 maiores mantêm sua
fatia e o restante é agrupado em "outros".

Um **mapa** é escolhido pelos nomes das colunas:

- **Latitude:** `lat`, `latitude`, ou qualquer nome que os contenha (`geo_lat`,
  `start_lat`) — `纬度` também funciona.
- **Longitude:** `lng`, `lon`, `long`, `longitude`, da mesma forma — `经度`
  também funciona.

Cada linha é um ponto em uma projeção Web Mercator ajustada aos pontos, sobre uma
grade de latitude/longitude rotulada em graus; uma coluna de texto com poucos
valores distintos os colore. Passe o cursor sobre um ponto para ver sua linha.

Sob os pontos, um mapa base do OpenStreetMap pode ser desenhado: ative-o em
**Exibir → Mapa base on-line (OpenStreetMap)**. Ele fica desativado por padrão
porque carregar tiles precisa da rede — as requisições revelam aproximadamente a
área que está sendo vista, nunca suas linhas. Os tiles ficam em cache por uma
semana; sem conexão, o mapa é desenhado apenas sobre a grade de
latitude/longitude.

Linhas cujas células de valor não são numéricas — `NULL`, por exemplo — são
descartadas antes do desenho.

Limites, todos anunciados em uma linha de aviso sob o título do gráfico:

| Limite | Comportamento |
| --- | --- |
| 12 séries | Colunas numéricas extras são descartadas |
| 1.500 pontos | A série é agrupada em intervalos e tem a **média** calculada em cada intervalo |
| 200 barras | As barras excedentes são truncadas, não mescladas |
| 8 fatias de pizza | As menores são agrupadas em "outros" |
| 20.000 pontos de mapa | Os pontos excedentes ficam de fora |

O título sempre informa quantos pontos foram desenhados, então confira antes de
confiar na forma de uma curva.

## Visão geral das colunas {#overview}

A aba **Visão geral** descreve de uma vez todas as colunas do resultado atual:
quão preenchidas estão, quantos valores assumem, seu intervalo e como são seus
valores.

A linha de cabeçalho diz `Current result · N rows · M columns · took …`. Depois,
cada coluna ganha uma linha:

| Parte | O que mostra |
| --- | --- |
| Nome e tipo | O nome da coluna e seu tipo no DuckDB |
| Nulos | A proporção de linhas que são `NULL`, com uma barra pequena; destacada quando passa de 0% |
| Distintos | `~N distinct` — a estimativa do DuckDB para o número de valores distintos |
| Intervalo | Mínimo – máximo, ou o valor único quando são iguais |
| Mediana | Para números, datas e timestamps |
| Distribuição | Um gráfico pequeno, descrito abaixo |

A distribuição depende do tipo da coluna:

- **Números, datas e timestamps** ganham um histograma de cerca de 12 barras de
  largura igual. Uma coluna com um único valor lista esse valor.
- **Texto e booleanos** listam seus 5 valores mais comuns, cada um com sua
  proporção de linhas; passe o cursor sobre um valor para ver a contagem exata.
  A partir de cerca de 10.000 valores distintos, os valores são estimados e
  listados em *Valores comuns (estimados)*, sem proporções.
- **Listas, structs, maps e unions** não ganham gráfico.

Como funciona:

- **A visão geral executa a consulta de novo**, inteira, em duas passagens:
  `SUMMARIZE` para as estatísticas, depois um `SELECT` para a distribuição de
  cada coluna. Assim ela cobre o resultado completo, não apenas as linhas que a
  grade manteve sob seus [limites de linhas](#row-limits) — e uma consulta lenta
  fica lenta de novo. Uma consulta que não é determinística (`random()`,
  `USING SAMPLE`) é descrita como saiu naquela segunda execução.
- Ela é calculada quando você abre a aba, e de novo para cada novo resultado
  enquanto a aba está aberta.
- **Só uma consulta que caiba dentro de `FROM ( … )` pode ser resumida**: uma que
  comece com `SELECT`, `WITH`, `FROM`, `VALUES`, `TABLE`, `PIVOT` ou `UNPIVOT`
  (comentários `--` no início são ignorados). Qualquer outra coisa — `SHOW`,
  `DESCRIBE`, `PRAGMA`, `CALL`, `SUMMARIZE` — recebe *Só o resultado de uma
  consulta (SELECT, WITH, FROM…) pode ser resumido: a visão geral a executa de
  novo.*

Para resumir uma tabela, visão ou arquivo registrado inteiro sem escrever uma
consulta, clique com o botão direito nele na barra lateral e escolha **Visão
geral das colunas**. Isso coloca `FROM <name>;` no editor, executa e abre esta
aba. Veja [Menu de contexto](schema-and-history.md#right-click-menu).

## Saída de Explain e Perfil {#explain-and-profile}

Os [botões **Explain** e **Perfil**](sql-editor.md#explain-and-profile) na barra
de ferramentas do editor mostram sua saída na aba **Resultados**, mudando para
ela se outra aba estivesse aberta. Qualquer um dos dois substitui a grade;
execute a consulta de novo para recuperar suas linhas.

**Explain** mostra o plano do DuckDB como texto monoespaçado simples sob uma
linha `EXPLAIN · took …`.

**Perfil** mostra o plano que realmente foi executado como uma árvore, uma linha
por operador, cada um recuado sob o operador que alimenta:

- uma barra para a parcela do tempo que o operador gastou sobre o total de todos
  os operadores;
- o tempo próprio do operador, sem contar o dos filhos;
- seu nome, como `TABLE_SCAN`, `FILTER` ou `HASH_GROUP_BY`;
- `N rows` — as linhas que ele produziu;
- `est. N` — a estimativa do otimizador para essas linhas, quando o plano tem
  uma. É destacada quando erra por mais de 10× em qualquer direção (passe o
  cursor para ver *Estimativa errada por mais de 10×*): um erro desse tamanho é
  uma causa comum de uma junção lenta;
- abaixo, com o que o operador trabalhou: filtros, chaves de junção, projeções.

A linha de cabeçalho diz `Profile · took … · operators …`: o tempo de relógio,
depois a soma dos tempos próprios dos operadores. Os dois diferem, porque
operadores de um mesmo pipeline rodam intercalados; as barras são parcelas do
segundo. Ao lado, `Hottest: NAME (time)` nomeia o operador que mais custou
sozinho, e a linha desse operador é desenhada em vermelho.
