INSERT SQLite: Tambah Baris, Bulk Insert, OR IGNORE

INSERT Menambahkan Baris ke Tabel

INSERT adalah pernyataan yang kamu pakai untuk memasukkan baris baru ke dalam tabel. Bentuknya singkat dan mudah ditebak:

CREATE TABLE books (
    id     INTEGER PRIMARY KEY,
    title  TEXT NOT NULL,
    author TEXT,
    year   INTEGER
);

INSERT INTO books (title, author, year)
VALUES ('The Left Hand of Darkness', 'Ursula K. Le Guin', 1969);

SELECT * FROM books;

Ada tiga bagian yang perlu diperhatikan:

• INSERT INTO books: tabel tujuan.
• (title, author, year): kolom-kolom yang nilainya kamu berikan.
• VALUES (...): nilai-nilainya, dengan urutan yang sama seperti daftar kolom.

id tidak ada di daftar kolom, jadi SQLite mengisinya secara otomatis (kolom itu INTEGER PRIMARY KEY, yang mendapat rowid). Kolom apa pun yang kamu lewati akan memakai nilai default-nya, atau NULL jika tidak punya default.

Selalu Tuliskan Kolommu

Kamu bisa menghilangkan daftar kolom dan memberi nilai untuk setiap kolom sesuai urutan deklarasinya:

-- Works, but fragile:
INSERT INTO books VALUES (NULL, 'Dune', 'Frank Herbert', 1965);

Jangan lakukan itu. Begitu seseorang menambahkan kolom ke books, setiap pernyataan seperti ini akan rusak atau mulai memasukkan nilai ke kolom yang salah. Tuliskan kolomnya:

CREATE TABLE books (
    id     INTEGER PRIMARY KEY,
    title  TEXT NOT NULL,
    author TEXT,
    year   INTEGER
);

INSERT INTO books (title, author, year)
VALUES ('Dune', 'Frank Herbert', 1965);

SELECT id, title, year FROM books;

Daftar kolom yang eksplisit adalah salah satu bentuk dokumentasi. Pernyataannya jadi bisa dibaca dengan sendirinya, tanpa harus mencari definisi tabelnya.

Menambahkan Banyak Baris

Kamu bisa menambahkan beberapa baris dalam satu pernyataan dengan menuliskan lebih banyak tuple nilai:

CREATE TABLE books (
    id     INTEGER PRIMARY KEY,
    title  TEXT NOT NULL,
    author TEXT,
    year   INTEGER
);

INSERT INTO books (title, author, year) VALUES
    ('Dune', 'Frank Herbert', 1965),
    ('Neuromancer', 'William Gibson', 1984),
    ('Hyperion', 'Dan Simmons', 1989);

SELECT count(*) AS total FROM books;

Ini lebih rapi daripada tiga pernyataan INSERT terpisah, dan SQLite menganggap semuanya sebagai satu pernyataan. Namun, keuntungan performa yang sebenarnya untuk pemuatan data besar datang dari membungkus insert dalam transaksi. Penjelasannya ada di bagian berikut.

Bulk Insert: Bungkus dalam Transaksi

Secara default, setiap INSERT adalah transaksi tersendiri. SQLite menjalankan fsync di akhir setiap transaksi, dan itulah yang membuat perulangan sederhana jadi lambat, bukan insert-nya.

Kelompokkan insert-nya:

CREATE TABLE numbers (n INTEGER);

BEGIN;
INSERT INTO numbers (n) VALUES (1);
INSERT INTO numbers (n) VALUES (2);
INSERT INTO numbers (n) VALUES (3);
INSERT INTO numbers (n) VALUES (4);
INSERT INTO numbers (n) VALUES (5);
COMMIT;

SELECT count(*) AS total, sum(n) AS total_sum FROM numbers;

Satu fsync, bukan lima. Untuk ribuan baris, selisihnya bisa mencapai seratus hingga seribu kali lipat. Jika ada yang gagal di dalamnya, ROLLBACK membatalkan seluruh kelompok itu.

Pola ini adalah resep bulk insert. Pakai pola ini baik saat kamu memanggil SQLite dari Python, Node, maupun Rust: bungkus perulanganmu dengan BEGIN / COMMIT.

INSERT ... SELECT: Menyalin dari Tabel Lain

Kamu bisa mengisi tabel dari sebuah query, bukan dari nilai literal:

CREATE TABLE books (
    id     INTEGER PRIMARY KEY,
    title  TEXT NOT NULL,
    year   INTEGER
);
INSERT INTO books (title, year) VALUES
    ('Dune', 1965), ('Neuromancer', 1984), ('Hyperion', 1989);

CREATE TABLE classics (title TEXT, year INTEGER);

