Ir para o conteúdo

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 ​

ValorExibido como
NULLo literal NULL, em uma cor atenuada
BLOB<blob N bytes>
GEOMETRY<geometry N bytes>
Float com valor inteiro3.0
Timestamp2026-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)
Intervalnotação do DuckDB, como 1 day 02:00:00
Lista / struct / mapformatado 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 temO Auto desenha
Uma coluna de latitude e uma de longitudeUm 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 coisaUm 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 query e um bloco plot que 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:

LimiteComportamento
12 sériesColunas numéricas extras são descartadas
1.500 pontosA série é agrupada em intervalos e tem a média calculada em cada intervalo
200 barrasAs barras excedentes são truncadas, não mescladas
8 fatias de pizzaAs menores são agrupadas em "outros"
20.000 pontos de mapaOs 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:

ParteO que mostra
Nome e tipoO nome da coluna e seu tipo no DuckDB
NulosA 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
IntervaloMínimo – máximo, ou o valor único quando são iguais
MedianaPara números, datas e timestamps
DistribuiçãoUm 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 — 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.

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, 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.

Publicado sob a licença Apache-2.0.