ERROR: function name "calc_tva" is not unique
Există mai multe funcții cu același nume și parametri diferiți (supraîncărcare), iar comanda (DROP FUNCTION, ALTER FUNCTION, GRANT) nu spune pe care o vrei. Specifică lista de tipuri ale parametrilor: DROP FUNCTION calc_tva(numeric).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
PostgreSQL permite funcții cu același nume, dacă tipurile parametrilor diferă: calc_tva(numeric) și calc_tva(numeric, numeric) sunt două obiecte distincte. Comenzile care se referă la o funcție doar prin nume (DROP FUNCTION calc_tva, ALTER FUNCTION calc_tva ..., COMMENT ON FUNCTION) funcționează doar dacă numele e unic; altfel dau această eroare, cu HINT: Specify the argument list to select the function unambiguously.
Supraîncărcările apar des fără intenție: CREATE OR REPLACE FUNCTION cu alt tip de parametru (de exemplu int în loc de numeric) nu înlocuiește funcția veche, ci creează una nouă. Rezultatul: două versiuni, iar apelurile pot ajunge la cea greșită sau pot deveni ambigue (function calc_tva(unknown) is not unique). Listează versiunile cu \df calc_tva și șterge-le explicit pe cele vechi.
De ce apare: cauzele frecvente
1DROP fără parametri
DROP FUNCTION calc_tva;DROP FUNCTION calc_tva(numeric);Lista de tipuri identifică exact funcția.
2Versiune nouă creată din greșeală
CREATE OR REPLACE FUNCTION calc_tva(p integer) ...; -- exista calc_tva(numeric)DROP FUNCTION calc_tva(numeric);
CREATE FUNCTION calc_tva(p integer) ...;Funcția veche e ștearsă explicit, ca să nu rămână două versiuni.
Repară eroarea, direct în pagină
Funcția calc_tva există în două versiuni, cu un parametru și cu doi, iar migrarea care vrea să o șteargă pe cea veche, cu un singur parametru numeric, dă function name "calc_tva" is not unique. Șterge doar versiunea veche și afișează câte funcții calc_tva au rămas.
DROP FUNCTION calc_tva;
SELECT count(*) FROM pg_proc WHERE proname = 'calc_tva';DROP FUNCTION
count
-------
1
(1 rând)Indiciu
DROP FUNCTION calc_tva(numeric);
Reparația
DROP FUNCTION calc_tva(numeric);
SELECT count(*) FROM pg_proc WHERE proname = 'calc_tva';De ce merge
Numele singur nu identifică o funcție când există mai multe versiuni. DROP FUNCTION calc_tva(numeric) precizează lista de tipuri și șterge doar versiunea cu un parametru. Versiunea cu doi parametri rămâne, deci numărătoarea din pg_proc dă 1. Fără lista de tipuri, PostgreSQL nu poate ști pe care dintre cele două versiuni vrei să o ștergi.
Alte forme ale mesajului
ERROR: function calc_tva(unknown) is not unique
Cum o eviți pe viitor
- Scrie lista de tipuri în orice
DROP,ALTERsauGRANTpe funcții. - Verifică cu
\df numedupă migrări că nu au rămas versiuni vechi. - Evită supraîncărcările care diferă doar prin tipuri numerice apropiate.
- Folosește parametri cu valori implicite (
DEFAULT) în loc de mai multe versiuni ale aceleiași funcții.
Întrebări frecvente
De ce OR REPLACE a creat o funcție nouă?
Pentru că semnătura include tipurile parametrilor; cu alte tipuri, e altă funcție.
Ce înseamnă function f(unknown) is not unique?
Apelul cu un literal fără tip se potrivește la fel de bine cu mai multe versiuni. Conversia explicită (f(5::numeric)) rezolvă ambiguitatea.
Erori înrudite
ERROR: cannot change return type of existing function CREATE OR REPLACE FUNCTION nu poate schimba tipul întors de o funcție existentă (de exemplu din integer în numeric sau din RETURNS TABLE cu alte coloane). Șterge funcția cu DROP FUNCTION (cu tipurile parametrilor) și creeaz-o din nou. ERROR: arhiveaza() is a procedure Ai apelat o procedură cu SELECT, ca pe o funcție. Procedurile se apelează cu CALL arhiveaza(); invers, o funcție apelată cu CALL dă eroarea "is not a procedure". Folosește comanda potrivită pentru tipul obiectului. ERROR: operator is not unique: unknown - unknown Ai aplicat un operator pe două valori fără tip (literali între apostrofuri), iar PostgreSQL găsește mai multe variante posibile (date - date, timestamp - timestamp, interval - interval) și nu poate alege. Dă explicit tipul cel puțin unui operand: date '2025-03-14' - date '2025-01-01'. Î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.
