Поиск
Справочник

shared_buffers: сколько памяти дать PostgreSQL

shared_buffers — память, в которой PostgreSQL держит данные таблиц, чтобы не читать их каждый раз из файлов. После установки это 128MB. Документация PostgreSQL советует начинать с четверти памяти сервера, если на нём работает только база. Новое значение начинает действовать только после перезапуска базы.

≈ 7 мин чтения
Содержание 9

Что сделать прямо сейчас

  1. Подключитесь к серверу по SSH (как подключиться).
  2. Узнайте, сколько памяти на сервере: free -h. Нужна строка Mem:, столбец total. Цифра будет чуть меньше, чем в тарифе: часть памяти занимает сама система.
  3. Посмотрите текущее значение:
sudo -u postgres psql -c 'SHOW shared_buffers;'

После установки база ответит 128MB.

  1. Выберите новое значение по таблице ниже. Для примера — 512MB на сервере с 2 ГБ памяти.
  2. Создайте отдельный файл настроек:
sudo nano /etc/postgresql/16/main/conf.d/pamyat.conf

Впишите строку shared_buffers = 512MB и сохраните (Ctrl+O, Enter, Ctrl+X). Ubuntu читает все файлы .conf из папки conf.d.

  1. Перезапустите базу — без перезапуска shared_buffers не меняется:
sudo pg_ctlcluster 16 main restart

При перезапуске все подключения к базе обрываются: делайте это, когда на сайте мало посетителей.

  1. Проверьте ещё раз командой из шага 3 — база должна ответить 512MB.

Если после перезапуска база не запустилась, посмотрите журнал: sudo tail -n 30 /var/log/postgresql/postgresql-16-main.log. Разбор строк — в таблице ошибок.

Сколько поставить

Память сервераshared_buffers
меньше 1 ГБоставьте 128MB
1 ГБ256MB
2 ГБ512MB
4 ГБ1GB
8 ГБ2GB
16 ГБ4GB

Это четверть памяти — так документация PostgreSQL предлагает начинать на сервере, где работает только база и памяти от 1 ГБ. Больше 40 % памяти она не советует: PostgreSQL читает файлы таблиц ещё и через кэш системы, и этому кэшу тоже нужна память. На сервере меньше 1 ГБ документация советует долю меньше четверти, чтобы хватило системе.

Если на том же сервере работает сайт — nginx, PHP, Node.js или Python, — им тоже нужна память. Тогда возьмите значение на строку выше в таблице и посмотрите в free -h, сколько памяти остаётся свободной в столбце available.

Как записывать значение

  • Единицы пишутся так: kB, MB, GB. Регистр важен: 512mb база не примет и не запустится.
  • Число без единиц база поймёт как число блоков по 8 КБ: shared_buffers = 512 — это 4 МБ, а не 512.
  • В 1 ГБ — 1024 МБ: 1GB и 1024MB — одно и то же.

То же можно сделать командой в консоли базы, без правки файлов:

ALTER SYSTEM SET shared_buffers = '512MB';

Команда записывает значение в файл postgresql.auto.conf в папке данных базы. После неё тоже нужен перезапуск. Значение из postgresql.auto.conf главнее postgresql.conf: если что-то задали через ALTER SYSTEM, правка в conf.d не подействует. Убрать такое значение: ALTER SYSTEM RESET shared_buffers;.

Как проверить, что значение применилось

SELECT name, setting, unit, sourcefile, pending_restart
FROM pg_settings WHERE name = 'shared_buffers';
СтолбецЧто значит
setting и unitзначение в блоках: 65536 и 8kB — это 65536 × 8 КБ = 512 МБ
sourcefileиз какого файла взято значение; видно, если вы вошли как postgres
pending_restartt — файл поменяли, но базу ещё не перезапустили

Если вместо перезапуска выполнить reload, значение не сменится, а в журнале появится строка parameter "shared_buffers" cannot be changed without restarting the server.

Хватает ли базе памяти

Сколько раз нужные данные нашлись в shared_buffers, а сколько раз их пришлось читать из файлов, база считает сама. Вместо shop — имя вашей базы:

