Menu

Primary Key PostgreSQL: Identity, SERIAL, dan UUID

Cara mendefinisikan primary key di PostgreSQL dan cara membuat nilainya: kolom identity, SERIAL yang lebih lama, dan UUID dengan gen_random_uuid(). Juga composite key dan reset sequence.

Halaman ini dilengkapi editor yang bisa dijalankan. Edit, jalankan, dan lihat output-nya seketika.

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 IDENTITY menolak nilai eksplisit di INSERT, kecuali insert-nya menyebut OVERRIDING SYSTEM VALUE. Ini default yang lebih aman.
  • GENERATED BY DEFAULT AS IDENTITY memakai 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.

Ilustrasi bahasa pemrograman di Coddy

Belajar coding dengan Coddy

Mulai