O nome definido com WITH
Uma CTE (common table expression, ou expressão de tabela comum) dá nome a um resultado que pode ser consultado dentro da mesma instrução SQL. Você a declara com WITH e usa esse nome nas partes seguintes da instrução, como origem de linhas.
Total por região, seguido de um filtro
O exemplo didático abaixo usa uma tabela vendas com as colunas regiao e valor. A CTE totais calcula a soma por região para que a consulta principal filtre os resultados desse cálculo.
WITH totais AS ( SELECT regiao, SUM(valor) AS total FROM vendas GROUP BY regiao)SELECT regiao, totalFROM totaisWHERE total > 1000;Uma região com vendas de 600 e 500 tem total 1100 e aparece no resultado. Uma região com total 900 fica fora. O filtro compara a soma de cada região com 1000, sem descartar individualmente as vendas menores que esse valor.
Escopo e avaliação
O nome totais existe somente nessa instrução. A CTE permite acompanhar o cálculo intermediário sem criar uma tabela permanente para consultas posteriores.
A divisão da escrita não determina uma execução separada de cada parte. O PostgreSQL pode integrar uma CTE à consulta principal quando as condições de otimização permitem. A materialização e as opções MATERIALIZED e NOT MATERIALIZED afetam essa avaliação, por isso o uso de WITH por si só não demonstra ganho de desempenho.
Dúvidas frequentes
Perguntas frequentes sobre CTE
- Uma CTE fica disponível para a próxima consulta?
- O nome declarado com WITH pertence à instrução que contém a CTE. Outra instrução precisa declarar novamente a expressão ou usar um objeto persistente, como uma visão.
- Toda CTE é materializada no PostgreSQL?
- No PostgreSQL 18, uma CTE SELECT não recursiva e sem funções voláteis pode ser integrada à consulta principal. Por padrão, isso ocorre quando há uma única referência a ela.
- Como funciona uma CTE recursiva?
- A forma WITH RECURSIVE combina uma parte inicial com outra que consulta os resultados da etapa anterior. O percurso precisa terminar quando não houver novas linhas. Hierarquias com ciclos exigem tratamento para evitar repetição indefinida.
Para continuar
Recursos relacionados
Documentação
PostgreSQL: CTEs, materialização e recursão
Avaliação de expressões WITH e condições das consultas recursivas.
Abrir recursoDocumentação
PostgreSQL: escopo de WITH em SELECT
Referências às expressões auxiliares dentro de uma instrução SELECT.
Abrir recursoSite de referência
Dev Side Studio: Desenvolvimento Colaborativo
O Desenvolvimento Colaborativo oferece orientação ao vivo para revisar os cálculos intermediários de uma consulta com CTEs.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
Você pode conferir os cálculos e filtros de uma consulta gerada por agentes examinando as partes nomeadas pela cláusula WITH.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.