İSİM

       CREATE LANGUAGE - yeni bir yordamsal dil tanımlar

KULLANIM

       CREATE [ TRUSTED ] [ PROCEDURAL ] LANGUAGE isim
           HANDLER eylemci [ VALIDATOR doğrulama_işlevi ]

AÇIKLAMA

       CREATE  LANGUAGE kullanarak, bir PostgreSQL kulanıcısı bir PostgreSQL veritabanı için yeni
       bir yordamsal dil kaydı yapabilir. Bundan sonra bu yeni dilde işlevler ve tetik yordamları
       tanımlanabilir.  Yeni  bir  dil  kaydı  yapabilmek  için kullanıcı, PostgreSQL ayrıcalıklı
       kullanıcısı yetkilerine sahip olmalıdır.

       CREATE LANGUAGE aslında, bir dilde  yazılmış  işlevlerin  çalıştırılmasından  sorumlu  bir
       eylemci ile bu dili ilişkilendirir. Dil eylemcileri hakkında ayrıntılı bilgi edinmek için
       http://www.postgresql.org/uygulamalar/pgsql/xplang.html adresine bakınız.

       Yordamsal   dil   kaydı   her   veritabanına  ayrı  ayrı  yapılmalıdır.  Bir  dilin  bütün
       veritabanlarında öntanımlı olması için, bu dil template1 veritabanında kayıtlı olmalıdır.

PARAMETRELER

       TRUSTED
              Eylemcinin dil için gövenli olduğunu belirtir. Bu, bir  yetkisiz  kullanıcı  erişim
              kısıtlamalarını   aşacak   herhangi   bir   işlevselliği   kullanmayacak  demektir.
              Belirtilmezse,  sadece  PostgreSQL  ayrıcalıklı  kullanıcısının  yetkilerine  sahip
              kullanıcılar bu dili yeni bir işlev tanımlamak için kullanabilecektir.

       PROCEDURAL
              Gereksizdir (etkisi yoktur).

       isim   Yeni   yordamsal   dilin   ismi.   Dil   ismi  harf  büyüklüğüne  duyarlıdır.  İsim
              veritabanındaki dil isimleri arasında eşsiz olmalıdır.

              Geriye uyumluluk için isim tek tırnak içine alınabilir.

       HANDLER eylemci
              eylemci  yordamsal  dilin  işlevlerini   çalıştırmak   için   çağrılacak,   evvelce
              kaydedilmiş  bir  işlevin  ismidir.  Bir  yordamsal dilin eylemci işlevi C gibi bir
              derlenen dilin 1. sürüm çağrı uzlaşımı ile yazılmış olmalı ve  argüman  almayan  ve
              dönüş   türü   language_handler   olan  bir  işlev  olarak  kaydedilmiş  olmalıdır.
              language_handler  dönüş  türü,  işlevi  bir  eylemci  işlev   olarak   tanımlamakta
              kullanılan bir yer tutucu türdür.

       VALIDATOR doğrulama_işlevi
              doğrulama_işlevi  yeni dilde yeni bir işlev oluşturulduğunda yeni işlevi doğrulamak
              için  çağrılacak  evvelce  kaydedilimiş  bir  işlevin  ismidir.  Böyle  bir   işlev
              belirtilmezse,  yeni  bir işlev oluşturulduğunda sınanmayacaktır. Doğrulama işlevi,
              yeni oluşturulacak işlevin nesne kimliği için oid türünde  bir  argüman  almalıdır.
              İşlev genellikle void döndürecek şekilde tasarlanır.

              Bir  doğrulama  işlevi  genellikle  işlev gövdesini sözdizimsel doğruluk bakımından
              inceler, ama işlevin diğer özelliklerine de (dilin desteklemediği bir argüman  türü
              kullanılmış  mı,  acaba; gibi) bakar. Bir hatayı sinyallemek için, doğrulama işlevi
              ereport() işlevini kullanmalıdır. İşlevin dönüş değeri yok sayılır.

EK BİLGİ

       Bu komut normalde doğrudan kullanıcılar tarafından  çalıştırılmaz.  Yordamsal  diler  için
       PostgreSQL  dağıtımında bulunan createlang(1) aracı kullanılmalıdır. Bu araç ayrıca, doğru
       eylemciyi de kuracaktır. (createlang yerine CREATE LANGUAGE'de kullanılabilir.)

       PostgreSQL'in 7.3 sürümünden önce, eylemci işlevin  language_handler türünde değil, opaque
       türde  yer  tutucu  döndürmesi  gerekirdi.  Eski döküm dosyalarını desteklemek için CREATE
       LANGUAGE opaque türde değer döndüren bir işlevi kabul edecektir, ama işlevin,  dönüş  türü
       language_handler   olacak   şekilde   bildirilmesinin   gerektiğini   bildiren  bir  uyarı
       gösterecektir.

       Yeni bir işlev oluşturmak için CREATE FUNCTION [create_function(7)] kullanılır.

       Bir yordamsal dili veritabanından kaldırmak için DROP LANGUAGE  [drop_language(7)]  ya  da
       daha iyisi droplang(1) aracını kullanın.

       Sistem kataloğu pg_language (bkz.
       http://www.postgresql.org/uygulamalar/pgsql/catalog-pg-language.html),  o  an  kurulu olan
       diller hakkındaki bilgileri kaydeder. Ayrıca, createlang kurulu  dilleri  listelemek  için
       bir seçeneğe sahiptir.

       Bir  kullanıcının  bir  yordamsal  dili kullanabilmesi için, USAGE yetkisi olması gerekir.
       Eğer dilin güvenilir olduğu biliniyorsa, createlang herkese  bu  izni  özdevinimli  olarak
       verir.

ÖRNEKLER

       Aşağıdaki  iki  komut  sırayla  çalıtırılarak  yeni  bir  dilin  ve  eylemcisinin  kaydını
       yapacaktır.

           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 oluşumudur.

İLGİLİ 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).

ÇEVİREN

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