Rodar a consulta uma vez com literais nunca reproduz o problema. Para ver o que a aplicação vê, é preciso preparar o statement, executá-lo cinco vezes na mesma sessão e só então pedir o plano. O sinal mais claro está nas condições do plano: o plano genérico mostra $1, $2 e $3 no Index Cond, enquanto o plano custom mostra os valores.
-- A consulta do relatório, preparada exatamente como a API faz.
PREPARE relatorio_diario(bigint, timestamptz, timestamptz) AS
SELECT date_trunc('day', p.criado_em) AS dia,
count(DISTINCT p.id) AS pedidos,
sum(i.quantidade * i.preco_centavos) AS receita_centavos
FROM pedidos p
JOIN itens_pedido i ON i.pedido_id = p.id
WHERE p.tenant_id = $1
AND p.criado_em >= $2
AND p.criado_em < $3
GROUP BY 1
ORDER BY 1;
-- Cinco execuções: cada uma recebe um plano custom, montado com os valores reais.
EXECUTE relatorio_diario(12, '2026-10-01', '2026-11-01');
EXECUTE relatorio_diario(88, '2026-10-01', '2026-11-01');
EXECUTE relatorio_diario(7, '2026-10-01', '2026-11-01'); -- o tenant 7 tem 30% dos pedidos e entra na média de custo
EXECUTE relatorio_diario(301, '2026-10-01', '2026-11-01');
EXECUTE relatorio_diario(45, '2026-10-01', '2026-11-01');
-- Sexta execução: o plano genérico é montado, comparado com a média e passa a valer.
-- Repare no $1: o plano não sabe qual tenant nem qual intervalo está consultando.
EXPLAIN (ANALYZE, BUFFERS)
EXECUTE relatorio_diario(7, '2026-10-01', '2026-11-01');
GroupAggregate (cost=1262.40..1270.15 rows=200) (actual time=51874.120..52031.556 rows=31 loops=1)
-> Sort (cost=1262.40..1263.34 rows=375) (actual time=51870.004..51998.231 rows=2741893 loops=1)
Sort Key: (date_trunc('day'::text, p.criado_em))
Sort Method: external merge Disk: 96432kB
-> Nested Loop (cost=1.13..1246.37 rows=375) (actual time=0.061..49702.818 rows=2741893 loops=1)
Buffers: shared hit=2944120 read=1206345
-> Index Scan using pedidos_tenant_criado_idx on pedidos p
(cost=0.56..142.10 rows=125) (actual time=0.031..2210.405 rows=905117 loops=1)
Index Cond: ((tenant_id = $1) AND (criado_em >= $2) AND (criado_em < $3))
-> Index Scan using itens_pedido_pedido_idx on itens_pedido i
(cost=0.57..8.80 rows=3) (actual time=0.018..0.051 rows=3 loops=905117)
Index Cond: (pedido_id = p.id)
Execution Time: 52088.307 ms
-- A mesma execução com plano custom: o Postgres enxerga tenant_id = 7.
SET plan_cache_mode = force_custom_plan;
EXPLAIN (ANALYZE, BUFFERS)
EXECUTE relatorio_diario(7, '2026-10-01', '2026-11-01');
Sort (actual time=3412.880..3412.884 rows=31 loops=1)
-> HashAggregate (actual time=3412.102..3412.611 rows=31 loops=1)
-> Hash Join (rows=2703900) (actual time=688.214..2902.731 rows=2741893 loops=1)
Hash Cond: (i.pedido_id = p.id)
...
-> Hash (rows=901300) (actual time=681.540..681.541 rows=905117 loops=1)
-> Bitmap Heap Scan on pedidos p (rows=901300) ...
Recheck Cond: ((tenant_id = 7) AND (criado_em >= '2026-10-01 ...
Execution Time: 3415.204 ms
RESET plan_cache_mode;
-- Quantas vezes cada statement desta sessão usou cada tipo de plano (PostgreSQL 14+).
SELECT name, generic_plans, custom_plans
FROM pg_prepared_statements;
-- relatorio_diario | 1 | 6
-- PostgreSQL 16+: mostra o plano genérico sem precisar preparar nem executar.
EXPLAIN (GENERIC_PLAN)
SELECT count(*) FROM pedidos WHERE tenant_id = $1 AND criado_em >= $2 AND criado_em < $3;
Em produção, o auto_explain com log_min_duration ajustado para alguns segundos registra os planos lentos com os $1 visíveis, o que já basta para apontar o plano genérico. A view pg_prepared_statements, a partir do PostgreSQL 14, mostra as colunas generic_plans e custom_plans, mas só enxerga os statements da própria sessão: precisa ser consultada pela mesma conexão da aplicação, não por um psql aberto ao lado. No PostgreSQL 16, EXPLAIN (GENERIC_PLAN) mostra o plano genérico de uma consulta com $1 sem precisar prepará-la.