Foreign key mengikat sebuah kolom ke primary key, atau kolom unik, di tabel lain. PostgreSQL menolak nilai apa pun yang tidak punya baris pasangan di sana. Tulis sebagai column type REFERENCES other_table (column). Tambahkan ON DELETE CASCADE atau ON DELETE SET NULL untuk menentukan apa yang terjadi pada baris anak saat induknya dihapus.
Kolom yang dirujuk harus punya constraint PRIMARY KEY atau UNIQUE. Dengan REFERENCES customers tanpa kolom, PostgreSQL memakai primary key milik customers.
Seperti apa pelanggarannya
Pesanan untuk pelanggan yang tidak ada akan ditolak:
Error-nya menyebut nama constraint, orders_customer_id_fkey, yaitu nama yang diberikan PostgreSQL untuk foreign key tanpa nama. Menghapus pelanggan yang masih punya pesanan gagal dengan cara yang sama, kecuali key-nya menentukan lain.
Opsi ON DELETE
| Opsi | Saat baris induk dihapus |
|---|---|
NO ACTION (default) | Penghapusan gagal selama baris anak masih ada |
RESTRICT | Sama, tapi pemeriksaannya tidak bisa ditunda ke akhir transaksi |
CASCADE | Baris anak ikut dihapus |
SET NULL | Kolom foreign key di baris anak menjadi NULL |
SET DEFAULT | Kolom di baris anak mendapat nilai default-nya |
ON UPDATE menerima opsi yang sama. Opsi ini berlaku saat nilai key di induk berubah, yang jarang terjadi dengan id buatan.
CASCADE cocok untuk baris yang tidak bermakna tanpa induknya, seperti item dalam sebuah pesanan:
Hanya chair yang tersisa. Cascade mengikuti key berikutnya juga, jadi satu penghapusan bisa menghapus baris di beberapa tabel.
SET NULL mempertahankan baris anak dan melepaskannya:
Ada tetap ada, dengan team_id bernilai NULL. Sejak PostgreSQL 15, ON DELETE SET NULL (column) bisa mengosongkan hanya sebagian kolom dari key multi-kolom.
Menambah foreign key ke tabel yang sudah ada
ALTER TABLE orders
ADD CONSTRAINT orders_customer_id_fkey
FOREIGN KEY (customer_id) REFERENCES customers (id) ON DELETE CASCADE;
Perintah ini memeriksa setiap baris yang ada dan gagal jika ada yang tidak punya induk. Di tabel besar, tambahkan key dengan NOT VALID, yang hanya memeriksa baris baru. Lalu jalankan ALTER TABLE orders VALIDATE CONSTRAINT orders_customer_id_fkey; untuk memeriksa baris lama tanpa memblokir penulisan. Untuk mengubah aksi ON DELETE pada key yang sudah ada, hapus constraint-nya lalu tambahkan lagi dalam satu ALTER TABLE.
Beri index pada kolom foreign key
PostgreSQL meng-index sisi yang dirujuk, bukan kolom yang merujuk. Tanpa index di orders.customer_id, setiap penghapusan dari customers memindai seluruh orders untuk mencari baris anak, begitu juga saat mengambil pesanan milik satu pelanggan:
CREATE INDEX orders_customer_id_idx ON orders (customer_id);
Untuk melihat daftar foreign key sebuah tabel, query pg_constraint:
Join lewat key ini dibahas di halaman join, dan bab constraint di manual memuat aturan lengkapnya, termasuk key yang bisa ditunda (deferrable).
Pertanyaan yang sering diajukan
Apakah PostgreSQL membuat index untuk foreign key?
Tidak di kolom yang merujuk. Kolom yang dirujuk sudah punya index, karena kolom itu harus primary key atau unik. Buat sendiri index di kolom foreign key, karena join dan penghapusan dari tabel induk mencari di kolom itu.
Bagaimana cara menghapus foreign key di PostgreSQL?
ALTER TABLE orders DROP CONSTRAINT orders_customer_id_fkey;. Foreign key tanpa nama diberi nama table_column_fkey; \d orders di psql menampilkan nama persisnya.
Bisakah kolom foreign key bernilai NULL di PostgreSQL?
Bisa. NULL di kolom foreign key tidak diperiksa, jadi baris itu tidak butuh induk. Tambahkan NOT NULL saat setiap baris wajib punya induk.
Bisakah foreign key merujuk ke tabel yang sama?
Bisa. Kolom seperti manager_id int REFERENCES employees (id) menunjuk ke baris lain di tabel yang sama. Begitulah struktur pohon seperti bagan organisasi dan utas komentar disimpan.