Mengatasi Error PostgreSQL: "Duplicate Key Value Violates Unique Constraint"

Jika Anda pernah bekerja dengan database PostgreSQL, mungkin Anda pernah mengalami error berikut: "duplicate key value violates unique constraint". Error ini cukup umum, terutama ketika kita bekerja dengan kolom yang seharusnya unik, tetapi tanpa sengaja mencoba memasukkan nilai yang sama. Artikel ini akan membantu Anda memahami error tersebut dan memberikan solusi yang tepat untuk mengatasinya.

Apa Itu "Duplicate Key Value Violates Unique Constraint"?

Error ini terjadi ketika kita mencoba memasukkan data yang memiliki nilai yang sama pada kolom yang diatur agar unik. PostgreSQL menggunakan constraint unik untuk memastikan bahwa tidak ada duplikasi dalam kolom tertentu, seperti email atau ID. Jika kita mencoba memasukkan nilai duplikat, PostgreSQL akan memunculkan error ini.

Contoh Error :

ERROR: duplicate key value violates unique constraint "users_email_key"
DETAIL: Key (email)=(example@example.com) already exists.

Error di atas berarti ada duplikasi pada kolom email yang diatur untuk unik. Nilai "example@example.com" sudah ada di database, sehingga tidak bisa ditambahkan lagi.

Solusi untuk Mengatasi Error Ini

Ada beberapa cara untuk menangani error ini tergantung situasi yang Anda hadapi:

1. Cek Data yang Sudah Ada

Langkah pertama yang harus dilakukan adalah memeriksa apakah data yang akan dimasukkan sudah ada di tabel. Anda bisa menggunakan query berikut untuk memeriksa apakah nilai tersebut sudah tersimpan:

SELECT * FROM users WHERE email = 'example@example.com';

Jika data sudah ada, Anda bisa memutuskan apakah Anda ingin meng-update data yang sudah ada atau tidak melakukan apa-apa.

2. Gunakan ON CONFLICT untuk Mengatasi Duplikasi

Jika Anda ingin menambahkan data baru tanpa khawatir duplikasi, PostgreSQL menyediakan fitur ON CONFLICT yang memungkinkan Anda untuk menangani situasi di mana duplikasi terjadi.

Mengabaikan Insert Jika Terjadi Duplikasi:
Anda bisa menggunakan perintah ini untuk mengabaikan insert jika data sudah ada:

        INSERT INTO users (email, name) VALUES ('example@example.com', 'John Doe') ON CONFLICT (email) DO NOTHING;

Update Data Jika Terjadi Duplikasi:

Jika Anda ingin meng-update data yang sudah ada ketika terjadi konflik, gunakan perintah berikut:

        INSERT INTO users (email, name) VALUES ('example@example.com', 'John Doe') ON CONFLICT (email) DO UPDATE SET name = EXCLUDED.name;

Perintah di atas akan meng-update nama jika email sudah ada di database.

3. Tangani Error dalam Kode Aplikasi

Di tingkat aplikasi, Anda juga bisa menangani error ini dengan menangkapnya melalui kode. Misalnya, jika Anda menggunakan Laravel, Anda bisa menangkap error dan melakukan logika tertentu, seperti update data jika terjadi duplikasi.

Contoh dalam Laravel:

try {
    User::create([
        'email' => 'example@example.com',
        'name' => 'John Doe'
    ]);
} catch (\Illuminate\Database\QueryException $e) {
    if ($e->getCode() == 23505) { 
        User::where('email', 'example@example.com')
            ->update(['name' => 'John Doe']);
    }
}

Dengan cara ini, Anda bisa memproses duplikasi di tingkat aplikasi tanpa membiarkan error PostgreSQL muncul.

4. Tambahkan Unique Constraint jika Belum Ada

Jika kolom yang seharusnya unik belum memiliki constraint, Anda bisa menambahkannya baik melalui SQL langsung maupun melalui migration (jika menggunakan framework seperti Laravel).

Menambahkan Unique Constraint dengan SQL:

CREATE UNIQUE INDEX users_email_unique ON users(email);

Menambahkan Unique Constraint dengan Migration di Laravel:

Schema::table('users', function (Blueprint $table) {
    $table->unique('email');
});

Constraint unik ini akan memastikan bahwa tidak ada nilai duplikat yang bisa dimasukkan ke kolom tersebut di masa depan.

5. Bersihkan Data Duplikat yang Sudah Ada

Jika duplikasi sudah terjadi di dalam database, Anda perlu membersihkan data terlebih dahulu sebelum menambahkan constraint unik.

WITH duplicates AS (
    SELECT ctid, ROW_NUMBER() OVER (PARTITION BY email ORDER BY id) AS rn
    FROM users
)
DELETE FROM users
WHERE ctid IN (SELECT ctid FROM duplicates WHERE rn > 1);
Query ini akan menghapus semua baris duplikat, tetapi menyisakan satu baris dengan nilai unik.

Kesimpulan

Error "duplicate key value violates unique constraint" di PostgreSQL muncul ketika Anda mencoba memasukkan data yang sudah ada pada kolom yang memiliki constraint unik. Beberapa solusi yang dapat Anda gunakan antara lain:

Menemukan Duplikasi:

Anda bisa menggunakan query berikut untuk menemukan baris-baris duplikat dalam database:

Dengan menerapkan langkah-langkah ini, Anda bisa mencegah dan menangani error duplikasi di PostgreSQL dengan lebih baik.

1. Memeriksa data sebelum melakukan insert.
2. Menggunakan ON CONFLICT untuk menangani konflik saat insert.
3. Menangani error di tingkat aplikasi.
4. Menambahkan constraint unik pada kolom yang relevan.
5. Membersihkan duplikasi data sebelum menambahkan constraint.