...
Eroare PostgreSQL · Funcții, proceduri și triggere PL/pgSQL

ERROR: too few arguments for format()

Pe scurt

Șablonul din format() conține mai mulți specificatori (%s, %I, %L) decât valori date după el, sau ai folosit un specificator inexistent (%d). format() acceptă doar %s (text), %I (identificator), %L (literal) și %% (procent). Potrivește numărul de valori și folosește %s pentru numere.

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

Ce înseamnă

format(sablon, val1, val2, ...) înlocuiește specificatorii din șablon cu valorile date: %s inserează valoarea ca text, %I o citează ca identificator (nume de tabel sau coloană, cu ghilimele duble dacă e nevoie), %L o citează ca literal SQL (cu apostrofuri, sau NULL). Prea puțini parametri dau această eroare; un specificator necunoscut dă unrecognized format() type specifier "d", frecvent la cei obișnuiți cu printf.

format este instrumentul recomandat pentru SQL dinamic în PL/pgSQL (EXECUTE format('SELECT count(*) FROM %I WHERE data >= %L', tabel, data)), pentru că %I și %L previn injecțiile SQL. Pentru valori, varianta și mai sigură este EXECUTE ... USING, cu parametri $1, $2. Specificatorii pot fi și poziționali (%1$s, %2$I), utili când aceeași valoare apare de mai multe ori.

De ce apare: cauzele frecvente

1Specificator de tip printf

Greșit
SQL
SELECT format('Comanda %d are totalul %s', id, total) FROM comenzi;
Corect
SQL
SELECT format('Comanda %s are totalul %s', id, total) FROM comenzi;

%s convertește automat numerele în text.

2Valoare lipsă

Greșit
SQL
EXECUTE format('DELETE FROM %I WHERE data < %L', tabel);
Corect
SQL
EXECUTE format('DELETE FROM %I WHERE data < %L', tabel, limita);

Fiecare specificator primește valoarea lui.

3Aceeași valoare de două ori

Greșit
SQL
format('%I.%I și %I', schema, tabel)  -- a treia valoare lipsește
Corect
SQL
format('%1$I.%2$I și %2$I', schema, tabel)

Specificatorii poziționali refolosesc valorile.

Repară tu

Repară eroarea, direct în pagină

Funcția numara_din numără rândurile dintr-un tabel dat ca parametru, folosind SQL dinamic, dar format() are doi specificatori și o singură valoare și dă too few arguments for format(). Construiește comanda doar cu numele tabelului (%I) și afișează rezultatul pentru tabelul comenzi.

Codul care dă eroarea
SQL
CREATE FUNCTION numara_din(p_tabel text) RETURNS bigint LANGUAGE plpgsql AS $$
DECLARE
  v bigint;
BEGIN
  EXECUTE format('SELECT count(*) FROM %I.%I', p_tabel) INTO v;
  RETURN v;
END $$;
SELECT numara_din('comenzi');
După reparație, programul afișează
CREATE FUNCTION
 numara_din
------------
          3
(1 rând)
Indiciu

format('SELECT count(*) FROM %I', p_tabel)

Alte forme ale mesajului

  • ERROR: unrecognized format() type specifier "d"

Cum o eviți pe viitor

  • Folosește doar %s, %I, %L și %% în format().
  • Folosește %I pentru nume de obiecte și %L sau USING pentru valori în SQL dinamic.
  • Numără specificatorii și valorile, sau folosește specificatori poziționali.
  • Testează SQL-ul dinamic afișându-l întâi cu RAISE NOTICE '%', comanda;.

Întrebări frecvente

Ce diferență e între %s și %L?

%s inserează textul așa cum e; %L îl citează ca literal SQL ('Ana', iar NULL devine NULL), deci e sigur în comenzi dinamice.

Ce face %I cu un nume cu majuscule?

Îl pune între ghilimele duble: format('%I', 'Comenzi') dă "Comenzi".

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.