PGSQL Toate comenzile și funcțiile PostgreSQL

`CREATE FUNCTION (LANGUAGE plpgsql)` în PostgreSQL

Funcții, proceduri și triggere PostgreSQL 8.0+

Creează o funcție în PL/pgSQL, limbajul procedural al PostgreSQL: variabile, IF, bucle, tratarea erorilor.

Sintaxă SQL

CREATE [OR REPLACE] FUNCTION nume(param tip, ...) RETURNS tip
LANGUAGE plpgsql
AS $$
DECLARE
    variabila tip [:= valoare];
BEGIN
    ... instrucțiuni ...
    RETURN valoare;
END
$$;

Ce face `CREATE FUNCTION (LANGUAGE plpgsql)`

PL/pgSQL adaugă peste SQL ce lipsește pentru logică mai complexă: variabile (DECLARE), condiții (IF ... ELSIF ... ELSE, CASE), bucle (LOOP, WHILE, FOR ... IN SELECT), mesaje (RAISE) și tratarea erorilor (EXCEPTION).

Rezultatul unei interogări se pune într-o variabilă cu SELECT ... INTO variabila. Funcțiile care returnează mai multe rânduri folosesc RETURNS TABLE sau RETURNS SETOF și RETURN QUERY.

Toată funcția rulează în tranzacția celui care o apelează. Dacă vrei COMMIT în mijlocul codului, ai nevoie de o procedură (CREATE PROCEDURE).

Parametri

Parametru	Descriere
`DECLARE`	Secțiunea cu variabile: `total numeric := 0;`.
`SELECT ... INTO var`	Pune rezultatul interogării în variabilă.
`IF / ELSIF / ELSE`	Condiții.
`FOR r IN SELECT ... LOOP`	Parcurge rândurile unei interogări.
`RETURN / RETURN QUERY`	Returnează valoarea, respectiv rândurile unei interogări.

Ce returnează

Mesajul CREATE FUNCTION.

Exemple

Exemplul 1: Categoria unui client după total

CREATE FUNCTION categorie_client(p_client_id integer)
    RETURNS text
    LANGUAGE plpgsql
AS $$
DECLARE
    total_cumparat numeric;
BEGIN
    SELECT coalesce(sum(total), 0) INTO total_cumparat
    FROM comenzi WHERE client_id = p_client_id;

    IF total_cumparat >= 5000 THEN
        RETURN 'aur';
    ELSIF total_cumparat >= 1000 THEN
        RETURN 'argint';
    ELSE
        RETURN 'standard';
    END IF;
END
$$;

SELECT nume, categorie_client(id) FROM clienti ORDER BY id;

Rezultat în psql

CREATE FUNCTION
 nume  | categorie_client 
-------+------------------
 Ana   | aur
 Mihai | standard
 Ioana | argint
(3 rows)

Exemplul 2: Buclă peste rânduri și RETURN QUERY

CREATE FUNCTION produse_de_comandat(p_prag integer)
    RETURNS TABLE (cod text, lipsa integer)
    LANGUAGE plpgsql
AS $$
BEGIN
    RETURN QUERY
        SELECT p.cod, p_prag - p.stoc
        FROM produse p
        WHERE p.stoc < p_prag
        ORDER BY p.stoc;
END
$$;

SELECT * FROM produse_de_comandat(10);