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).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
PostgreSQL are câteva sute de parametri de configurare, listați în vizualizarea pg_settings. Un nume necunoscut dă această eroare la SET, SHOW, RESET, ALTER SYSTEM sau current_setting(). Greșeli frecvente: work_memory în loc de work_mem, max_connection în loc de max_connections, statement_time_out în loc de statement_timeout.
Parametrii care conțin un punct (app.tenant_id, myapp.user) sunt „personalizați”: pot fi setați liber și sunt folosiți de aplicații pentru a transmite context (de exemplu în politicile RLS). Citirea unuia care nu a fost setat dă tot această eroare, iar current_setting('app.tenant_id', true) întoarce NULL în loc de eroare. Parametrii extensiilor (de exemplu pg_stat_statements.max) sunt recunoscuți doar după ce extensia e încărcată.
De ce apare: cauzele frecvente
1Nume greșit
SET work_memory = '64MB';SET work_mem = '64MB';Numele corect al parametrului este work_mem.
2Setare personalizată necitită
SELECT current_setting('app.tenant_id');SELECT current_setting('app.tenant_id', true); -- NULL dacă lipseșteAl doilea argument evită eroarea.
Repară eroarea, direct în pagină
Raportul greu mărește memoria pentru sortări în sesiunea curentă, dar scrie SET work_memory = '64MB' și primește unrecognized configuration parameter "work_memory". Corectează numele parametrului și afișează valoarea lui cu SHOW.
SET work_memory = '64MB';
SHOW work_memory;SET work_mem ---------- 64MB (1 rând)
Indiciu
Parametrul se numește work_mem.
Reparația
SET work_mem = '64MB';
SHOW work_mem;De ce merge
work_memory nu este un parametru PostgreSQL. Numele corect este work_mem, memoria folosită de fiecare operație de sortare sau hash înainte de a scrie pe disc. SET o schimbă doar pentru sesiunea curentă, iar SHOW work_mem confirmă valoarea 64MB. Lista completă a parametrilor se află în pg_settings.
Cum o eviți pe viitor
- Caută numele exact în
pg_settings(WHERE name LIKE '%mem%'). - Prefixează setările proprii cu numele aplicației (
app.). - Folosește
current_setting(nume, true)pentru setări opționale. - Verifică fișierele de configurare cu
SELECT * FROM pg_file_settings WHERE error IS NOT NULL.
Întrebări frecvente
Ce afișează pg_settings?
Numele, valoarea curentă, unitatea, sursa (fișier, implicit, sesiune) și contextul (când poate fi schimbat) pentru fiecare parametru.
Unde se setează parametrii permanent?
În postgresql.conf, cu ALTER SYSTEM (în postgresql.auto.conf) sau pe rol/bază cu ALTER ROLE ... SET și ALTER DATABASE ... SET.
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: 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. ERROR: column "nume_client" does not exist PostgreSQL nu găsește coloana cu numele din mesaj în tabelele din FROM. Cauze tipice: nume scris greșit, un text pus între ghilimele duble în loc de apostrofuri, un alias din SELECT folosit în WHERE sau o coloană creată cu majuscule între ghilimele. Î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.
