Primary key adalah kolom, atau sekumpulan kolom, yang mengidentifikasi setiap baris. Nilainya harus unik dan tidak boleh NULL, dan satu tabel hanya boleh punya satu. Di PostgreSQL, biasanya kamu membiarkan database membuat nilainya dengan kolom identity: id bigint GENERATED ALWAYS AS IDENTITY PRIMARY KEY.
Id-nya 1 dan 2. Mendefinisikan key juga membuat unique index di kolom itu, bernama users_pkey.
Kolom identity: ALWAYS vs BY DEFAULT
Kolom identity adalah cara standar SQL untuk memberi nomor baris, tersedia sejak PostgreSQL 10. Ada dua bentuk:
GENERATED ALWAYS AS IDENTITYmenolak nilai eksplisit diINSERT, kecuali insert-nya menyebutOVERRIDING SYSTEM VALUE. Ini default yang lebih aman.GENERATED BY DEFAULT AS IDENTITYmemakai nilai buatan hanya saat kamu tidak memberikan nilai sendiri.
Dengan BY DEFAULT, memasukkan id sendiri membuat sequence tertinggal, dan id buatan berikutnya bertabrakan. Setelah mengimpor baris dengan id eksplisit, majukan sequence melewati id tertinggi dengan setval:
Tanpa baris setval, insert terakhir akan mendapat id 1 dan gagal dengan error duplicate key. Dengan baris itu, baris baru mendapat 4.
SERIAL vs identity
serial (4 byte) dan bigserial (8 byte) bukan tipe sungguhan. Keduanya adalah singkatan yang membuat sequence dan mengatur default kolom menjadi nextval() dari sequence itu:
Kolomnya hanyalah integer biasa dengan default nextval('legacy_id_seq'::regclass). Tidak ada yang mencegah insert menulis id-nya sendiri, dan sequence-nya butuh hak akses tersendiri. Kolom identity memperbaiki keduanya, jadi utamakan kolom identity di tabel baru. serial masih berjalan, dan kamu akan menemukannya di schema dan tutorial lama.
Pakai bigint (atau bigserial) untuk tabel yang bisa terus bertambah. Key integer habis setelah sekitar 2,1 miliar nilai.
UUID sebagai primary key
gen_random_uuid() mengembalikan UUID versi 4 yang acak. Fungsi ini sudah bawaan sejak PostgreSQL 13, jadi tidak perlu extension:
Setiap kali dijalankan, id yang dicetak berbeda, masing-masing 36 karakter dalam bentuk teks. Tipe uuid menyimpannya dalam 16 byte, jadi pakai tipe itu, bukan text. PostgreSQL 18 menambahkan uuidv7(), yang membuat UUID berurutan waktu sehingga dimasukkan sesuai urutan index. Di PostgreSQL 17, buat UUID semacam itu di aplikasimu.
Composite primary key
Satu key bisa mencakup beberapa kolom, ditulis di barisnya sendiri dalam CREATE TABLE. Ini key yang alami untuk tabel penghubung, tempat setiap pasangan hanya boleh muncul sekali:
Pasangan (1, 10) yang berulang dilewati, jadi hitungannya 3. Untuk menambah key ke tabel yang sudah ada, pakai ALTER TABLE t ADD PRIMARY KEY (col). Halaman ALTER TABLE membahas perubahan lainnya. Tabel lain menunjuk ke key ini dengan foreign key.
Pertanyaan yang sering diajukan
Apakah PostgreSQL punya AUTO_INCREMENT?
Tidak dengan nama itu. Cara standarnya adalah kolom identity, id bigint GENERATED ALWAYS AS IDENTITY PRIMARY KEY, yang tersedia sejak PostgreSQL 10. Tipe serial dan bigserial yang lebih lama melakukan hal yang sama dengan sequence dan default.
Kenapa sequence id di PostgreSQL punya celah?
Sequence tetap memberikan nilai meskipun insert-nya kemudian gagal atau transaksinya di-rollback, dan nilai itu tidak pernah dipakai ulang. Celah itu normal dan tidak berbahaya, jadi jangan mengandalkan id yang berurutan.
Apakah primary key membuat index di PostgreSQL?
Ya. Primary key (dan setiap constraint UNIQUE) otomatis membuat unique index B-tree, yang untuk primary key diberi nama tablename_pkey.
Sebaiknya memakai UUID atau bigint untuk primary key?
Key identity bigint lebih kecil (8 byte dibanding 16) dan dimasukkan sesuai urutan index. UUID bisa dibuat di mana saja tanpa bolak-balik ke database dan tidak memperlihatkan berapa banyak baris yang ada. UUID acak menyebarkan insert ke seluruh index, yang lebih mahal di tabel besar.