...
Eroare PostgreSQL · Roluri, drepturi, configurare și conexiuni

ERROR: parameter "shared_buffers" cannot be changed without restarting the server

Pe scurt

Parametrul se poate schimba doar la pornirea serverului (context postmaster), nu cu SET într-o sesiune. Exemple: shared_buffers, max_connections, wal_level. Schimbă-l în postgresql.conf sau cu ALTER SYSTEM și repornește serverul; pentru memorie pe o singură interogare, folosește work_mem.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Fiecare parametru are un context care spune când poate fi schimbat (coloana context din pg_settings): postmaster doar la pornire, sighup la reîncărcarea configurației, superuser și user oricând în sesiune. shared_buffers (memoria partajată pentru cache), max_connections, wal_level, shared_preload_libraries sunt postmaster: zona lor de memorie se alocă la pornire. Mesajul înrudit parameter "max_wal_size" cannot be changed now apare pentru parametrii sighup, care se schimbă în fișier și se aplică la reload, nu cu SET.

Procedura: ALTER SYSTEM SET shared_buffers = '2GB' (scrie în postgresql.auto.conf), apoi repornirea serverului; pending_restart din pg_settings arată ce așteaptă repornirea. Pentru nevoi punctuale de memorie ale unei interogări, parametrul potrivit e work_mem (sau maintenance_work_mem pentru indecși și VACUUM), care se schimbă în sesiune.

De ce apare: cauzele frecvente

1Memorie mărită pentru un raport

Greșit
SQL
SET shared_buffers = '4GB';
Corect
SQL
SET LOCAL work_mem = '256MB';  -- doar pentru tranzacția raportului

work_mem controlează memoria unei operații și se schimbă în sesiune.

2Schimbare permanentă a cache-ului

Greșit
SQL
SET shared_buffers = '4GB';
Corect
SQL
ALTER SYSTEM SET shared_buffers = '4GB';
-- repornire server, apoi SHOW shared_buffers;

Valoarea nouă se aplică după repornire.

Repară tu

Repară eroarea, direct în pagină

Raportul anual vrea mai multă memorie pentru sortări și încearcă SET shared_buffers, care dă parameter "shared_buffers" cannot be changed without restarting the server. Folosește în schimb SET LOCAL work_mem = 256MB într-o tranzacție și afișează valoarea work_mem în interiorul ei.

Codul care dă eroarea
SQL
BEGIN;
SET shared_buffers = '4GB';
SHOW shared_buffers;
COMMIT;
După reparație, programul afișează
BEGIN
SET
 work_mem
----------
 256MB
(1 rând)

COMMIT
Indiciu

BEGIN; SET LOCAL work_mem = '256MB'; SHOW work_mem; COMMIT;

Alte forme ale mesajului

  • ERROR: parameter "max_wal_size" cannot be changed now
  • ERROR: parameter "max_connections" cannot be changed without restarting the server

Cum o eviți pe viitor

  • Verifică context în pg_settings înainte să schimbi un parametru.
  • Planifică modificările de tip postmaster în ferestre de mentenanță.
  • Folosește SET LOCAL work_mem pentru interogări grele punctuale.
  • Verifică pending_restart după ALTER SYSTEM.
  • Documentează în runbook ce parametri cer repornire.

Întrebări frecvente

Cât să fie shared_buffers?

Un punct de plecare uzual este circa 25% din memoria RAM a serverului, ajustat după monitorizare.

Ce face pg_reload_conf()?

Reîncarcă configurația fără repornire; se aplică doar parametrilor cu context sighup sau mai permisiv.

Erori înrudite

← Toate erorile PostgreSQL

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață PostgreSQL de la zero, cu exerciții la fiecare lecție

Curs PostgreSQL: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 10 lecții sunt gratuite.