Como usar a função QUERY no Google Sheets

A função QUERY do Google Sheets serve para selecionar colunas, filtrar linhas, ordenar resultados e resumir dados sem alterar a tabela original. Ela é útil quando um filtro comum não basta — por exemplo, para mostrar apenas pedidos pagos, escolher duas colunas e ordenar o resultado pelo maior valor.

O passo a passo abaixo considera o Google Sheets na Web, no computador, com a documentação oficial consultada em 28 de outubro de 2026. O Google não identifica a interface Web por um número de versão; menus e separadores podem variar conforme o idioma e a localidade da planilha.

Antes de usar a QUERY

Organize a base em colunas, deixe uma linha de cabeçalho e mantenha cada coluna com um tipo predominante de dado: texto, número, data ou valor lógico. Segundo a documentação oficial, quando uma coluna mistura tipos, o tipo majoritário define como os dados serão tratados; os valores minoritários podem ser considerados nulos.

Use uma célula vazia para a fórmula e confirme qual é o intervalo da tabela. No exemplo abaixo, a base ocupa A1:D6:

Produto	Categoria	Status	Valor
Café	Bebida	Pago	35
Caneca	Acessório	Pendente	60
Filtro	Acessório	Pago	42
Chá	Bebida	Pago	22
Garrafa	Acessório	Pendente	85

Sintaxe da função QUERY

A estrutura oficial é QUERY(data, query, [headers]). Em linguagem simples:

• data é o intervalo analisado, como A1:D6;
• query é o texto com os comandos da consulta;
• headers informa quantas linhas do início do intervalo são cabeçalhos. Use 1 quando a primeira linha tiver os nomes das colunas.

Os exemplos usam vírgula entre os argumentos, como na página oficial da função. Se a sua planilha estiver configurada para usar ponto e vírgula como separador de argumentos, troque apenas os separadores externos da função; as vírgulas dentro do texto entre aspas continuam fazendo parte da consulta.

Como filtrar e escolher colunas

Para retornar somente produto e valor dos pedidos pagos, selecione uma célula fora da base e insira:

=QUERY(A1:D6,"select A, D where C = 'Pago'",1)

Em uma planilha que usa ponto e vírgula entre argumentos, a mesma fórmula fica:

=QUERY(A1:D6;"select A, D where C = 'Pago'";1)

select A, D escolhe as colunas A e D. Já where C = 'Pago' conserva as linhas em que a coluna C tem exatamente esse texto. Os identificadores de colunas são as letras da planilha quando a consulta recebe um intervalo direto.

Como ordenar o resultado

Para mostrar os pedidos pagos do maior para o menor valor, acrescente order by D desc:

=QUERY(A1:D6,"select A, D where C = 'Pago' order by D desc",1)

Use asc para ordem crescente e desc para ordem decrescente. A consulta aceita outras condições, como D > 40, ou combinações com and e or:

=QUERY(A1:D6,"select A, C, D where C = 'Pago' and D > 40",1)

Como agrupar e somar dados

Para resumir valores por categoria, use uma função de agregação, como sum, junto com group by:

=QUERY(A1:D6,"select B, sum(D) where C = 'Pago' group by B label sum(D) 'Total pago'",1)

Quando a consulta usa group by, cada coluna exibida precisa estar no agrupamento ou dentro de uma função de agregação. O comando label troca o nome técnico do resultado por um rótulo mais claro.

A linguagem também oferece limit para limitar a quantidade de linhas, offset para pular linhas e pivot para transformar valores distintos em colunas. A referência oficial da linguagem de consulta do Google lista a ordem e as regras dessas cláusulas.

QUERY ou filtro comum?

O filtro comum é mais simples quando a pessoa precisa apenas ocultar temporariamente algumas linhas da própria tabela. A QUERY é mais adequada quando o resultado deve aparecer em uma área separada, selecionar colunas específicas, combinar condições ou alimentar um resumo.

Para uma filtragem direta por critérios, consulte também o guia sobre como usar a função FILTER no Google Sheets. Se a necessidade for resumir uma base por categorias, o recurso de tabela dinâmica no Google Sheets pode ser mais visual.

Problemas comuns

• Resultado vazio: confira se o texto comparado está escrito exatamente como na coluna. A linguagem diferencia maiúsculas e minúsculas em identificadores e textos.
• Coluna não encontrada: em um intervalo direto, use letras como A e D. Em uma matriz criada dentro da fórmula, a documentação permite a notação Col1, Col2 e assim por diante. Não misture as duas formas sem adaptar o intervalo.
• Números tratados como vazios: revise se a coluna mistura números e textos. A QUERY pode considerar nulos os valores que não correspondem ao tipo predominante.
• Erro de análise da fórmula: verifique a localidade em Arquivo > Configurações. O Google informa que essa opção controla a formatação de números, datas e moedas e pode alterar o separador usado entre argumentos.

Limitações e cuidados

QUERY não substitui a organização da base. Cabeçalhos duplicados, colunas com tipos misturados e textos com grafia inconsistente dificultam a consulta. A função também não é SQL completo: ela usa a linguagem de consulta de visualizações do Google, que tem sua própria sintaxe e limitações.

Use uma aba separada para os resultados quando outras pessoas editarem a base original. Assim, a fórmula não fica no meio dos dados de entrada e há menos risco de alguém apagar ou sobrescrever o resultado. Revise também quem tem acesso ao arquivo: a QUERY reorganiza dados, mas não cria uma camada extra de proteção.

Fontes oficiais

• Documentação oficial da função QUERY;
• Referência oficial da Google Visualization API Query Language;
• Configurações de localidade, idioma e cálculo do Google Sheets.

Esta orientação se baseia na documentação oficial. As fórmulas são exemplos para adaptação à estrutura da sua planilha; não testamos o recurso em uma conta real.