Provided by:
manpages-tr_1.0.5.1-1.1_all 
Ä°SÄ°M
ALTER TABLE - bir tablonun tanımını değiştirir
KULLANIM
ALTER TABLE [ ONLY ] isim [ * ]
eylem [, ... ]
ALTER TABLE [ ONLY ] isim [ * ]
RENAME [ COLUMN ] sütun TO yeni_sütun
ALTER TABLE isim
RENAME TO yeni_isim
eylem ÅŸunlardan biri olabilir:
ADD [ COLUMN ] sütun tür [ sütun_kısıtı [ ... ] ]
DROP [ COLUMN ] sütun [ RESTRICT | CASCADE ]
ALTER [ COLUMN ] sütun TYPE tür [ USING ifade ]
ALTER [ COLUMN ] sütun SET DEFAULT ifade
ALTER [ COLUMN ] sütun DROP DEFAULT
ALTER [ COLUMN ] sütun { SET | DROP } NOT NULL
ALTER [ COLUMN ] sütun SET STATISTICS tamsayı
ALTER [ COLUMN ] sütun
SET STORAGE { PLAIN | EXTERNAL | EXTENDED | MAIN }
ADD tablo_kısıtı
DROP CONSTRAINT kısıt_ismi [ RESTRICT | CASCADE ]
CLUSTER ON indeks_ismi
SET WITHOUT CLUSTER
SET WITHOUT OIDS
OWNER TO yeni_aidiyet
SET TABLESPACE tabloalanı_ismi
AÇIKLAMA
ALTER TABLE mevcut bir tablonun tanımını değiştirir. Çeşitli alt
biçimleri vardır:
ADD COLUMN
CREATE TABLE [create_table(7)] ile aynı sözdizimini kullanarak
tabloya yeni bir sütun eklemekte kullanılır.
DROP COLUMN
Bir tablodan bir sütunu kaldırmak için kullanılır. Sütunla
ilgili indeksler ve tablo kısıtları özdevimli olarak kaldırılır.
Anahtar başvuruları ve sanal tablolar gibi sütuna tablo dışında
bağımlı herşeyin buna dahil olmasını istiyorsanız, CASCADE'a da
ihtiyacınız var demektir.
ALTER COLUMN TYPE
Bir tablo sütununun türünü değiştirmekte kullanılır. Sütunla
ilgili indeksler ve tablo kısıtları yeni sütun türünü kullanacak
şekilde, özgün olarak sağlanmış ifadelerle yeniden çözümlerek
özdevimli olarak değiştirilir. İsteğe bağlı USING deyimiyle yeni
sütun değerlerinin eski değerlerden nasıl hesaplanacağı
belirtilir; kullanılmadığı takdirde, öntanımlı dönüşüm, eski
veri türünden yeni veri türüne atama dönüşümü şeklinde yapılır.
Eski türden yeni türe dönüşüm için bir örtük dönüşüm ya da atama
dönüşümü yoksa, bir USING deyimi kullanılmak zorundadır.
SET/DROP DEFAULT
Bir sütunun öntanımlı değerini belirlemek ya da kaldırmak için
kullanılır. Öntanımlı değerler, sadece sonraki INSERT
cümlelerine uygulanır; tablodaki mevcut satırları etkilemez.
Öntanımlılar, ayrıca sanal tablolar için de oluşturulmuş
olabilir, bu durumda sadece, sanal tabloya ON INSERT
uygulanmadan önce INSERT deyimiyle yerleştirilir.
SET/DROP NOT NULL
Bir sütunun NULL değerlere izin verip vermeyeceğini belirlemek
için kullanılır. Sadece, sütun bir NULL değer içermediği
takdirde, SET NOT NULL kullanabilirsiniz.
SET STATISTICS
Sonraki ANALYZE [analyze(7)] işlemleri için sütun başına
istatistik toplama hedefini belirlemek için kullanılır. Hedef
0-1000 aralığında ya da sistem öntanımlı istatistik hedefininin
(bir yapılandırma parametresi olan default_statistics_target'in
değerinin) kullanılması için -1 olarak belirtilebilir.
PostgreSQL sorgu planlamacısı tarafından istatistiklerin
kullanımı hakkında daha fazla bilgi edinmek için
http://www.postgresql.org/docs/8.0/static/planner-stats.html
adresine bakınız.
SET STORAGE
Bir sütunun saklama kipini belirlemek için kullanılır. Bu,
sütunun içerde mi yoksa ek bir tabloda mı tutulacağını ve
verinin sıkıştılacağını mı yoksa sıkıştılmayacağını mı denetler.
integer gibi sabit genişlikli değerlerin için içerde ve
sıkıştırılmış olması için PLAIN kullanılmalıdır. İçerde ve
sıkıştırılmış değerler için MAIN, harici ve sıkıştırılmamış
değerler için EXTERNAL, harici ve sıkıştırılmış değerler için
EXTENDED kullanılır. EXTENDED, PLAIN kipini desteklemeyen çoğu
veri türü için öntanımlıdır. EXTERNAL kullanımı text ve bytea
türündeki sütunlar için saklama alanını büyütmesine karşın
altdizge işlemlerinin, daha hızlı yapılmasını sağlar. SET
STORAGE tablo üzerindeki hiçbir şeyi kendisi değiştirmez, sadece
gelecekteki tablo güncellemeleri sırasında izlenecek stratejiyi
belirler. Daha fazla bilgi için
http://www.postgresql.org/docs/8.0/static/storage-toast.html
adresine bakınız.
ADD tablo_kısıtı
CREATE TABLE [create_table(7)] ile aynı sözdizimini kullanarak
tabloya yeni bir kısıt eklemekte kullanılır.
DROP CONSTRAINT
Bir tablodaki kısıtları kaldırmak için kullanılır. Şimdilik,
tablolardaki kısıtların eşsiz isimlere sahip olması
gerekmemektedir, dolayısıyla belirtilen isimle eşleşen birden
fazla kısıt olabilir. Eşleşen tüm kısıtlar kaldırılacaktır.
CLUSTER
Sonraki CLUSTER [cluster(7)] işlemleri için öntanımlı indeksi
seçmekte kullanılır. Gerçekte tabloyu yeniden kümelemez.
SET WITHOUT CLUSTER
Tabloda en son kullanılan CLUSTER [cluster(7)] indeks
belirtimini kaldırmak için kullanılır. Bu, gelecekteki bir
indeks belirtmeyen tüm kümeleme işlemlerini etkileyecektir.
SET WITHOUT OIDS
Tablodan oid sistem sütununu kaldırmak için kullanılır. Zaten
bir oid sütununun bulunmadığından şikayet etmesi dışında, DROP
COLUMN oid RESTRICT deyimine tamamen eÅŸdeÄŸerdir.
Kaldırılmış bir oid sütununun tekrar yerine konulmasını
sağlayacak bir ALTER TABLE alt biçimi olmadığına dikkat edin.
OWNER Tablonun, kayıt listesinin veya sanal tablonun sahibini
belirtilen kullanıcı yapar.
SET TABLESPACE
Tablonun tablo alanını değiştirmek için kullanılır. Tablo ile
ilişkili tüm veri dosyalarının yani tablo alanına taşınmasını
sağlar. İndeksler eğer varsa yani alana taşınmaz; taşınması
isteniyorsa, ayrı bir cümle olarak bir SET TABLESPACE cümlesi
ile yapılabilir. Ayrıca CREATE TABLESPACE [create_tablespace(7)]
kılavuz sayfasına de bakınız.
RENAME Bir tablo (veya indeks, kayıt listesi ya da sanal tablo) ismini
ya da bir tablonun tek bir sütununun ismini değiştirmekte
kullanılır. Saklanmış veriler etkilenmez.
RENAME dışında tüm eylemler çeşitli değişikliklerin birlikte
uygulanması için aynı cümlede kullanılabilir. Örneğin, bazı sütunların
isimleri değiştirilirken, bazı sütunların eklenmesi mümkündür. Bu işlem
genellikle, tüm değişikliklerin tek bir geçişte yapılması zorunlu dev
tablolarda kullanışlıdır.
Çalıştırılması için ayrıcalıklı kullanıcı olmanın gerekli olduğu ALTER
TABLE OWNER dışında, ALTER TABLE kullanabilmek için tablonun sahibi
olmalısınız.
PARAMETRELER
isim DeÄŸiÅŸtirilecek tablonun ismi (ÅŸema nitelemeli olabilir). EÄŸer
ONLY belirtilmiÅŸse sadece bu tablo deÄŸiÅŸtirilir, belirtilmemiÅŸse
bu tablo ve onun çocukları olan tablolar (varsa) değiştirilir.
Çocuk tablolarında değiştirileceğini belirtmek üzere tablo
isminin sonuna bir * eklenebilirse de, bu artık öntanımlıdır.
(7.1 sürümünden önce, ONLY öntanımlı davranıştır. Öntanımlı
davranış sql_inheritance yapılandırma parametresi ile
deÄŸiÅŸtirilebilir.)
sütun Yeni ya da mevcut bir sütunun ismi.
yeni_sütun
Yeni ya da mevcut bir sütunun yeni ismi.
yeni_isim
Tablonun yeni ismi.
tür Mevcut bir sütun için yeni veri türü ya da yeni bir sütunun veri
türü.
tablo_kısıtı
Tablo için yeni tablo kısıtı.
kısıt_ismi
Kaldırılacak mevcut bir kısıtın ismi.
CASCADE
Kaldırılan kısıt veya sütuna bağımlı nesnelerin (örneğin, bu
sütuna başvuran sanal tabloların) özdevimli olarak
kaldırılmasını sağlar.
RESTRICT
Bağımlı nesneleri olan kısıt veya sütunun kaldırılmasını
engeller. Bu davranış öntanımlıdır.
indeks_ismi
Tablonun kümeleme için imleyeceği indeks ismi.
yeni_aidiyet
Tablonun yeni sahibinin kullanıcı ismi.
tabloalanı_ismi
Tablonun taşınacağı yeni tablo alanı ismi.
EK BÄ°LGÄ°
COLUMN anahtar sözcüğü kuru gürültüdür ve atlanabilir.
Bir sütun ADD COLUMN ile eklendiğinde, tablodaki mevcut satırların tümü
sütunun öntanımlı değeriyle ilklendirilir (bir DEFAULT deyimi
belirtilmemiÅŸse NULL ile).
Bir sütunun boş olmayan bir öntanımlı ile eklenmesi veya mevcut bir
sütunun türünün değiştirilmesi tablonun tamamının yeniden yazılmasına
sebep olur. Bu çok büyük tablolarda önemli sayılabilecek bir süre alır;
ayrıca, geçici olarak büyüklüğünün iki katı kadar bir disk alanı
gerektirecektir.
Bir CHECK veya NOT NULL kısıtının eklenmesi mevcut satırların kısıtı
yerine getirip getirmediğinin sınanması için tablonun taranmasını
gerektirir.
Tek bir ALTER TABLE cümlesinde çok sayıda değişikliğin belirtilebilmesi
seçeneğinin sağlanmasının ana sebebi çok sayıda tablonun taranmasını ya
da tablonun yeniden yazılmasının gerektiği durumlarda tüm
değişikliklerin tek bir geçişte yapılmasınını sağlamaktır.
DROP COLUMN sütunu fiziksel olarak silmez, sadece SQL işlemleri için
görünmez yapar. Tablo üzerindeki sonraki veri girme ve güncelleme
işlemleri sütunda boş değer saklanmasına sebep olur. Bu, bir sütunun
kaldırılmasını hızlandırsa da tablonun diskte kapladığı alan,
kaldırılan sütunun kapladığı alan geri alınmadığından hemen
düşmeyecektir. Mevcut satırlar güncellendikçe bu alan geri
kazanılacaktır ama bu çok uzun zaman alabilir.
Aslında ALTER TABLE cümlesinin bir tablonun tümünün yeniden yazılmasını
gerektirdiği durumda bir getirisi de vardır, yeniden yazma işlemi
tablodaki ölü alanların elenmesini sağlar. Örneğin, kaldırılan bir
sütun nedeniyle tabloda tutulan alanı hemen geri kazanmak için en hızlı
yol,
ALTER TABLE tablo ALTER COLUMN birsütun TYPE birtür;
yazmaktır. Burada birsütun ile mevcut bir sütunu, birtür ile ise o
sütunun kendi türünü belirtiyoruz. Aslında tabloda bir değişiklik
yapılmıyor ama bu cümle tablonun yeniden yazılmasını sağlıyor, böylece
faydasız veri temizlenmiş oluyor.
ALTER TYPE alt cümlesinin USING seçeneği aslında satırın eski
deÄŸerleriyle iliÅŸkili bir ifadeyi belirtebilir; yani, bit yandan diÄŸer
sütunlara başvururken birini dönüştürüyor olabilir. Bu, ALTER TYPE
sözdizimi ile çok genel dönüşümler yapılmasını mümkün kılar. Bu
esneklikten dolayı, USING ifadesi sütunun öntanımlı değerine (varsa)
uygulanmaz; sonuç bir öntanımlı için gerekli olan bir sabit ifade
olmayabilir. Bu, eski türden yeni türe örtük ya da atamalı tür
dönüşümünün bulunmadığında, USING seçeneği kullanıldığında bile ALTER
TYPE alt cümlesinin dönüşümde başarısız olacağı anlamına gelir. Böyle
durumlarda, öntanımlı DROP DEFAULT ile kaldırılarak ALTER TYPE
uygulanır ve bunun ardından SET DEFAULT kullanılarak uygun yeni
öntanımlı değer eklenir. Sütünla ilgili indekslere ve kısıtlara da
benzer şeyler uygulanır.
Eğer bir tablonun bir çocuk tablosu varsa, çocuk tablolarda aynı
değişklikler yapılmaksızın bu tablonun bir sütununun türünün ya da
isminin değiştirilmesine ve bir sütun eklenmesine izin verilmez. Yani,
ALTER TABLE ONLY reddedilir. Bu, bir tablonun çocuklarının daima ana
tablonun sütunlarını içermesini sağlamak içindir.
Hem ana tabloya hem de çocuk tablolara uygulanan bir DROP COLUMN işlemi
ile sadece, çocuk tablonun ilgili sütunu aynı zamanda başka bir
tablodan miras alınmamışsa ve sütun bağımsız olarak tanımlanmamışsa
kaldırılacaktır. Sadece ana tabloya uygulanan DROP COLUMN işlemi (ALTER
TABLE ONLY ... DROP COLUMN gibi), çocuk tablolardan bu sütunları asla
kaldırmayacak, onları miras alınmış değil, bağımsız sütunlar olarak
imleyecektir.
Sistem katalog tablosunda herhangi bir deÄŸiÅŸikliÄŸe izin verilmez.
Geçerli parametrelerin açıklamaları için CREATE TABLE [create_table(7)]
kılavuz sayfasına bakınız. Kalıtım ile ilgili bilgileri ise
http://www.postgresql.org/docs/8.0/static/ddl.html bölümünde
bulabilirsiniz.
ÖRNEKLER
Bir tabloya varchar türünde bir sütun eklemek için:
ALTER TABLE distributors ADD COLUMN address varchar(30);
Bir tablodan bir sütunu kaldırmak için:
ALTER TABLE distributors DROP COLUMN address RESTRICT;
Mevcut iki sütunun türünü tek bir işlemle değiştirmek için:
ALTER TABLE distributors
ALTER COLUMN address TYPE varchar(80),
ALTER COLUMN name TYPE varchar(100);
UNIX zaman değerini içeren bir sütunun türünü USING seçeneğini
kullanarak timestamp with time zone (zaman dilimli zaman gösterimi)
türüne dönüştürmek için:
ALTER TABLE foo
ALTER COLUMN foo_timestamp TYPE timestamp with time zone
USING timestamp with time zone
'epoch' + foo_timestamp * interval '1 second';
Mevcut bir sütunun ismini değiştirmek için:
ALTER TABLE distributors RENAME COLUMN address TO city;
Mevcut bir tablonun ismini değiştirmek için:
ALTER TABLE distributors RENAME TO suppliers;
Bir sütuna boş değer içermeme kısıtı eklemek için:
ALTER TABLE distributors ALTER COLUMN street SET NOT NULL;
Bir sütundan boş değer içermeme kısıtını kaldırmak için:
ALTER TABLE distributors ALTER COLUMN street DROP NOT NULL;
Bir tabloya bir sınama kısıtı eklemek için:
ALTER TABLE distributors
ADD CONSTRAINT zipchk CHECK (char_length(zipcode) = 5);
Bir tablodan ve çocuklarından bir sınama kısıtını kaldırmak için:
ALTER TABLE distributors DROP CONSTRAINT zipchk;
Bir tabloya bir anahtar kısıtı eklemek için:
ALTER TABLE distributors
ADD CONSTRAINT distfk FOREIGN KEY (address)
REFERENCES addresses (address) MATCH FULL;
Bir tabloya (çoksütunlu) bir eşsizlik kısıtı eklemek için:
ALTER TABLE distributors
ADD CONSTRAINT dist_id_zipcode_key UNIQUE (dist_id, zipcode);
Bir tabloya bir birincil anahtarı olmasa bile, özdevimli isimlenen bir
birincil anahtar kısıtı eklemek için:
ALTER TABLE distributors ADD PRIMARY KEY (dist_id);
Bir tabloyu başka bir tablo alanına taşımak için:
ALTER TABLE distributors SET TABLESPACE fasttablespace;
UYUMLULUK
ADD, DROP ve SET DEFAULT alt biçimleri SQL standardıyla uyumludur.
Diğer alt biçimler birer PostgreSQL oluşumudur. Ayrıca, tek bir ALTER
TABLE cümlesinde birden fazla değişikliğin belirtilebilmesi özelliği de
bir PostgreSQL oluÅŸumudur.
ALTER TABLE DROP COLUMN ile geriye bir sıfır sütunlu tablo kalmak üzere
bir tablonun tek sütunu kaldırılabilir. SQL standardı sıfır sütunluk
tablolara izin vermediÄŸinden bu da bir PostgreSQL oluÅŸumudur.
ÇEVİREN
Nilgün Belma Bugüner <nilgun (at) belgeler·gen·tr>, Mart 2005