INSERT INTO classics (title, year)
SELECT title, year FROM books WHERE year < 1980;

SELECT * FROM classics;

Kolom dari SELECT dicocokkan berdasarkan posisi dengan daftar kolom milik INSERT. Namanya tidak harus sama, yang penting urutannya. Ini cara standar untuk mengarsipkan baris, membuat tabel laporan, atau menyalin sebagian data saat migrasi.

DEFAULT VALUES dan Kolom yang Dilewati

Jika sebuah kolom punya klausa DEFAULT, kamu bisa tidak menuliskannya di daftar kolom dan SQLite akan mengisi nilai default-nya:

CREATE TABLE events (
    id         INTEGER PRIMARY KEY,
    name       TEXT NOT NULL,
    created_at TEXT DEFAULT (datetime('now'))
);

INSERT INTO events (name) VALUES ('signup');
INSERT INTO events (name) VALUES ('login');

SELECT * FROM events;

created_at mendapat timestamp saat ini karena kita tidak memberikan nilainya. Jika kamu ingin baris yang seluruhnya berisi nilai default, yang berguna untuk baris penampung, pakai bentuk DEFAULT VALUES:

CREATE TABLE counters (
    id    INTEGER PRIMARY KEY,
    value INTEGER DEFAULT 0
);

INSERT INTO counters DEFAULT VALUES;
INSERT INTO counters DEFAULT VALUES;

SELECT * FROM counters;

Dua baris baru, keduanya dengan value = 0 dan id yang diisi otomatis.

INSERT OR IGNORE: Lewati Duplikat

Jika sebuah baris akan melanggar constraint UNIQUE atau PRIMARY KEY, perilaku default-nya adalah menghentikan pernyataan dengan error:

Error: UNIQUE constraint failed: users.email

INSERT OR IGNORE menggantinya dengan "lewati baris yang bermasalah tanpa suara":

CREATE TABLE users (
    id    INTEGER PRIMARY KEY,
    email TEXT UNIQUE NOT NULL
);

INSERT INTO users (email) VALUES ('ada@example.com');

INSERT OR IGNORE INTO users (email) VALUES
    ('ada@example.com'),    -- duplicate, skipped
    ('boris@example.com'),  -- inserted
    ('rosa@example.com');   -- inserted

SELECT * FROM users;

Tiga baris bertahan. Duplikatnya dibuang tanpa error. Inilah cara khas SQLite untuk menyatakan "insert jika belum ada" untuk data seed sederhana: tanpa SELECT terpisah untuk memeriksa dulu, tanpa penanganan exception.

INSERT OR REPLACE: Timpa Duplikat

INSERT OR REPLACE menghapus baris yang bentrok dan memasukkan baris baru sebagai gantinya:

CREATE TABLE settings (
    key   TEXT PRIMARY KEY,
    value TEXT
);

INSERT INTO settings (key, value) VALUES ('theme', 'light');

INSERT OR REPLACE INTO settings (key, value) VALUES ('theme', 'dark');

SELECT * FROM settings;

Waspadai satu hal: REPLACE adalah DELETE + INSERT, bukan UPDATE. Jika baris yang dihapus dirujuk oleh foreign key dengan ON DELETE CASCADE, baris anak itu ikut terhapus. Dan setiap kolom yang tidak kamu tuliskan di INSERT yang baru akan kembali ke nilai default-nya, bukan mempertahankan nilai lama.

Untuk sebagian besar kasus "update jika ada, insert jika belum", yang sebenarnya kamu butuhkan adalah upsert sungguhan dengan ON CONFLICT ... DO UPDATE. Topik itu dibahas di halamannya sendiri.

Ringkasan Singkat

• INSERT INTO table (cols) VALUES (...): bentuk dasarnya. Selalu tuliskan kolomnya.
• Insert banyak baris memakai tuple yang dipisahkan koma setelah VALUES.
• Untuk pemuatan data yang benar-benar besar, bungkus insert dengan BEGIN / COMMIT.
• INSERT INTO ... SELECT ... menyalin baris dari sebuah query.
• DEFAULT VALUES membuat baris hanya dari nilai default; kolom yang dilewati juga kembali ke nilai default-nya.
• INSERT OR IGNORE melewati baris yang bentrok; INSERT OR REPLACE menimpanya (lewat delete + insert).

Selanjutnya: UPDATE

Menambahkan baris baru separuh cerita. Separuh lainnya adalah mengubah baris yang sudah ada: menaikkan penghitung, memperbaiki salah ketik, menandai pesanan sebagai sudah dikirim. Itulah UPDATE, dan pernyataan ini punya kebiasaan-kebiasaan tersendiri yang perlu dikuasai (terutama klausa WHERE). Dibahas berikutnya.