İSİM

       CREATE AGGREGATE - yeni bir ortak değer işlevi tanımlar

KULLANIM

       CREATE AGGREGATE isim (
           BASETYPE = girdi_veri_türü,
           SFUNC = durum_işlevi,
           STYPE = durum_veri_türü
           [ , FINALFUNC = son_işlev ]
           [ , INITCOND = ilk_değer ]
       )

AÇIKLAMA

       CREATE AGGREGATE yeni bir ortak değer işlevi tanımlar. Temel ve çok kullanılan ortak değer
       işlevleri dağıtıma dahil edilmiş ve bunlar
       http://www.postgresql.org/docs/8.0/static/functions-aggregate.html               adresinde
       açıklanmıştır.  Eğer  yeni  türlerin tanımlanması ya da dağıtımla gelmeyen bir ortak değer
       işlevine ihtiyaç olursa istenen özellikleri sağlamak için CREATE AGGREGATE kullanılabilir.

       Bir şema ismi verilmişse (CREATE AGGREGATE myschema.myagg ... gibi),  ortak  değer  işlevi
       belirtilen şema içinde oluşturulur.

       Bir  ortak  değer  işlevi,  ismi  ve  girdi veri türü ile tanımlanır. Eğer iki ortak değer
       işlevi  farklı  veri  türleri  ile  çalışıyorlarsa,   aynı   şema   içinde   aynı   isimle
       tanımlanabilir.  Ayrıca,  bir  ortak  değer  işlevi  gerek  ismi  gerekse  girdi veri türü
       bakımından aynı şema içindeki sıradan işlevlerden de farklı olmalıdır.

       Bir ortak değer işlevi bir ya da iki sıradan işlevden oluşur: durum_işlevi ile  belirtilen
       bir  durum  geçiş işlevi ve son_işlev ile isteğe bağlı olarak belirtilebilen bir son hesap
       işlevi. Bunlar şöyle kullanılır:

       durum_işlevi( dahili_durum, sonraki-veri-öğesi )
             ---> sonraki-dahili-durum
       son_işlev( dahili_durum )
             ---> ortak-değer

       PostgreSQL ortak değerin  o  anki  dahili  durumunu  saklamak  üzere  durum_veri_türü  ile
       belirtilen veri türünde bir geçici değişken oluşturur. Her girdi öğesinde, yeni bir dahili
       durum değerini hesaplamak üzere durum geçiş işlevi çağrılır. Tüm veri  işlendikten  sonra,
       döndürülecek  ortak  değeri  hesaplamak için son işlev çağrılır. Eğer bir son işlev yoksa,
       son durum değeri olduğu gibi döndürülür.

       Bir ortak değer işlevine dahili durum değeri için bir  ilk  değer  olarak,  bir  ilk_değer
       sağlanabilir. Bu veritabanında text türünde bir sütun olarak belirtilir ve saklanır, fakat
       bu, durum değerinin veri türündeki bir sabitin geçerli  bir  harici  gösterimi  olmalıdır.
       Eğer verilmezse, durum değeri NULL olarak ayrılır.

       Eğer  durum  geçiş  işlevi  argümanlarına  bağımlı  olarak  bildirilmişse, NULL girdilerle
       çağrılamaz.  Böyle  bir  geçiş   işleviyle   cümle   çalıştırıldığında   davranışı   şöyle
       açıklayabiliriz.  NULL  girdi  değerleri  yoksayılır (işlev çağrılmamıştır ve önceki durum
       değeri beklemektedir). Eğer ilk durum değeri NULL ise, ilk NULL olmayan girdi değeri durum
       değeri  yapılır ve geçiş işlevi ikinci NULL olmayan girdi değeriyle çağrılır. Bu, max gibi
       ortak değer işlevlerini gerçeklerken kullanışlıdır. Bu davranış sadece durum_veri_türü ile
       girdi_veri_türü aynı ise kullanılabilir. Bu veri türleri farklı olduğunda, ya NULL olmayan
       bir ilk_değer ya da argümanlarına bağımlı olmayan bir geçiş işlevi sağlamalısınız.

       Eğer durum geçiş işlevi argümanlarına bağımlı değilse, koşulsuz olarak her girdi değeriyle
       çağrılabilecek,  NULL girdi değerleriyle ve kendinin NULL geçiş değerleriyle çalışacaktır.
       Bu, işlev yazarının,  ortak  değerin  boş  değerlerle  elde  edilebilmesi  bakımından  tam
       denetime sahip olmasıyla mümkün olur.

       Eğer son işlev argümanlarına bağımlı olarak bildirilmişse, son durum değeri NULL olduğunda
       çağrılmayacak; bunun yerine kendiliğinden bir NULL sonuç  döndürülecektir.  (Şüphesiz  bu,
       argümanlarına  bağımlı  olarak  işlem yapabilen işlevler için normal bir davranıştır.) Her
       durumda, bir son işlev bir NULL değer döndürecek bir seçeneğe sahip olabilir. Örneğin, avg
       işlevinin son işlevi sıfır girdi satırı varsa, NULL döndürür.

