Resultados e gráficos
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.
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 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 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
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
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.
Exportar
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
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 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
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
querye um blocoplotque desenham o mesmo gráfico em um painel.
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
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:
SUMMARIZEpara as estatísticas, depois umSELECTpara 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 — 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 comSELECT,WITH,FROM,VALUES,TABLE,PIVOTouUNPIVOT(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.
Saída de Explain e Perfil
Os botões Explain e Perfil 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,FILTERouHASH_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.
