Menu

PostgreSQL CREATE FUNCTION ve Stored Procedure

CREATE FUNCTION, sorguların içinde çağırdığın, SQL ya da PL/pgSQL ile yazılmış bir fonksiyon tanımlar. CREATE PROCEDURE ise CALL ile çalıştırılan ve ilerledikçe transaction'ları commit edebilen bir rutin tanımlar.

Bu sayfada çalıştırılabilir editörler var. Düzenle, çalıştır ve sonucu anında gör.

CREATE FUNCTION name(arg type) RETURNS type LANGUAGE sql AS $$ ... $$;, sorguların yerleşik bir fonksiyon gibi çağırabileceği bir fonksiyon tanımlar. Gövde $$ işaretlerinin arasına, düz SQL ya da PostgreSQL'in prosedürel dili PL/pgSQL ile yazılır. CREATE PROCEDURE (PostgreSQL 11+) ise bunun yerine CALL ile çalıştırdığın bir rutin tanımlar.

with_tax(50) varsayılan oranı kullanır ve 60 döndürür; with_tax(50, 0.1) ise 55 döndürür. Argümanlar adla da geçilebilir: with_tax(50, rate => 0.1).

PL/pgSQL ile mantık yazmak

Fonksiyonun değişkenlere, IF'e, döngülere ya da hata yönetimine ihtiyacı olduğunda LANGUAGE plpgsql kullan. Değişkenler bir DECLARE bölümüne, kod da BEGIN ile END arasına yazılır:

4 kg'lık bir paket taban ücret olan 5 tutar; 20 kg'lık ekspres bir paket (5 + 10 * 0.5) * 2 = 20 tutar. PL/pgSQL içinde RAISE NOTICE 'value: %', cost; bir mesaj yazdırır, RAISE EXCEPTION ise bir hatayla işlemi durdurur.

Mantığı düz SQL ile ifade edebiliyorsan LANGUAGE sql tercih et: planlayıcı basit bir SQL fonksiyonunu çağıran sorgunun içine gömebilir.

Bir satır kümesi döndürmek

RETURNS TABLE (...) satır döndüren bir fonksiyon oluşturur. Onu FROM içinde bir tablo gibi çağır:

orders_of('ana') 1 ve 3 numaralı siparişleri döndürür. RETURNS SETOF orders ise listelenen sütunlar yerine orders tablosunun satırlarını bütün olarak döndürür.

PostgreSQL 14'ten beri bir SQL fonksiyonunun gövdesi metin yerine standart SQL olabilir. PostgreSQL onu ayrıştırılmış halde saklar ve kullandığı tabloları ve sütunları kaydeder, bu yüzden fonksiyon var olduğu sürece bunlar silinemez:

CREATE FUNCTION order_count(who text) RETURNS bigint
LANGUAGE sql STABLE
BEGIN ATOMIC
  SELECT count(*) FROM orders WHERE customer = who;
END;

Stored procedure oluşturmak ve CALL ile çalıştırmak

Prosedürün dönüş tipi yoktur; onu CALL ile çalıştırırsın. Veri değiştirebilir ve CALL açık bir transaction bloğu içinde değilse işin ortasında COMMIT yapabilir. Büyük bir işi parçalar halinde böyle işlersin.

1 numaralı hesap 70, 2 numaralı hesap 80 ile biter. 200'lük bir transfer 1 numaralı hesaptaki CHECK kısıtını bozardı ve hata iki güncellemeyi de geri alırdı.

FonksiyonProsedür
Nasıl çalıştırılırSELECT f(...), sorgunun herhangi bir yerindeyalnızca CALL p(...)
Ne döndürürbir değer, bir satır ya da satır kümesihiçbir şey (ya da OUT/INOUT parametreleri)
İçinde COMMIT / ROLLBACKhayırevet, PL/pgSQL'de, bir transaction bloğu içinde çağrılmadığında
Ne zamandan beriher zamanPostgreSQL 11

Volatility'yi işaretlemek: IMMUTABLE, STABLE, VOLATILE

Volatility etiketi, planlayıcıya bir fonksiyon hakkında neyi varsayabileceğini söyler. Varsayılan VOLATILE'dır.

  • IMMUTABLE: sonuç yalnızca argümanlara bağlıdır ve asla değişmez (with_tax). İndeks ifadesinde kullanılan fonksiyonlar için zorunludur.
  • STABLE: sonuç komutlar arasında değişebilir ama tek bir komutun içinde değişmez; örneğin tablo okuyan bir fonksiyon (orders_of).
  • VOLATILE: geri kalan her şey, örneğin random() kullanan ya da veri değiştiren fonksiyonlar. PostgreSQL onu her satır için yeniden çağırır.

Yanlış bir etiket yanlış sonuç verir: tablo okuyan IMMUTABLE bir fonksiyon bir indeksten ya da önbelleğe alınmış bir plandan eski değerler döndürebilir.

Fonksiyonu değiştirmek, aşırı yüklemek ve silmek

CREATE OR REPLACE FUNCTION var olan bir fonksiyonun gövdesini değiştirir ama dönüş tipini değiştiremez; bunun için önce fonksiyonu sil. PostgreSQL bir fonksiyonu adı ve argüman tipleriyle tanır, yani f(int) ve f(text) iki ayrı fonksiyondur. Aynı adlı iki fonksiyondan birini silmek için argüman tiplerini ver:

CREATE OR REPLACE FUNCTION with_tax(price numeric, rate numeric DEFAULT 0.2) ...;
DROP FUNCTION with_tax(numeric, numeric);
DROP PROCEDURE transfer;

PL/pgSQL bölümü döngüleri, cursor'ları, hataları (exception) ve EXECUTE ile dinamik SQL'i anlatır. Satırlar değiştiğinde bir fonksiyonu otomatik çalıştırmak için onu bir tetikleyiciye bağla.

Sıkça Sorulan Sorular

PostgreSQL'de fonksiyon ile prosedür arasındaki fark nedir?

Fonksiyon bir değer döndürür ve bir sorgunun içinde çağrılır (SELECT f(x)). PostgreSQL 11'de eklenen prosedür ise CALL ile tek başına çalıştırılır ve gövdesinde COMMIT ya da ROLLBACK yapabilir; fonksiyon ise her zaman çağıranın transaction'ı içinde çalışır.

PostgreSQL fonksiyonunda $$ ne anlama gelir?

$$ dolar tırnaklamadır (dollar quoting): bir metin sabitinin başını ve sonunu işaretler, böylece fonksiyon gövdesi tek tırnakları kaçış karakteri olmadan içerebilir. $body$ ... $body$ gibi bir etiket de ekleyebilirsin.

Bir PostgreSQL fonksiyonunun kodunu nasıl görürüm?

psql'de \df fonksiyonları listeler, \sf name da bir fonksiyonun tanımını yazdırır. SQL'de SELECT pg_get_functiondef('name'::regproc); tam CREATE OR REPLACE FUNCTION komutunu döndürür.

Bir PostgreSQL fonksiyonu birden fazla satır döndürebilir mi?

Evet. Onu RETURNS TABLE (col type, ...) ya da RETURNS SETOF type olarak tanımla ve FROM cümlesinde bir tablo gibi çağır: SELECT * FROM f(1);.

Coddy programlama dilleri çizimi

Coddy ile kodlamayı öğren

Başla