Mejores Prácticas de PostGIS

Cómo Usar Esta Lista

• Aplica en cada tabla geoespacial nueva y en cada pipeline ETL.
• Revisa después de importar archivos shapefile o GeoJSON en masa.
• Combina con el artículo de índices espaciales antes del lanzamiento del mapa de producción.

A - Modelo de Datos

• Almacena el SRID con cada geometría. Usa typmod geometry(Type, 4326) o fuerza ST_SRID(geom) = 4326.
• Valida las entradas en la ingesta. Restricción ST_IsValid(geom) o tabla de cuarentena ETL para los rechazados.
• Usa geography para radios en metros de GPS. Convierte o usa el tipo de columna geography para ST_DWithin en metros.
• Usa geometría proyectada para trabajo planar local. UTM para parcelas de ciudad, no distancia de geometría 4326.
• Documenta el orden lon/lat. ST_MakePoint(longitud, latitud) en la guía de estilo del equipo.

B - Índices y Consultas

• Crea un índice GiST en las columnas usadas en WHERE espacial. geom y geography según se consulten.
• Prefiltra con el sobre && antes de ST_Intersects. Patrón de dos etapas amigable para índices.
• Usa ST_DWithin en lugar de ordenar por ST_Distance en la tabla completa. Límite de radio y luego ordena un conjunto pequeño.
• Construye índices CONCURRENTLY en tablas grandes. Planifica ANALYZE después de la importación.
• Aplica el filtro tenant_id antes de la operación espacial. Reduce el rango de escaneo del índice en SaaS.

C - Rendimiento y APIs

• Almacena geometrías simplificadas para capas de bajo zoom. ST_SimplifyPreserveTopology fuera de línea.
• LIMIT de características por solicitud de tile de mapa. Rechaza bounding boxes a escala mundial de los clientes.
• Sirve tiles a través de un servidor de tiles cuando sea posible. PostGIS es la fuente de verdad, no un render farm.
• Emite GeoJSON en el límite de la API. No almacenes texto GeoJSON en lugar del tipo de geometría.
• Monitoriza ST_NPoints en la ingesta. Polígonos complejos alertan antes de la hinchazón del GiST.

D - Operaciones

• Fija la versión de PostGIS en la lista blanca de ADR. ALTER EXTENSION postgis UPDATE con pruebas de humo.
• Ejecuta postgis_extensions_upgrade cuando la documentación lo requiera. Después de saltos mayores de PG o menores de PostGIS.
• REINDEX GiST después de cargas masivas de shapefiles. Programa CONCURRENTLY donde sea compatible.
• Mantén PostGIS en el esquema extensions. Evita el desorden en search_path público.
• Prueba pares de distancias conocidos. Consulta de cordura geodésica de NYC a LA en CI staging.

Preguntas Frecuentes

Relacionados

• Conceptos Básicos de PostGIS - Servidores Postgres vs. tiles
• Geometría vs. Geografía - Selección de tipo
• Índices Espaciales - Patrones GiST
• Rendimiento de PostGIS - Simplificar y prefiltrar
• Mejores Prácticas de Extensiones - Fijaciones de versión

Versiones de Stack: Esta página fue escrita para PostgreSQL 18.4 (estable 18, mantenimiento 17), pgvector 0.8+, PostGIS 3.5+, pgbouncer 1.x, y Patroni 3.x.