Provided by: manpages-tr_1.0.5.1-2_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
PostgreSQL ALTER TABLE(7)