Provided by: manpages-tr_1.0.5.1-2_all 
İSİM
CREATE FUNCTION - yeni bir işlev tanımlar
KULLANIM
CREATE [OR REPLACE] FUNCTION isim ( [ [ arg_ismi ] arg_türü [, ...] ] )
RETURNS dönüş_türü
{ LANGUAGE dil_ismi
| IMMUTABLE | STABLE | VOLATILE
| CALLED ON NULL INPUT | RETURNS NULL ON NULL INPUT | STRICT
| [ EXTERNAL ] SECURITY INVOKER | [ EXTERNAL ] SECURITY DEFINER
| AS 'tanım'
| AS 'nesne_dosyası', 'ilintileme_sembolü'
} ...
[ WITH ( öznitelik [, ...] ) ]
AÇIKLAMA
CREATE FUNCTION yeni bir işlev tanımlar. CREATE OR REPLACE FUNCTION ise ya yeni bir işlev
oluşturur ya da bir mevcut işlev tanımını değiştirir.
Eğer bir şema ismi belirtilmişse, işlev belirtilen şemada oluşturulur. Aksi takdirde,
geçerli olan şemada oluşturulur. Yeni işlevin ismi, aynı şema içindeki aynı argüman
türlerine sahip bir işlev ismi ile aynı olmamalıdır. Farklı argüman türlerine sahip aynı
isimdeki işlevlere izin verilir.
Mevcut bir işlevin tanımını güncellemek için CREATE OR REPLACE FUNCTION kullanılır. Ancak,
bir işlevin ismini ya da argüman türlerini bu yöntemle değiştirmek mümkün değildir (eğer
denerseniz, aslında ayrı ve yeni bir işlev oluşturmuş olursunuz). Ayrıca, CREATE OR
REPLACE FUNCTION ile mevcut bir işlevin dönüş türünü değiştirmeye çalışmayın, bunu yapmak
için işlevi önce silmeli, sonra yeniden oluşturmalısınız.
Eğer bir işlevi silip yeniden oluşturursanız, yeni işlev eskisiyle aynı olmaz; mevcut
kuralları, sanal tabloları, tetikleri, vs. de silmiş olursunuz. Bunları koruyarak işlev
tanımını değiştirmek için CREATE OR REPLACE FUNCTION kullanın.
İşlevi tanımlayan kullanıcı aynı zamanda sahibi olur.
PARAMETRELER
isim Tanımlanacak işlevin ismi (şema nitelemeli olabilir).
arg_ismi
Bir argümanın ismi. Bazı diller (şimdilik sadece PL/pgSQL) argüman ismini işlev
gövdesinde kullanmanızı ister. Diğer diller için argüman ismi sadece ek bir
bilgidir.
arg_türü
İşlevin (varsa) argümanlarının veri türleri (şema nitelemeli olabilir). Argüman
türleri temel, birleşik veya veri alanı türü olabileceği gibi bir tablo sütununun
veri türüne başvurulu olabilir.
Gerçeklenim diline bağımlılık sebebiyle, cstring gibi tanımlı türler de
belirtilebilir. Argüman türü olarak tanımlı türler kısmen olabileceği gibi SQL veri
türlerinin tamamen dışında türler olabilirler.
Bir sütun türüne başvuruyu tablo_ismi.sütun_ismi%TYPE yazarak belirtebilirsiniz. Bu
özelliğin kullanımı bazan bir işlevin bir tablo tanımındaki değişikliklerden
bağımsız olmasını sağlayabilir.
dönüş_türü
İşlevin dönüş değerinin veri türü (şema nitelemeli olabilir). Dönüş türü temel,
birleşik veya veri alanı türü olabileceği gibi bir tablo sütununun veri türüne
başvurulu olabilir.
SETOF değiştiricisi işlevin tek bir öğe ile değil, bir öğe kümesi ile döneceğini
belirtir.
Bir sütun türüne başvuruyu tablo_ismi.sütun_ismi%TYPE yazarak belirtebilirsiniz.
dil_ismi
İşlevin gerçeklendiği dilin ismi. SQL, C, internal veya kullanıcı tarafından
belirtilecek yordamsal dillerden biri olabilir. Geriye uyumluluk için isim tek
tırnak içine alınabilir.
IMMUTABLE, STABLE, VOLATILE
Çalışma anı eniyilemesi için işlevin çoklu değerlendirmelerinin tek bir
değerlendirme ile değiştirilmesinin güvenli olup olmayacağını belirlerler. En fazla
bir seçim belirtilebilir. Bunlardan hiçbiri belirtilmemişse VOLATILE öntanımlıdır.
IMMUTABLE işlevin aynı argüman değerleriyle daima aynı sonucu döndüreceğini
belirtir; yani, argümanlarının veritabanındaki değerlerden faydalanmayacağını ya da
argüman olarak açıkça belirtilmemiş bilgileri kullanmayacağını belirtir. Eğer bu
seçenek belirtilmişse, işlevin tamamen sabit argümanlı her çağrısı anında işlev
değeriyle değiştirilebilir.
STABLE tek bir tablo taraması içinde işlevin aynı argüman değerleri için tutarlı
olarak aynı sonucu döndüreceğini, ama sonucun SQL cümleleriyle değişebileceğini
belirtir. Bu, sonuçları veritabanı aramalarına, parametrelerine, v.s. bağımlı
işlevler için un uygun seçimdir. Ayrıca, değerleri bir hareket içinde
değişmediğinden current_timestamp ailesindeki işlevler de STABLE olarak
nitelenmiştir.
VOLATILE işlevin değerinin tek bir tablo taraması içinde bile değişebileceğini,
dolayısıyla hiçbir eniyileme yapılamayacağını belirtir. Görece birkaç veritabanı
işlevi bu anlamda oynaktır; bazı örnekler: random(), currval(), timeofday(). Yan
etkiye sahip her işlevin, işlev sonucu tahmin edilebilir olsa bile, eniyilenmesini
önlemek için VOLATILE olarak sınıflanması gerektiğini unutmayın; setval() buna bir
örnektir.
Ek ayrıntılar için
http://www.postgresql.org/docs/8.0/static/xfunc-volatility.html adresine bakınız.
CALLED ON NULL INPUT, RETURNS NULL ON NULL INPUT, STRICT
CALLED ON NULL INPUT (öntanımlıdır) işlevin bazı argümanları NULL olduğunda normal
olarak çağrılacağını belirtir. Bundan sonra işlev yazarının yapacağı NULL değerleri
sınamak ve gereğini yapmaktır.
RETURNS NULL ON NULL INPUT veya STRICT ise işlevin, argümanlarından herhangi
birinin NULL olması durumunda daima NULL değer döndüreceğini belirtir. Eğer bu
seçenek belirtilmişse, NULL argümanların varlığında işlev çalıştırılmayacak, onun
yerine hemen bir NULL değer döndürülecektir.
SECURITY INVOKER işlevin kendisini çağıran kullanıcının izinleriyle çalıştırılacağını belirtir. SECURITY DEFINER ise işlevin kendisini oluşturan kullanıcının izinleriyle çalıştırılacağını belirtir.
EXTERNAL sözcüğü SQL uyumluluğu için varsa da isteğe bağlı olmasından dolayı, SQL'in tersine bu özellik harici işlevlere uygulanmaz.
tanım İşlevi tanımlayan bir dizge sabiti; anlamlandırılması dile bağımlıdır. Bir dahili işlev ismi olabileceği gibi bir nesne dosyasının yolu, bir SQL komutu veya bir yordamsal dilde yazılmış bir metin olabilir.
nesne_dosyası, ilintileme_sembolü
AS sözcüğünün bu biçimi özdevimli yüklenebilen C dili işlevleri için, işlevin C dili kaynak kodundaki ismi, bir SQL işlevinin ismiyle aynı değilse, kullanılır. nesne_dosyası dizgesi ile özdevimli yüklenebilen nesneyi içeren dosyanın ismi belirtilir. ilintileme_sembolü ise işlevin C dili kaynak kodundaki ismi olarak işlevin ilintileme sembolüdür. Eğer ilintileme sembolü belirtilmezse, tanımlandığı SQL işlevinin ismiyle aynı olduğu kabul edilir.
öznitelik
İşlev hakkında bilgi içeren isteğe bağlı parçaları belirtmenin tarihi bir yolu. Burada belirtilebilecek öznitelikler şunlardır:
isStrict
STRICT veya RETURNS NULL ON NULL INPUT'a eşdeğerdir.
isCachable
IMMUTABLE'ın atıl olmuş eşdeğeridir; hala geriye uyumluluk adına kabul edilmektedir.
Öznitelik isimleri harf büyüklüğüne duyarlıdır.
EK BİLGİ
İşlevlerin yazılması hakkında bilgi edinmek için
http://www.postgresql.org/docs/8.0/static/xfunc.html adresine bakınız.
Girdi argümanları ve dönüş değeri için tamamen SQL türü sözdizimine izin verilmektedir.
Ancak, temel işlev gerçekleniminin sorumlusu olduğu tür belirtiminin bazı ayrıntıları
(sayısal türlerdeki hassasiyet alanı gibi) CREATE FUNCTION tarafından sessizce sineye
çekilir (yani, ne tanınır ne de uygulanır).
PostgreSQL, argümanları farklı olmak şartıyla işlevler için aynı isimlerin kullanımına
izin verir. Ancak, C dilinde tüm işlev isimlerinin farklı olması gerekir, bu nedenle bu
tür C işlevlerine farklı C isimleri vermelisiniz. (örneğin, C isimlerinin parçası olarak
argüman türleri kullanılabilir).
CREATE FUNCTION aynı nesne dosyası için defalarca çağrıldığında dosya sadece bir kere
yüklenir. Dosyayı tekrar tekrar yüklemeniz gerekiyorsa (geliştirme amaçlı) LOAD [load(7)]
komutunu kullanın.
Kullanıcı tanımlı işlevleri kaldırmak için DROP FUNCTION [drop_function(7)] kullanılır.
İşlev tanımlarını yazarken tek tırnak içine almak yerine dolar işaretleri arasında yazmak
çoğunlukla daha çok tercih edilen bir yöntemdir
(http://www.postgresql.org/docs/8.0/static/sql-syntax.html#SQL-SYNTAX-DOLLAR-QUOTING
adresine bakınız). Dolar işaretleri arasında yazma yöntemi kullanılmadığı zaman, işlev
tanımı içindeki tek tırnaklar veya tersbölülerin öncelenmesi gerekir.
Bir işlevin tanımlanabilmesi için kullanıcının dil üzerinde USAGE iznine sahip olması
gerekir.
ÖRNEKLER
Burada, başlangıç olarak yardımcı olacak önemsiz bir örneğe yer verilmiştir. Daha fazla
bilgi edinmek ve başka örnekler için
http://www.postgresql.org/docs/8.0/static/xfunc.html adresine bakınız.
CREATE FUNCTION add(integer, integer) RETURNS integer
AS 'select $1 + $2;'
LANGUAGE SQL
IMMUTABLE
RETURNS NULL ON NULL INPUT;
PL/pgSQL dilinde bir argüman ismi kullanarak bir tamsayı arttırımı:
CREATE OR REPLACE FUNCTION increment(i integer) RETURNS integer AS $$
BEGIN
RETURN i + 1;
END;
$$ LANGUAGE plpgsql;
UYUMLULUK
SQL:1999 ve sonrasında bir CREATE FUNCTION tanımlıdır. PostgreSQL sürümü de benzer olmakla
birlikte tamamen uyumlu değildir. Ne öznitelikler taşınabilirdir ne de farklı diller
kullanılabilmektedir.
İLGİLİ BELGELER
ALTER FUNCTION [alter_function(7)], DROP FUNCTION [drop_function(7)], GRANT [grant(7)],
LOAD [load(7)], REVOKE [revoke(7)], createlang(1).
ÇEVİREN
Nilgün Belma Bugüner <nilgun (at) belgeler·gen·tr>, Nisan 2005