Understand what PostgreSQL is really doing
Free browser-based tools and no-fluff guides for developers who work with PostgreSQL every day: read query plans, pick the right index, keep VACUUM happy.
Tools
PostgreSQL guides
All guides →How to read EXPLAIN ANALYZE
Costs vs actual times, per-loop averages, buffers, and the classic traps that make plans lie to you.
GuideChoosing the right index
B-tree, GIN, GiST, BRIN and friends: what each index type is for, plus partial, expression and covering indexes.
GuideVACUUM, autovacuum and bloat
Why MVCC leaves dead rows behind, how autovacuum decides when to run, and how to spot a table that's bloating.
GuideTransaction isolation levels
Read Committed vs Repeatable Read vs Serializable in practice: anomalies, serialization errors, and when to retry.
ReferencePostgreSQL cheat sheet
The everyday commands on one printable sheet — or grab the ready-made two-page PDF with the logo and clickable links.
PostgreSQL error reference
All errors →deadlock detected
Two transactions each hold a lock the other needs. How to read the DETAIL lines and the lock-ordering habits that prevent it.
Errortoo many clients already
max_connections is exhausted. Who is holding the slots, and why the durable fix is usually a pooler, not a bigger limit.
Errorduplicate key value
A unique constraint did its job — the interesting question is why: an insert race, a stale sequence, or a client retrying.
Errorrelation does not exist
The table exists — you're just not looking where PostgreSQL is looking: search_path, quoted identifiers, wrong database.
Why pgviz?
Reading a raw PostgreSQL query plan is hard: timings are cumulative, row counts are per-loop averages, and the interesting problems (bad estimates, sorts spilling to disk, expensive nested loops) hide in the details. The tools on this site do the arithmetic for you and point at what actually matters, and the guides explain the concepts behind the numbers.
Everything here is free, works offline once loaded, and sends nothing to any server. Alongside the tools you'll find practical guides and a growing reference of common PostgreSQL errors — what each one means, why it happens and how to fix it. More is coming: a postgresql.conf generator and an index size calculator.
