Çalıştırılabilir SQLite Dokümanları: INSERT

Q: SQLite'ta tek bir satırı nasıl eklerim?

Temel yapı şu: INSERT INTO tablo (kolon1, kolon2) VALUES (deger1, deger2);. Kolon listesi yazmak zorunlu değil ama şiddetle tavsiye ederim — ileride tabloya yeni bir kolon eklendiğinde sorgunuz çalışmaya devam eder. Kolon listesi yazmazsanız, tüm kolonlar için tanımlandıkları sırayla değer vermeniz gerekir.

Q: SQLite'ta birden fazla satır tek seferde nasıl eklenir?

VALUES kısmından sonra parantezli demetleri virgülle ayırarak art arda yazın: INSERT INTO t (a, b) VALUES (1, 2), (3, 4), (5, 6);. Binlerce satırlık gerçek toplu yüklemelerde ise asıl hız kazancı çoklu satır sözdiziminden değil, insert'leri BEGIN ve COMMIT ile tek bir transaction içine almaktan gelir.

Q: INSERT OR IGNORE ne işe yarar?

INSERT OR IGNORE, UNIQUE, PRIMARY KEY veya NOT NULL kısıtını ihlal edecek satırları hata fırlatmak yerine sessizce atlar. Çakışan satır geçilir, sorgunun geri kalanı çalışmaya devam eder. "Zaten varsa ekleme" davranışını ayrı bir kontrol sorgusu yazmadan istediğinizde tam aradığınız şey budur.

Q: INSERT yaparken neden 'UNIQUE constraint failed' hatası alıyorum?

SQLite, UNIQUE veya PRIMARY KEY kolonunda aynı değere sahip bir satır bulmuş demektir. Ya değer gerçekten tekrar eden bir kayıt, ya da seed scriptini ikinci kez çalıştırıyorsunuz. Yinelenenleri atlamak için INSERT OR IGNORE, üzerine yazmak için INSERT OR REPLACE veya daha kontrollü bir upsert için ON CONFLICT ... DO UPDATE kullanabilirsiniz.

INSERT ile Tabloya Satır Ekleme

SQLite'ta yeni satır eklemek için kullandığınız komut INSERT. Yapısı kısa ve tahmin edilebilir:

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;

Dikkat etmeniz gereken üç kısım var:

INSERT INTO books — hedef tablo.
(title, author, year) — değer vereceğin sütunlar.
VALUES (...) — sütun sırasıyla aynı sırada gelen değerler.

id sütun listesinde yok, çünkü SQLite onu otomatik olarak atıyor (INTEGER PRIMARY KEY olduğu için rowid değerini alıyor). Listeye yazmadığınız her sütun varsayılan değerine düşer; varsayılan tanımlı değilse NULL olur.

Sütunları Her Zaman Açıkça Yaz

Sütun listesini atlayıp tüm sütunlara tanımlandıkları sırayla değer vermek mümkün:

-- Çalışır, ancak kırılgandır:
INSERT INTO books VALUES (NULL, 'Dune', 'Frank Herbert', 1965);

Sapma. books tablosuna biri yeni bir kolon eklediği an, bu şekilde yazılmış her ifade ya patlar ya da değerleri yanlış kolonlara yazmaya başlar. Kolonları açık açık yazın:

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;

Sütun isimlerini açıkça yazmak bir tür dokümantasyon görevi görür — sorguyu okuyan kişi tablo tanımına bakmaya ihtiyaç duymadan ne olup bittiğini anlar.

SQLite ile çoklu satır ekleme

Tek bir INSERT ifadesinde birden fazla değer kümesi yazarak aynı anda birkaç satırı birden ekleyebilirsiniz:

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;

Bu yaklaşım, üç ayrı INSERT cümlesinden çok daha temiz duruyor ve SQLite hepsini tek bir ifade olarak işliyor. Ama toplu veri yüklemede asıl performans farkını yaratan şey, insert'leri bir transaction içine almak — birazdan ona da geleceğiz.

SQLite toplu insert: işlemi transaction'a sarın

SQLite varsayılan olarak her INSERT cümlesini ayrı bir transaction olarak çalıştırır. Her birinin sonunda bir fsync yapar; klasik döngü içindeki insert'leri yavaşlatan da zaten bu — insert'in kendisi değil.

Hepsini tek seferde gruplayın:

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;

Beş fsync yerine bir tane. Binlerce satırda bu fark iki, hatta üç kat büyüklüğe ulaşabiliyor. Arada bir şey ters giderse ROLLBACK tüm partiyi geri alıyor.

Bu kalıp, sqlite toplu insert işinin klasik reçetesidir. SQLite'ı Python'dan mı çağırıyorsunuz, Node'dan mı, Rust'tan mı — fark etmez; döngünüzü BEGIN / COMMIT arasına alın yeter.

INSERT ... SELECT: Başka Bir Tablodan Veri Kopyalamak

Bir tabloyu sabit değerler yerine bir sorgunun sonucundan da doldurabilirsiniz; buna sqlite insert select deniyor:

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;

SELECT ifadesinden gelen sütunlar, INSERT cümlesindeki sütun listesine sıraya göre eşleştirilir. İsimlerin uyuşması şart değil — önemli olan sıra. Bu yaklaşım; satırları arşivlemek, raporlama tabloları oluşturmak veya bir migration sırasında verinin bir kısmını kopyalamak için standart yöntemdir.

DEFAULT VALUES ve Atlanan Sütunlar

Bir sütunda DEFAULT tanımı varsa, onu sütun listesinden çıkarabilirsiniz; SQLite varsayılan değeri kendisi yerleştirir:

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