PARAMETRELER

       isim   Oluşturulacak ortak değer işlevinin ismi (şema nitelemeli olabilir).

       girdi_veri_türü
              Bu  ortak  değer  işlevinin  üzerinde  işlem  yapacağı  girdinin  veri  türü. Girdi
              değerlerinin türüyle ilgilenmeyen bir ortak  değer  işlevi  için  (count(*)  gibi),
              "ANY" olarak belirtilebilir.

       durum_işlevi
              Her  girdi  değeri  için  çağrılacak  durum  geçiş işlevinin ismi.  Bu normalde iki
              argümanlı  bir  işlevdir;  ilk  argümanı  durum_veri_türü  türünde,  ikincisi   ise
              girdi_veri_türü  türündedir.  Eğer  bir  ortak  değer  işlevi  girdi  veri türü ile
              ilgilenmiyorsa işlev durum_veri_türü türünde tek bir argüman alabilir. Her  durumda
              işlev  durum_veri_türü  türünde  bir  değer  döndürmelidir.  Bu  işlev o anki durum
              değerini ve o anki girdi veri öğesini alıp, sonraki durum değeri ile döner.

       durum_veri_türü
              Durum geçiş işlevinin durum değerinin veri türü.

       son_işlev
              Tüm girdi değerleri işleme sokulup, ortak değer hesaplanacağı  zaman  çağrılan  son
              işlevin  ismi. İşlev durum_veri_türü türünde tek bir argüman almalıdır. Ortak değer
              işlevinin dönüş türü bu işlevin  dönüş  türü  olarak  tanımlanır.  Eğer   son_işlev
              belirtilmemişse,  son  durum değeri işlevin dönüş değeri olarak kullanılır ve dönüş
              türü durum_veri_türü olur.

       ilk_değer
              Durum değeri için ilk değer. durum_veri_türü türünde kabul edilebilecek  bir  dizge
              sabit olmalıdır. Belirtilmezse, durum değeri NULL olarak ayrılır.

       CREATE  AGGREGATE  deyiminin  parametrelerini  tam  da  yukarıdaki  sırasıyla  yazmak şart
       değildir, istenen sırada yazılabilir.

ÖRNEKLER

       http://www.postgresql.org/docs/8.0/static/xaggr.html adresine bakınız.

UYUMLULUK

       CREATE AGGREGATE bir PostgreSQL oluşumudur. SQL standardı kullanıcı  tanımlı  ortak  değer
       işlevlerini desteklememektedir.

İLGİLİ BELGELER

       ALTER AGGREGATE [alter_aggregate(7)],
       DROP AGGREGATE [drop_aggregate(7)].

ÇEVİREN

       Nilgün Belma Bugüner <nilgun (at) belgeler·gen·tr>, Nisan 2005