Hatchet publica una guía práctica dirigida a ingenieros que operan Postgres en producción, destilando dos años de experiencia en batallas reales contra caídas y cuellos de botella. El documento parte de un nivel básico —asumiendo familiaridad con SQL, tablas, filas e índices— y avanza hacia temas intermedios y avanzados.
En el apartado de fundamentos, la guía aborda el diseño de esquemas (uso de columnas de identidad o UUID, claves primarias, claves foráneas con borrado en cascada y timestamptz), la escritura de consultas de lectura eficientes (aprovechar btrees, evitar sequential scans en tablas grandes), las joins performantes usando claves primarias y la creación de índices compuestos alineados con cláusulas ORDER BY. También cubre la escritura de transacciones cortas, el cuidado con los bloqueos de fila y el uso obligatorio de CREATE INDEX CONCURRENTLY al indexar tablas grandes para evitar downtime. Un capítulo dedicado a migraciones aboga por cambios aditivos, ejecutados en transacción y, cuando proceda, por patrones expand and contract de Martin Fowler.
En el bloque intermedio se exploran el query planner, las actualizaciones masivas y el comportamiento del autovacuum. El documento incorpora además una nota sobre ORMs —recomendando sqlc para stacks en Go o alternativas como Prisma TypedSQL cuando se necesita romper la capa de abstracción— y una sección sobre gestión de conexiones que desaconseja el churn de conexiones y propone poolers externos como pgbouncer o, en su defecto, poolers en memoria. La guía se concibe como un documento vivo que la comunidad puede enriquecer con nuevas lecciones aprendidas en producción.