INSERT INTO events (name) VALUES ('kayıt');
INSERT INTO events (name) VALUES ('giriş');

SELECT * FROM events;

created_at sütunu, biz değer vermediğimiz için otomatik olarak şu anki zaman damgasını alır. Tamamen varsayılan değerlerden oluşan bir satır eklemek istiyorsanız — mesela placeholder satırlar oluştururken işine yarar — DEFAULT VALUES biçimini kullanabilirsiniz:

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

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

SELECT * FROM counters;

İki yeni satır eklendi; ikisinin de value değeri 0 ve id'leri otomatik atandı.

INSERT OR IGNORE: Yinelenen kayıtları atlama

Eklenmek istenen bir satır UNIQUE veya PRIMARY KEY kısıtlamasını ihlal ederse, varsayılan davranış işlemi durdurup hata fırlatmaktır:

Error: UNIQUE constraint failed: users.email

INSERT OR IGNORE ise bu davranışı değiştirir; çakışan satırı sessizce atlar:

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'),    -- yinelenen, atlandı
    ('boris@example.com'),  -- eklendi
    ('rosa@example.com');   -- eklendi

SELECT * FROM users;

Üç satır hayatta kalır. Tekrar eden kayıt sessizce, hata vermeden atlanır. Basit seed verisi için "kayıt yoksa ekle" mantığını ifade etmenin SQLite'a özgü, deyimsel yolu budur — önce ayrı bir SELECT ile kontrol etmeye veya exception yakalamaya gerek kalmadan.

INSERT OR REPLACE: Mevcut Kaydın Üzerine Yazma

INSERT OR REPLACE, çakışan satırı silip yerine yenisini ekler:

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;

Dikkat etmeniz gereken bir nokta var: REPLACE aslında DELETE + INSERT demek, UPDATE değil. Silinen satıra ON DELETE CASCADE ile bağlı foreign key'ler varsa, çocuk kayıtlar da silinir. Ayrıca yeni INSERT sırasında belirtmediğiniz kolonlar eski değerini korumaz; varsayılan değerine döner.

"Varsa güncelle, yoksa ekle" senaryolarının çoğunda aslında istediğiniz şey gerçek bir upsert: yani ON CONFLICT ... DO UPDATE. Onu da ayrı bir sayfada ele alıyoruz.

Kısa bir özet

INSERT INTO tablo (kolonlar) VALUES (...) — temel kullanım. Kolonları her zaman açıkça yaz.
Çoklu satır ekleme için VALUES'tan sonra virgülle ayrılmış demetler kullanılır.
Gerçek toplu insert işlemlerinde sorguları BEGIN / COMMIT arasına al.
INSERT INTO ... SELECT ... bir sorgudan gelen satırları kopyalar.
DEFAULT VALUES sadece varsayılan değerlerle satır oluşturur; atladığınız kolonlar da varsayılana düşer.
INSERT OR IGNORE çakışan satırları atlar; INSERT OR REPLACE ise onları üzerine yazar (sil + ekle yöntemiyle).

Sırada: UPDATE

Satır eklemek işin yarısı. Diğer yarısı ise mevcut satırları değiştirmek — bir sayacı artırmak, yazım hatasını düzeltmek, siparişi "kargolandı" olarak işaretlemek. Bunun için UPDATE var ve doğru kullanmak için bilmeniz gereken kendine has alışkanlıkları var (özellikle de WHERE koşulu konusunda). Sırada o var.

Sıkça Sorulan Sorular

SQLite'ta tek bir satırı nasıl eklerim?

Temel yapı şu: INSERT INTO tablo (kolon1, kolon2) VALUES (deger1, deger2);. Kolon listesi yazmak zorunlu değil ama şiddetle tavsiye ederim — ileride tabloya yeni bir kolon eklendiğinde sorgunuz çalışmaya devam eder. Kolon listesi yazmazsanız, tüm kolonlar için tanımlandıkları sırayla değer vermeniz gerekir.

SQLite'ta birden fazla satır tek seferde nasıl eklenir?

VALUES kısmından sonra parantezli demetleri virgülle ayırarak art arda yazın: INSERT INTO t (a, b) VALUES (1, 2), (3, 4), (5, 6);. Binlerce satırlık gerçek toplu yüklemelerde ise asıl hız kazancı çoklu satır sözdiziminden değil, insert'leri BEGIN ve COMMIT ile tek bir transaction içine almaktan gelir.

INSERT OR IGNORE ne işe yarar?

INSERT OR IGNORE, UNIQUE, PRIMARY KEY veya NOT NULL kısıtını ihlal edecek satırları hata fırlatmak yerine sessizce atlar. Çakışan satır geçilir, sorgunun geri kalanı çalışmaya devam eder. "Zaten varsa ekleme" davranışını ayrı bir kontrol sorgusu yazmadan istediğinizde tam aradığınız şey budur.

INSERT yaparken neden 'UNIQUE constraint failed' hatası alıyorum?

SQLite, UNIQUE veya PRIMARY KEY kolonunda aynı değere sahip bir satır bulmuş demektir. Ya değer gerçekten tekrar eden bir kayıt, ya da seed scriptini ikinci kez çalıştırıyorsunuz. Yinelenenleri atlamak için INSERT OR IGNORE, üzerine yazmak için INSERT OR REPLACE veya daha kontrollü bir upsert için ON CONFLICT ... DO UPDATE kullanabilirsiniz.

İlgili kavramlar

SQLite INSERT: Satır Ekleme, Toplu Insert ve OR IGNORE