ALTER TABLE mengubah tabel yang sudah ada. Bentuk yang paling sering kamu butuhkan adalah ADD COLUMN, RENAME COLUMN ... TO, DROP COLUMN, dan ALTER COLUMN ... TYPE. Beberapa aksi bisa ditulis dalam satu pernyataan, dipisahkan koma.
Baris yang sudah ada mendapat 'free' di plan dan NULL di signed_up. Sejak PostgreSQL 11, menambah kolom dengan default konstan tidak menulis ulang tabel, jadi tetap cepat bahkan di tabel besar. Default yang volatile seperti clock_timestamp() tetap menulis ulang setiap baris.
Mengganti nama kolom atau tabel
Ganti nama terjadi seketika dan mempertahankan data, index, dan constraint. View tetap berjalan, karena view merujuk ke id internal tabel, bukan namanya. Nama yang tertulis sebagai teks di tempat lain tidak ikut berubah: isi fungsi PL/pgSQL dan query aplikasi masih memakai nama lama, jadi cari dulu nama itu sebelum menggantinya.
Menghapus kolom
DROP COLUMN menghapus kolom beserta datanya. Perintah ini gagal jika ada view atau foreign key yang bergantung pada kolom itu. CASCADE ikut menghapus semuanya, dan IF EXISTS melewati error saat kolomnya sudah tidak ada.
PostgreSQL tidak menulis ulang tabel di sini. Ia menandai kolom itu sebagai terhapus, dan ruangnya kembali saat baris diperbarui atau saat tabel ditulis ulang.
Mengubah tipe kolom
ALTER COLUMN ... TYPE mengonversi setiap nilai. Saat tidak ada cast otomatis dari tipe lama ke tipe baru, tambahkan USING dengan ekspresi yang menghitung nilai barunya:
Tanpa USING, pernyataan ini gagal dengan column "price" cannot be cast automatically to type numeric. Jika ada satu saja nilai yang tidak bisa dikonversi, seluruh pernyataan gagal dan tabelnya tidak berubah.
Sebagian besar perubahan tipe menulis ulang tabel. Ada yang tidak: memperpanjang varchar(n), atau mengubah varchar menjadi text.
Mengatur atau menghapus default dan NOT NULL
SET NOT NULL memindai tabel dan gagal jika ada baris yang berisi NULL, jadi isi dulu yang kosong:
DROP DEFAULT dan DROP NOT NULL membatalkannya. Default baru hanya berlaku untuk insert berikutnya. Baris yang sudah ada tetap memakai nilainya.
Menambah constraint
ALTER TABLE orders ADD CONSTRAINT total_positive CHECK (total > 0);
ALTER TABLE orders DROP CONSTRAINT total_positive;
Menambah CHECK atau foreign key memindai seluruh tabel untuk memvalidasinya. Di tabel yang besar dan sibuk, tambahkan dulu dengan NOT VALID, yang hanya memeriksa baris baru. Lalu jalankan ALTER TABLE orders VALIDATE CONSTRAINT total_positive;. Perintah ini memeriksa baris lama dengan lock yang lebih lemah, sehingga baca dan tulis tetap berjalan. Halaman foreign key memakai pola yang sama, dan referensi ALTER TABLE memuat setiap bentuk beserta lock-nya.
Pertanyaan yang sering diajukan
Bisakah mengubah urutan kolom di PostgreSQL?
Tidak bisa. ALTER TABLE tidak bisa memindahkan kolom, dan kolom baru selalu ditambahkan di akhir. Tulis kolom dengan urutan yang kamu mau di SELECT-mu, atau buat tabel baru dengan urutan itu lalu salin datanya.
Apakah ALTER TABLE mengunci tabel di PostgreSQL?
Sebagian besar bentuknya mengambil lock ACCESS EXCLUSIVE, yang memblokir baca dan tulis sampai pernyataannya selesai. Perubahan cepat (ganti nama, hapus kolom, tambah kolom dengan default konstan) hanya menahannya sebentar. Perubahan tipe yang menulis ulang tabel menahannya selama penulisan ulang berlangsung.
Bagaimana cara menambah beberapa kolom sekaligus di PostgreSQL?
Pisahkan aksinya dengan koma dalam satu pernyataan: ALTER TABLE users ADD COLUMN phone text, ADD COLUMN city text;. Semua aksi dalam satu ALTER TABLE berjalan bersama, dengan satu lock.
Bisakah ALTER TABLE di-rollback di PostgreSQL?
Bisa. DDL di PostgreSQL bersifat transaksional, jadi ALTER TABLE di dalam BEGIN ... ROLLBACK dibatalkan sepenuhnya.