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

ERROR: unrecognized configuration parameter "work_memory"

Pe scurt

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

Greșit
SQL
SET work_memory = '64MB';
Corect
SQL
SET work_mem = '64MB';

Numele corect al parametrului este work_mem.

2Setare personalizată necitită

Greșit
SQL
SELECT current_setting('app.tenant_id');
Corect
SQL
SELECT current_setting('app.tenant_id', true);  -- NULL dacă lipsește

Al doilea argument evită eroarea.

Repară tu

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.

Codul care dă eroarea
SQL
SET work_memory = '64MB';
SHOW work_memory;
După reparație, programul afișează
SET
 work_mem
----------
 64MB
(1 rând)
Indiciu

Parametrul se numește work_mem.

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

← 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.