ERROR: parameter "shared_buffers" cannot be changed without restarting the server
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
SET shared_buffers = '4GB';SET LOCAL work_mem = '256MB'; -- doar pentru tranzacția raportuluiwork_mem controlează memoria unei operații și se schimbă în sesiune.
2Schimbare permanentă a cache-ului
SET shared_buffers = '4GB';ALTER SYSTEM SET shared_buffers = '4GB';
-- repornire server, apoi SHOW shared_buffers;Valoarea nouă se aplică după repornire.
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.
BEGIN;
SET shared_buffers = '4GB';
SHOW shared_buffers;
COMMIT;BEGIN SET work_mem ---------- 256MB (1 rând) COMMIT
Indiciu
BEGIN; SET LOCAL work_mem = '256MB'; SHOW work_mem; COMMIT;
Reparația
BEGIN;
SET LOCAL work_mem = '256MB';
SHOW work_mem;
COMMIT;De ce merge
shared_buffers se alocă la pornirea serverului și nu poate fi schimbat într-o sesiune. Memoria pentru sortările unei interogări este controlată de work_mem, iar SET LOCAL o mărește doar până la finalul tranzacției, fără să afecteze alte sesiuni. În tranzacție, SHOW work_mem afișează 256MB.
Alte forme ale mesajului
ERROR: parameter "max_wal_size" cannot be changed nowERROR: parameter "max_connections" cannot be changed without restarting the server
Cum o eviți pe viitor
- Verifică
contextînpg_settingsînainte să schimbi un parametru. - Planifică modificările de tip
postmasterîn ferestre de mentenanță. - Folosește
SET LOCAL work_mempentru interogări grele punctuale. - Verifică
pending_restartdupă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
ERROR: invalid value for parameter "work_mem": "64MiB" Valoarea dată unui parametru nu are formatul acceptat. Pentru memorie, unitățile sunt sensibile la majuscule: kB, MB, GB, TB (64MB, nu 64mb). Pentru timp: us, ms, s, min, h, d. Valorile enumerate trebuie să fie din lista permisă. HINT-ul din mesaj arată unitățile valide. ERROR: unrecognized configuration parameter "work_memory" Numele parametrului din SET, SHOW sau current_setting nu există: e scris greșit (work_memory în loc de work_mem) sau parametrul aparține unei extensii neîncărcate. Verifică numele în pg_settings. Pentru setări proprii ale aplicației, folosește un nume cu punct (app.tenant_id). ERROR: VACUUM cannot run inside a transaction block VACUUM (și CREATE DATABASE, DROP DATABASE, ALTER SYSTEM) nu poate rula într-o tranzacție deschisă cu BEGIN și nici într-o funcție. Rulează comanda separat, în modul autocommit, sau dintr-un job de mentenanță extern. Î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.
