shared_buffers: сколько памяти дать PostgreSQL
shared_buffers — память, в которой PostgreSQL держит данные таблиц, чтобы не читать их каждый раз из файлов. После установки это 128MB. Документация PostgreSQL советует начинать с четверти памяти сервера, если на нём работает только база. Новое значение начинает действовать только после перезапуска базы.
Содержание 9
Что сделать прямо сейчас
- Подключитесь к серверу по SSH (как подключиться).
- Узнайте, сколько памяти на сервере:
free -h. Нужна строкаMem:, столбецtotal. Цифра будет чуть меньше, чем в тарифе: часть памяти занимает сама система. - Посмотрите текущее значение:
sudo -u postgres psql -c 'SHOW shared_buffers;' После установки база ответит 128MB.
- Выберите новое значение по таблице ниже. Для примера — 512MB на сервере с 2 ГБ памяти.
- Создайте отдельный файл настроек:
sudo nano /etc/postgresql/16/main/conf.d/pamyat.conf Впишите строку shared_buffers = 512MB и сохраните (Ctrl+O, Enter, Ctrl+X). Ubuntu читает все файлы .conf из папки conf.d.
- Перезапустите базу — без перезапуска shared_buffers не меняется:
sudo pg_ctlcluster 16 main restartПри перезапуске все подключения к базе обрываются: делайте это, когда на сайте мало посетителей.
- Проверьте ещё раз командой из шага 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_restart | t — файл поменяли, но базу ещё не перезапустили |
Если вместо перезапуска выполнить 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_mem | VACUUM, 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.
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.
Источники
- PostgreSQL 16: Resource Consumption — на английском: shared_buffers, четверть памяти и не больше 40 %, work_mem, hash_mem_multiplier, maintenance_work_mem, temp_buffers и значения по умолчанию.
- PostgreSQL 16: Query Planning — на английском: effective_cache_size не выделяет память, по умолчанию 4GB.
- PostgreSQL 16: Setting Parameters — на английском: единицы памяти, регистр, postgresql.auto.conf главнее postgresql.conf.
- PostgreSQL 16: ALTER SYSTEM — на английском: ALTER SYSTEM SET и RESET.
- PostgreSQL 16: pg_settings — на английском: столбцы setting, unit, sourcefile и pending_restart.
- PostgreSQL 16: Cumulative Statistics System — на английском: blks_hit и blks_read в pg_stat_database.
- Исходный код PostgreSQL 16: guc.c — тексты invalid value for parameter, contains errors и cannot be changed without restarting the server.
- Исходный код PostgreSQL 16: sysv_shmem.c — текст could not map anonymous shared memory.
Сверено 5 ноября 2026 года.
Что почитать дальше
- max_connectionsсколько подключений принимает база и сколько памяти они берут.
- Медленные запросыкак найти, какой запрос тормозит сайт.
- Журнал PostgreSQLгде смотреть, почему база не запустилась.
- Настройки PostgreSQLгде лежат файлы настроек и как их перечитать.