SELECT datname, blks_hit, blks_read,
       round(blks_hit * 100.0 / nullif(blks_hit + blks_read, 0), 1) AS iz_pamyati
FROM pg_stat_database WHERE datname = 'shop';
  • blks_hit — данные нашлись в shared_buffers.
  • blks_read — данные пришлось читать из файлов. Часть таких чтений система отдаёт из своего кэша, без диска.
  • iz_pamyati — доля чтений из shared_buffers в процентах.

Счётчики копятся с момента сброса статистики. Запишите число, поменяйте shared_buffers и сравните через день-два работы сайта: если доля выросла, память пошла впрок.

Другие настройки памяти

НастройкаНа что памятьПо умолчаниюНужен перезапуск
work_memодна сортировка или хеш-таблица внутри запроса; что не влезло — пишется во временный файл4MBнет, reload
maintenance_work_memVACUUM, CREATE INDEX, добавление внешнего ключа, загрузка дампа64MBнет, reload
effective_cache_sizeпамять не занимает: подсказка базе, сколько данных поместится в кэш4GBнет, reload
temp_buffersвременные таблицы одного подключения8MBнет
shared_buffersданные таблиц для всех подключений128MBда

work_mem. Если в журнале появляются строки о временных файлах (настройка log_temp_files), запросам не хватает work_mem. Хеш-таблицам разрешено вдвое больше work_mem: так задаёт настройка hash_mem_multiplier, по умолчанию 2.

work_mem выделяется на каждую сортировку в каждом запросе: сложный запрос берёт его несколько раз, и так в каждом подключении. 100 подключений по 64MB могут попросить больше памяти, чем есть на сервере. Поднимайте work_mem понемногу или только для одного пользователя: ALTER ROLE ivan SET work_mem = '16MB'; — действует с его следующего подключения.

maintenance_work_mem. Её можно поднять смелее, чем work_mem: такие операции в одном подключении идут по одной. Больше памяти — быстрее создаются индексы и загружается дамп. Автоочистка берёт её на каждый свой процесс, поэтому на сервере с 1–2 ГБ не ставьте сотни мегабайт.

effective_cache_size. Память под неё не выделяется: база только решает по ней, выгодно ли читать таблицу по индексу. Значение по умолчанию 4GB больше всей памяти сервера с 1–2 ГБ. Поставьте сумму shared_buffers и памяти, которую система держит под кэш файлов, — столбец buff/cache в free -h.

Эти настройки пишут в тот же файл conf.d/pamyat.conf и применяют без перезапуска: sudo pg_ctlcluster 16 main reload.

Ошибки и как их исправить

Что видитеПричинаЧто делать
FATAL: could not map anonymous shared memory: …shared_buffers больше, чем база смогла получить памятиуменьшите значение в conf.d/pamyat.conf и запустите базу: sudo pg_ctlcluster 16 main start; в строке HINT база пишет, сколько байт просила
invalid value for parameter "shared_buffers": "512mb"единицы строчными буквамипишите 512MB; в HINT база перечисляет, какие единицы подходят
configuration file "…" contains errorsв одном из файлов настроек ошибкастрокой выше в журнале — какая настройка и в каком файле
ERROR: parameter "shared_buffers" cannot be changed without restarting the serverвы пытаетесь поменять shared_buffers командой SETвпишите значение в файл и перезапустите базу
база не запускается после перезапускаошибка в значении или не хватает памятиsudo tail -n 30 /var/log/postgresql/postgresql-16-main.log, как читать журнал

Всё сверено с PostgreSQL 16 — эта версия ставится в Ubuntu 24.04.

Источники

Сверено 5 ноября 2026 года.

Если не хочется держать базу на своём сервере. Есть облачные базы данных: MySQL, PostgreSQL или Redis без своего VPS, например в Timeweb Cloud Реклама. АО «ТАЙМВЭБ», ИНН 7810353960. erid: CQH36pWzJpoBWKF332yG5h2XQ4cVubfBmkvqAitFqcpzWs. Когда это выгоднее своего сервера, а когда нет, — в статье Сервер для базы данных.

Что почитать дальше