Date, Time & Timestamptz
Sempre prefira timestamptz; armadilhas de fuso horário. Padrões práticos de PostgreSQL para consultas de produção.
Receita
SHOW TimeZone;
SET TimeZone = 'UTC';
SELECT now(), current_timestamp;Quando usar isso: Este padrão aparece em SQL de aplicação ou de relatórios que você mantém.
Exemplo de Trabalho
SELECT ts AT TIME ZONE 'America/Chicago' AS local_wall,
ts
FROM (SELECT timestamptz '2026-01-15 12:00:00+00' AS ts) s;O que isso demonstra:
- SQL executável contra esquemas de exemplo
- Sintaxe idiomática de PostgreSQL
- Padrões seguros para revisão de EXPLAIN
Mergulho Profundo
Como Funciona
- O PostgreSQL analisa o SQL em uma árvore de consulta.
- O planejador estima os custos usando estatísticas.
- O executor retorna linhas para o protocolo do cliente.
Notas
- Prefira SQL legível; otimizadores reescrevem internamente.
- Teste com contagens de linhas semelhantes à produção.
Armadilhas
- SELECT * em aplicativos - Novas colunas quebram serializadores. Correção: Liste as colunas explicitamente.
- Comparações NULL - = NULL é sempre desconhecido. Correção: Use IS NULL ou IS DISTINCT FROM.
- Conversões implícitas - Varreduras sequenciais inesperadas em tipos incompatíveis. Correção: Combine os tipos do predicado com os tipos da coluna.
- Consultas ilimitadas - Falta LIMIT em tabelas grandes. Correção: Paginar ou agregar intencionalmente.
- Estatísticas desatualizadas - Planos ruins após carga em massa. Correção: Execute ANALYZE nas tabelas afetadas.
Alternativas
| Alternativa | Use Quando | Não Use Quando |
|---|---|---|
| Construtor de consulta ORM | A equipe padroniza em uma única pilha | SQL complexo se torna opaco |
| Visão materializada | Repetir agregações caras | Precisa de estratégia de atualização |
| Réplica de data warehouse | Varreduras pesadas de BI | Não para latência OLTP |
FAQs
Devo formatar SQL em strings de aplicativo?
Use strings de modelo multilinhas ou arquivos SQL; verifique com lint em CI.
Quando DISTINCT é suficiente?
Quando você precisa de linhas únicas sem agregações.
ORDER BY prejudica os índices?
A ordenação pode usar a ordem do índice se a consulta corresponder às colunas do índice.
Relacionado
- Noções Básicas de Tipos de Dados - visão geral
Versões da pilha: Esta página foi escrita para PostgreSQL 18.4 (estável 18, manutenção 17), pgvector 0.8+, PgBouncer 1.x, Patroni 3.x e PostGIS 3.5+.