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

ERROR: function name "calc_tva" is not unique

Pe scurt

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

Greșit
SQL
DROP FUNCTION calc_tva;
Corect
SQL
DROP FUNCTION calc_tva(numeric);

Lista de tipuri identifică exact funcția.

2Versiune nouă creată din greșeală

Greșit
SQL
CREATE OR REPLACE FUNCTION calc_tva(p integer) ...;  -- exista calc_tva(numeric)
Corect
SQL
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ă tu

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.

Codul care dă eroarea
SQL
DROP FUNCTION calc_tva;
SELECT count(*) FROM pg_proc WHERE proname = 'calc_tva';
După reparație, programul afișează
DROP FUNCTION
 count
-------
     1
(1 rând)
Indiciu

DROP FUNCTION calc_tva(numeric);

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, ALTER sau GRANT pe funcții.
  • Verifică cu \df nume după 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

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