O que uma query consulta
Uma query é uma consulta ao banco de dados para obter informações. Em SQL, a instrução SELECT descreve o resultado desejado. Você pode selecionar colunas de uma tabela ou calcular expressões, como a soma de dois campos numéricos.
A cláusula FROM indica a origem das linhas. O filtro WHERE mantém somente aquelas que satisfazem a condição informada. Essas partes definem o significado da consulta, mas a ordem das linhas no resultado exige uma indicação própria: ORDER BY.
Nomes dos produtos ativos em SQL
Neste exemplo didático, a tabela produtos tem as colunas id, nome e ativo. O campo ativo é booleano e registra se o produto está ativo:
SELECT nomeFROM produtosWHERE ativo = trueORDER BY nome, id;O banco retorna apenas o nome de cada produto com ativo igual a true. A coluna id participa da ordenação para desempatar nomes iguais, embora não apareça no resultado. Você recebe os nomes em ordem crescente conforme a ordenação de texto configurada no banco.
Uma resposta vazia indica que nenhuma linha satisfez esse filtro. Já a ausência de ORDER BY deixa a ordem indefinida, mesmo que várias execuções apresentem a mesma sequência. Ao conferir uma listagem da aplicação, compare os produtos retornados com o filtro e a ordenação escritos na consulta.
Dúvidas frequentes
Perguntas frequentes sobre query
- Uma query precisa retornar todas as colunas?
- Não. Você pode selecionar colunas específicas ou expressões calculadas. O asterisco em SELECT * inclui todas as colunas disponíveis na origem consultada.
- Uma consulta pode retornar zero linhas sem falhar?
- Sim. Quando nenhuma linha satisfaz o filtro de WHERE, o resultado fica vazio. Isso é diferente de um erro de sintaxe ou de uma tabela inexistente.
- Como manter uma ordem definida quando há nomes iguais?
- Use uma segunda coluna em ORDER BY para desempatar. Um identificador único permite distinguir as linhas que possuem o mesmo nome.
Para continuar
Recursos relacionados
Documentação
PostgreSQL: consultas e seleção de resultados
Tutorial do PostgreSQL sobre seleção de colunas, expressões, filtros e ordenação, com consultas e resultados comentados.
Abrir recursoSite de referência
DevSide: desenvolvimento colaborativo
Sessão de desenvolvimento acompanhado para investigar consultas e conferir o resultado na aplicação.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
Ao desenvolver uma listagem, você confere os filtros da consulta SQL para verificar por que determinados registros aparecem na aplicação.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.