Документация The Internals of PostgreSQL получила раздел об асинхронном вводе-выводе и бета-главу о логической репликации
The Internals of PostgreSQL, онлайн-документация Хиронобу Судзуки (Hironobu Suzuki), которая объясняет, как устроены подсистемы PostgreSQL. По словам автора, главные цели, рассказать, как работает каждая подсистема, и дать целостную картину СУБД. Он описывает PostgreSQL как продуманную, открытую, универсальную реляционную систему управления базами данных, которой пользуются по всему миру, и отмечает: понимание внутреннего механизма важно и для администрирования, и для интеграции, но размер и сложность системы делают его трудным.
Свежие записи в списке «Что нового» (What's New): 26 сентября 2026 года, 11-я годовщина проекта (материал опубликован 26 сентября 2015 года); 28 июня 2026 года, опубликован раздел 8.5 «Асинхронный ввод-вывод в PostgreSQL» (Asynchronous I/O in PostgreSQL); 1 мая 2026 года, опубликована глава 12 «Логическая репликация» в бета-версии; 14 декабря 2024 года, добавлено описание конфликтов в разделе 11.2.4. Документация охватывает версии до 19-beta включительно, за исключением нового механизма блокировок страниц буфера.
Структура, 12 глав: 1) кластер базы данных, базы данных и таблицы; 2) архитектура процессов и памяти; 3) обработка запросов; 4) обёртки сторонних данных (FDW); 5) управление параллельным доступом (Concurrency Control); 6) обработка VACUUM; 7) Heap Only Tuple (HOT) и сканирование только по индексу; 8) менеджер буферов; 9) журнал упреждающей записи (WAL); 10) онлайн-резервное копирование и восстановление на момент времени (PITR); 11) потоковая репликация; 12) логическая репликация (бета-версия).
Автор сообщает, что некоторые научные статьи ссылались на эту документацию, а китайское издание вышло книгой в июне 2019 года. О себе он пишет, что окончил магистратуру по информационной инженерии, работал разработчиком и техническим руководителем, выпустил семь книг по базам данных и системной интеграции (четыре о PostgreSQL и три о MySQL), в 2010-2016 годах был директором Японской группы пользователей PostgreSQL (Japan PostgreSQL Users Group) и организовывал крупнейший в стране некоммерческий технический семинар по PostgreSQL. В июне 2022 года вышло интервью с ним в рубрике «PostgreSQL person of the week».
На главной странице также размещено объявление о поиске работы: после временного пребывания в Японии по личным обстоятельствам автор восстановился и хочет снова работать за рубежом, в Европе, Южном полушарии или Юго-Восточной Азии. Он ищет сложные задачи по PostgreSQL, роли со спонсированием визы или удалённую работу, совместимую с образом жизни цифрового кочевника, а также удалённую позицию по применению ML и ИИ к СУБД. Из-за инцидента с бэкдором в XZ автор не принимает обращения от анонимных лиц и просит при письме указывать не менее двух адресов в соцсетях для проверки. Права на материал сохраняет автор; образовательные учреждения могут пользоваться документацией свободно, по остальным вопросам использования нужно обращаться к автору.
Ключевые факты
- Документация The Internals of PostgreSQL впервые опубликована 26 сентября 2015 года; автор, Хиронобу Судзуки, на странице отмечена 11-я годовщина.
- 28 июня 2026 года добавлен раздел 8.5 «Асинхронный ввод-вывод в PostgreSQL», 1 мая 2026 года, глава 12 «Логическая репликация» (бета-версия).
- Описание охватывает версии до 19-beta включительно, кроме нового механизма блокировок страниц буфера; всего 12 глав, от процессов и памяти до WAL, PITR и репликации.
- Автор указывает, что на документацию ссылались некоторые научные статьи, а китайское издание вышло в июне 2019 года.
- На странице есть объявление автора о поиске работы: сложные задачи по PostgreSQL, спонсирование визы или удалённая работа.
Почему это важно
PostgreSQL широко используется, а его внутреннее устройство, по словам автора, сложно освоить из-за размера и числа взаимосвязанных подсистем. Эта документация пытается дать общую картину и разобрать подсистемы по отдельности. Новизна здесь скромная: материал существует с 2015 года, но свежие дополнения, раздел об асинхронном вводе-выводе и бета-глава о логической репликации, приближают его к актуальным версиям вплоть до 19-beta.
Кому это важно
Администраторам и разработчикам, которые работают с PostgreSQL и хотят понимать, как устроены обработка запросов, управление параллельным доступом, VACUUM, менеджер буферов, WAL, резервное копирование и репликация. Автор подчёркивает, что понимание внутреннего механизма важно и для администрирования, и для интеграции. Также может пригодиться тем, кто изучает СУБД: образовательным учреждениям автор разрешает пользоваться документацией свободно.
Как это применить
Читать можно по главам: оглавление из 12 глав позволяет начать с нужной подсистемы. Если интересует свежее, смотрите раздел 8.5 про асинхронный ввод-вывод и главу 12 про логическую репликацию (она пока в бета-версии). Для использования материала за пределами образовательных учреждений, а также его иллюстраций, автор просит обращаться к нему напрямую. Условия лицензии на странице не названы, указано только уведомление об авторских правах.
Можно ли доверять
Источник, главная страница самого проекта, то есть слова автора о собственной работе. Утверждения о том, что на документацию ссылались научные статьи, и о биографии автора на странице не подкреплены конкретными ссылками; какие именно статьи, не сказано. О содержании раздела 8.5 и главы 12 известны только их названия. Опыт автора (книги о PostgreSQL, работа в сообществе пользователей) заявлен им же.
Риски и подводные камни
Глава о логической репликации помечена как бета-версия, поэтому её содержание может меняться. Документация охватывает версию 19-beta, а не финальный выпуск, и исключает новый механизм блокировок страниц буфера. Часть главной страницы занимает личное объявление автора о поиске работы, так что это не новость о выходе нового продукта, а обновление давно существующего справочника. Автор не принимает обращения от анонимных лиц и просит указать не менее двух адресов в соцсетях.
«Главные цели этой документации, объяснить, как работает каждая подсистема, и дать целостную картину PostgreSQL.»
— Хиронобу Судзуки, автор документации The Internals of PostgreSQL