Melhores Práticas do PostGIS

Como Usar Esta Lista

• Aplique em cada nova tabela geoespacial e pipeline ETL.
• Reaudite após importações em massa de shapefile ou GeoJSON.
• Combine com o artigo de índice espacial antes do lançamento do mapa em produção.

A - Modelo de Dados

• Armazene o SRID com cada geometria. Use typmod geometry(Type, 4326) ou force ST_SRID(geom) = 4326.
• Valide as entradas na ingestão. Restrição ST_IsValid(geom) ou tabela de quarentena ETL para rejeitados.
• Use geografia para raios em metros de GPS. Converta ou use o tipo de coluna geography para ST_DWithin em metros.
• Use geometria projetada para trabalho planar local. UTM para parcelas de cidade, não distância de geometria 4326.
• Documente a ordem lon/lat. ST_MakePoint(longitude, latitude) no guia de estilo da equipe.

B - Índices e Consultas

• Crie índice GiST em colunas usadas em WHERE espacial. geom e geography conforme consultado.
• Pré-filtre com envelope && antes de ST_Intersects. Padrão de dois estágios amigável ao índice.
• Use ST_DWithin em vez de ST_Distance para ordenar em tabela completa. Limite de raio e depois ordene um pequeno conjunto.
• Construa índices CONCURRENTLY em tabelas grandes. Planeje ANALYZE após a importação.
• Aplique filtro tenant_id antes da operação espacial. Reduz o intervalo de varredura do índice em SaaS.

C - Desempenho e APIs

• Armazene geometrias simplificadas para camadas de zoom baixo. ST_SimplifyPreserveTopology offline.
• LIMITE recursos por solicitação de tile de mapa. Rejeite bounding boxes de escala mundial dos clientes.
• Sirva tiles via tile server quando possível. PostGIS é a fonte da verdade, não a fazenda de renderização.
• Emita GeoJSON na fronteira da API. Não armazene texto GeoJSON em vez do tipo geometria.
• Monitore ST_NPoints na ingestão. Polígonos complexos alertam antes do inchaço do GiST.

D - Operações

• Fixe a versão do PostGIS na lista de permissões ADR. ALTER EXTENSION postgis UPDATE com testes de fumaça.
• Execute postgis_extensions_upgrade quando a documentação exigir. Após saltos maiores do PG ou menores do PostGIS.
• REINDEX GiST após cargas massivas de shapefile. Agende CONCURRENTLY onde suportado.
• Mantenha o PostGIS no schema de extensões. Evite poluir o search_path público.
• Teste pares de distância conhecidos. Consulta de sanidade geodésica NYC para LA em staging de CI.

FAQs

Relacionados

• Noções Básicas de PostGIS - Postgres vs servidores de tile
• Geometria vs Geografia - seleção de tipo
• Índices Espaciais - padrões GiST
• Desempenho do PostGIS - simplificar e pré-filtrar
• Melhores Práticas de Extensões - pins de versão

Versões da Stack: Esta página foi escrita para PostgreSQL 18.4 (estável 18, manutenção 17), pgvector 0.8+, PostGIS 3.5+, pgbouncer 1.x e Patroni 3.x.