Provided by: manpages-tr_1.0.5.1-2_all bug

ISIM

       CREATE LANGUAGE - yeni bir yordamsal dil tanimlar

KULLANIM

       CREATE [ TRUSTED ] [ PROCEDURAL ] LANGUAGE isim
           HANDLER eylemci [ VALIDATOR dogrulama_i,slevi ]

A,CIKLAMA

       CREATE  LANGUAGE  kullanarak,  bir PostgreSQL kulanicisi bir PostgreSQL
       veritabani icin yeni bir yordamsal dil kaydi yapabilir. Bundan sonra bu
       yeni  dilde  islevler  ve tetik yordamlari tanimlanabilir. Yeni bir dil
       kaydi yapabilmek icin  kullanici,  PostgreSQL  ayricalikli  kullanicisi
       yetkilerine sahip olmalidir.

       CREATE    LANGUAGE    aslinda,    bir    dilde    yazilmis   islevlerin
       calistirilmasindan sorumlu bir eylemci ile bu dili iliskilendirir.  Dil
       eylemcileri hakkinda ayrintili bilgi edinmek icin
       http://www.postgresql.org/uygulamalar/pgsql/xplang.html        adresine
       bakiniz.

       Yordamsal dil kaydi her veritabanina ayri ayri yapilmalidir. Bir  dilin
       butun   veritabanlarinda   ontanimli  olmasi  icin,  bu  dil  template1
       veritabaninda kayitli olmalidir.

PARAMETRELER

       TRUSTED
              Eylemcinin dil icin govenli oldugunu belirtir. Bu, bir  yetkisiz
              kullanici    erisim    kisitlamalarini   asacak   herhangi   bir
              islevselligi  kullanmayacak  demektir.   Belirtilmezse,   sadece
              PostgreSQL    ayricalikli   kullanicisinin   yetkilerine   sahip
              kullanicilar  bu   dili   yeni   bir   islev   tanimlamak   icin
              kullanabilecektir.

       PROCEDURAL
              Gereksizdir (etkisi yoktur).

       isim   Yeni yordamsal dilin ismi. Dil ismi harf buyuklugune duyarlidir.
              Isim veritabanindaki dil isimleri arasinda essiz olmalidir.

              Geriye uyumluluk icin isim tek tirnak icine alinabilir.

       HANDLER eylemci
              eylemci yordamsal dilin islevlerini calistirmak icin cagrilacak,
              evvelce  kaydedilmis  bir  islevin  ismidir. Bir yordamsal dilin
              eylemci islevi C gibi bir derlenen dilin 1. surum cagri uzlasimi
              ile   yazilmis   olmali   ve   arguman  almayan  ve  donus  turu
              language_handler olan bir islev  olarak  kaydedilmis  olmalidir.
              language_handler  donus  turu,  islevi  bir eylemci islev olarak
              tanimlamakta kullanilan bir yer tutucu turdur.

       VALIDATOR dogrulama_i,slevi
              dogrulama_i,slevi yeni dilde yeni bir islev olusturuldugunda yeni
              islevi  dogrulamak  icin  cagrilacak  evvelce  kaydedilimis  bir
              islevin ismidir. Boyle bir islev belirtilmezse, yeni  bir  islev
              olusturuldugunda   sinanmayacaktir.   Dogrulama   islevi,   yeni
              olusturulacak islevin nesne kimligi icin oid turunde bir arguman
              almalidir. Islev genellikle void dondurecek sekilde tasarlanir.

              Bir  dogrulama  islevi  genellikle  islev  govdesini sozdizimsel
              dogruluk bakimindan inceler, ama islevin diger ozelliklerine  de
              (dilin  desteklemedigi  bir  arguman turu kullanilmis mi, acaba;
              gibi) bakar.  Bir  hatayi  sinyallemek  icin,  dogrulama  islevi
              ereport()  islevini  kullanmalidir.  Islevin  donus  degeri  yok
              sayilir.

EK BILGI

       Bu  komut  normalde  dogrudan  kullanicilar  tarafindan  calistirilmaz.
       Yordamsal diler icin PostgreSQL dagitiminda bulunan createlang(1) araci
       kullanilmalidir.  Bu  arac  ayrica,  dogru  eylemciyi  de   kuracaktir.
       (createlang yerine CREATE LANGUAGE'de kullanilabilir.)

       PostgreSQL'in  7.3  surumunden  once, eylemci islevin  language_handler
       turunde degil, opaque turde yer tutucu dondurmesi gerekirdi. Eski dokum
       dosyalarini   desteklemek  icin  CREATE  LANGUAGE  opaque  turde  deger
       donduren  bir  islevi  kabul  edecektir,  ama   islevin,   donus   turu
       language_handler  olacak  sekilde  bildirilmesinin gerektigini bildiren
       bir uyari gosterecektir.

       Yeni bir islev olusturmak  icin  CREATE  FUNCTION  [create_function(7)]
       kullanilir.

       Bir   yordamsal   dili  veritabanindan  kaldirmak  icin  DROP  LANGUAGE
       [drop_language(7)] ya da daha iyisi droplang(1) aracini kullanin.

       Sistem katalogu pg_language (bkz.
       http://www.postgresql.org/uygulamalar/pgsql/catalog-pg-language.html),
       o   an  kurulu  olan  diller  hakkindaki  bilgileri  kaydeder.  Ayrica,
       createlang kurulu dilleri listelemek icin bir secenege sahiptir.

       Bir kullanicinin bir yordamsal dili kullanabilmesi icin, USAGE  yetkisi
       olmasi  gerekir.  Eger  dilin  guvenilir oldugu biliniyorsa, createlang
       herkese bu izni ozdevinimli olarak verir.

"ORNEKLER

       Asagidaki  iki  komut  sirayla  calitirilarak   yeni   bir   dilin   ve
       eylemcisinin kaydini yapacaktir.

           CREATE FUNCTION plsample_call_handler() RETURNS language_handler
               AS '$libdir/plsample'
               LANGUAGE C;
           CREATE LANGUAGE plsample
               HANDLER plsample_call_handler;

UYUMLULUK

       CREATE LANGUAGE bir PostgreSQL olusumudur.

ILGILI BELGELER

       ALTER LANGUAGE [alter_language(7)],
       CREATE FUNCTION [create_function(7)],
       DROP LANGUAGE [drop_language(7)],
       GRANT [grant(7)], REVOKE [revoke(7)], createlang(1), droplang(1).

,CEVIREN

       Nilgun Belma Buguner <nilgun (at) belgeler.gen.tr>, Nisan 2005