awesome
A curated list of awesome PostgreSQL hacking resources.
https://github.com/pghacking/awesome
Last synced: 16 days ago
JSON representation
-
Core Hacking
-
Books
- The Internals of PostgreSQL - Hironobu SUZUKI - The main purposes of this document are to explain how each subsystem works, and to provide the whole picture of PostgreSQL.
- PostgreSQL 14 Internals - Egor Rogov - This book is for those who will not settle for a black-box approach when working with a database.
- DeepWiki postgres - DeepWiki generated up-to-date postgres documentation.
-
Community
-
Contributing
- Developer FAQ
- So, you want to be a developer?
- Submitting a Patch
- Walk-through of implementing simple Postgres patch. From sources to CI. - Andrey Borodin
- PGConf.EU 2023, Making your patch more committable - Melanie Plageman
- PGConf.EU 2023, PostgreSQL Hacker Tips - Michael Paquier
- PGCon 2019, A journey from PostgreSQL enthusiast to committer - Amit Kapila - [slides](https://www.pgcon.org/2019/schedule/events/1327.en.html)
-
Executor
- Query Evaluation Techniques in PostgreSQL - Neil Conway, 2007.
- PGConf.EU 2024, PostgreSQL Executor: Executing your execution plan - Rafia Sabih - [slides](https://www.postgresql.eu/events/pgconfeu2024/sessions/session/5593/slides/565/PgConfEu2024.pdf)
-
General
- A Tour of PostgreSQL Internals - Tom Lane, 2000
- PostgreSQL Backend Flowchart
- Hooks in PostgreSQL - Guillaume Lelarge
- Unofficial documentation for PostgreSQL hooks - Tamika Nomara
- A Comprehensive Overview of PostgreSQL Query Processing Stages - Cary Huang
- PGConf.EU 2024, The Wire Protocol - Heikki Linnakangas - [slides](https://www.postgresql.eu/events/pgconfeu2024/sessions/session/5897/slides/589/Postgres%20protocol.pdf)
-
Indexes
- PGCon 2019, nbtree: An Architectrual Perspective - Peter Geoghegan - [slides](https://www.pgcon.org/2019/schedule/attachments/518_nbtree-arch-pgcon.pdf)
-
[Mailing Lists](https://www.postgresql.org/list/)
- pgsql-hackers - The PostgreSQL developers team lives here. Discussion of current development issues, problems and bugs, and proposed new features. If your question cannot be answered by people in the other lists, and it is likely that only a developer will know the answer, you may re-post your question in this list. You must try elsewhere first!
- pgsql-committers - Notification of git commits are sent to this list. Do not post here!
- pgsql-bugs - If you find a bug, please use the [bug reporting form](http://www.postgresql.org/support/submitbug).
- Posting Your Patch On pgsql-hackers - Robert Haas
- Will Postgres development rely on mailing lists forever? - Tomas Vondra
- Understanding the Postgres Hackers Mailing List Language - Greg Sabino Mullane
- Hackorum - A web-based archive and frontend for the PostgreSQL hackers mailing list.
- pgweekly - Postgres Weekly, A Hacker’s Digest of PostgreSQL hackers mailing list.
-
Parser
- PGCon 2019, Introducing PostgreSQL SQL Parser - Bo Peng - [slides](https://www.pgcon.org/2019/schedule/attachments/556_PostgreSQL_SQL_parser.pdf)
- flex & bison
- Lexical Analysis With Flex, for Flex 2.6.3
-
Partitioning
- Partitioning Improvements in PostgreSQL 11 - Robert Haas, 2018
-
Performance Analysis
- Dynamic Tracing
- Citus Con 2022, Analyzing Postgres performance problems using perf and eBPF - Andres Freund - [slides](https://anarazel.de/talks/2022-04-12-cituscon/perf-bpf.pdf)
- PGConf.dev 2024, Analyzing cacheline contention using perf c2c - Andres Freund - [slides](https://anarazel.de/talks/2024-05-29-pgconf-dev-c2c/postgres-perf-c2c.pdf)
- PgCon 2019, Let's Dtrace Postgres - Adam Wolk - [slides](https://www.pgcon.org/2019/schedule/attachments/541_Let's%20(D)Trace%20Postgres%20tracing%20the%20madness.pdf)
-
Planner
- Recent PostgreSQL Optimizer Improvements - Tom Lane, 2003
- Inside the PostgreSQL Query Optimizer - Neil Conway, 2005
- PGCon 2011, Hacking the Query Planner - Tom Lane
- PGCon 2020, Hacking the Query Planner, Again - Richard Guo - [slides](https://www.pgcon.org/events/pgcon_2020/sessions/session/39/slides/7/Hacking%20the%20Query%20Planner,%20Again.pdf)
- CMU Database Group, PostgreSQL Optimizer Methodology - Robert Haas
- PGCon 2019, Learning to Hack on Postgres Planner - Melanie Plageman
- Understand PostgreSQL's Planner – Simple Scan Paths vs Plans - Cary Huang.
- PGCon 2018, What's in a Plan - Robert Haas - [slides](https://drive.google.com/file/d/1U5ZO8FwiaHZqX3nPl40TOMKjWmOVqH_f/view)
- PGConf.EU 2024, A Deep Dive into Postgres Statistics - Louise Grandjonc
- PostgreSQL planner development and debugging - Sergey Solovev, 2025
- Postgres: planner internals (data structures and flow) - Amit Langote, 2025
-
Storage
- PGCon 2022, Breaking away from FREEZE and Wraparound - Masahiko Sawada
- PGConf.dev 2024, Problem in PostgreSQL SLRU - And how we are optimizing it - Dilip Kumar
- PGCon 2019, Pluggable able Access Methods - Pankaj Kapoor - [slides](https://www.pgcon.org/2019/schedule/attachments/536_pgcon2019_pluggable_table_AM_V1.3.pdf)
- PGCon 2019, Plugable Table Storage in PostgreSQL - Andres Freund - [slides](https://anarazel.de/talks/2019-05-30-pgcon-pluggable-table-storage/pluggable.pdf)
-
Test
- PGConf.dev 2025, Advanced testing with Injection Points - Michael Paquier - [slides](https://www.pgevents.ca/events/pgconfdev2025/sessions/session/260/slides/50/pgconf2025_Injection_Points.pdf)
-
Tools
- pg_plugins - Michael Paquier - Gathering of template plugins for PostgreSQL: background workers, logical replication things, etc.
- .devcontainer - Junwang Zhao - Unofficial devcontainer config for Postgres.
- PostgreSQL Hacker Helper - Sergey Solovev - VS Code extension for PostgreSQL core development: exploring Node variables, formatting, etc.
-
-
Extension Hacking
-
Tools
- pgrx - Build Postgres Extensions with Rust!
- pgzx - Create PostgreSQL extensions using Zig.
- PGCon 2023, Writing a Foreign Data Wrapper - Christophe Pettus
-
Programming Languages
Categories
Sub Categories