Agora Metin2 1
Agora Metin2
berzahx 1
berzahx
Aliyldrim 2
Aliyldrim
-ECD- 1
-ECD-
Reklam vermek için turkmmo@gmail.com

SQLite Bağlantısı: Python, Node, Go, Java ile Uygulama Pratikleri

  • Konuyu başlatan Konuyu başlatan Agora Metin2
  • Başlangıç tarihi Başlangıç tarihi
  • Cevaplar Cevaplar 0
  • Görüntüleme Görüntüleme 14
image1b4bbda66acb6973.jpg


Veritabanı Bağlantısı: Aslında Sadece Bir Dosya İşlemi

SQLite’ın alışılagelmiş bir sunucu yapısı yoktur. Yani bağlanmanız gereken bir sunucu adresi, giriş için kimlik bilgileri veya arka planda çalışan bir servis bulunmaz. SQLite özelinde "bağlantı kurmak", sürücünün disk üzerindeki bir dosyayı açması ve üzerinde okuma-yazma işlemlerine başlamasıdır. Teknik olarak temel mantık bundan ibarettir.

Her programlama dilinde SQLite’ın C kütüphanesiyle etkileşime giren arayüzler mevcuttur. Dillerin sözdizimleri farklı olsa da izlenen adımlar ortaktır: dosya yolunu belirtmek, veritabanını açmak, sorguları yürütecek bir yönetim nesnesi (handle) oluşturmak ve işlem tamamlandığında bağlantıyı sonlandırmak.

SQL:
-- Kavramsal olarak, her sürücü şunu yapar:
-- 1. Verilen yoldaki dosyayı açar veya oluşturur.
-- 2. Bir handle (tanıtıcı) edinir.
-- 3. [Hazırlanmış](/docs/tr/sqlite/prepared-statements) ifadeler aracılığıyla SQL çalıştırır.
-- 4. Handle'ı kapatır.

Aşağıda farklı dillerde bu bağlantıların nasıl yapıldığına ve ilk sorgudan önce hangi ayarların kritik olduğuna değineceğiz.

Python: sqlite3 Modülü

Python, beraberinde gelen sqlite3 kütüphanesi sayesinde ek bir kuruluma ihtiyaç duymaz. Standart kullanımı şöyledir:

SQL:
-- Python
import sqlite3

conn = sqlite3.connect("app.db")
conn.execute("CREATE TABLE IF NOT EXISTS notes (id INTEGER PRIMARY KEY, body TEXT)")
conn.execute("INSERT INTO notes (body) VALUES (?)", ("ilk not",))
conn.commit()

for row in conn.execute("SELECT id, body FROM notes"):
    print(row)

conn.close()

Dikkat edilmesi gereken temel noktalar:

• sqlite3.connect("app.db") komutu, dosya mevcut değilse dosyayı kendisi oluşturur. Eğer veritabanını sadece bellek üzerinde çalıştırmak isterseniz ":memory:" ifadesini kullanın.
• Salt okunur erişim için sqlite3.connect("file:app.db?mode=ro", uri=True) formatı kullanılır.
• Güvenliğiniz için string birleştirme yerine SQL içinde ? ile temsil edilen parametre bağlama yöntemini tercih edin.
• with conn: gibi bir bağlam yöneticisi kullanmadığınız durumlarda, değişiklikleri kaydetmek için conn.commit() çağrısını mutlaka yapmalısınız.

Uzun soluklu projelerde, eş zamanlı işlemlerde hata almamak için bir "busy timeout" değeri belirlemek verimliliği artırır:

SQL:
-- Python
conn.execute("PRAGMA busy_timeout = 5000")   -- en fazla 5 saniye bekle
conn.execute("PRAGMA journal_mode = WAL")    -- daha iyi eşzamanlılık

Node.js: better-sqlite3 Kullanımı

Node.js dünyasında yaygın olarak better-sqlite3 kütüphanesi tercih edilir. Bu kütüphane senkron yapıda çalışır; bu durum Node.js'in doğasına aykırı gibi görünse de SQLite sorguları çok kısa sürede tamamlandığı için performans açısından oldukça verimlidir.

SQL:
-- Node.js
const Database = require("better-sqlite3");
const db = new Database("app.db");

db.exec("CREATE TABLE IF NOT EXISTS notes (id INTEGER PRIMARY KEY, body TEXT)");

const insert = db.prepare("INSERT INTO notes (body) VALUES (?)");
insert.run("ilk not");

const rows = db.prepare("SELECT id, body FROM notes").all();
console.log(rows);

db.close();

db.prepare(...) metodu, tekrar kullanılabilen bir ifade yapısı döndürür. Veri yazmak için .run(), tüm sonuçları çekmek için .all() ve tek kayıt için .get() metodları kullanılır.

Bağlantı anında şu ayarları yapılandırmayı unutmayın:

SQL:
-- Node.js
db.pragma("journal_mode = WAL");
db.pragma("busy_timeout = 5000");
db.pragma("foreign_keys = ON");   -- varsayılan olarak kapalıdır, neredeyse her zaman istenir

Özellikle foreign_keys = ON ayarı kritiktir; SQLite varsayılan olarak yabancı anahtar kısıtlamalarını devre dışı bırakır ve bu ayar her bağlantıda manuel olarak tetiklenmelidir.

Go: database/sql Entegrasyonu

Go dili, database/sql arayüzü ile sürücüden bağımsız bir yapı sunar. SQLite için genellikle saf Go ile yazılan modernc.org/sqlite veya CGO tabanlı github.com/mattn/go-sqlite3 tercih edilir.

SQL:
-- Go
import (
    "database/sql"
    _ "modernc.org/sqlite"
)

db, err := sql.Open("sqlite", "app.db?_pragma=journal_mode(WAL)&_pragma=busy_timeout(5000)")
if err != nil { panic(err) }
defer db.Close()

_, err = db.Exec("CREATE TABLE IF NOT EXISTS notes (id INTEGER PRIMARY KEY, body TEXT)")
_, err = db.Exec("INSERT INTO notes (body) VALUES (?)", "ilk not")

rows, _ := db.Query("SELECT id, body FROM notes")
defer rows.Close()
for rows.Next() {
    var id int; var body string
    rows.Scan(&id, &body)
    fmt.Println(id, body)
}

sql.Open fonksiyonu hemen bir bağlantı açmaz, ilk sorguyla birlikte bağlantıyı başlatır. db bir bağlantı havuzu olarak yönetilir. SQLite için genellikle db.SetMaxOpenConns(1) ayarı ile tek bir bağlantı üzerinden çalışmak yazma çakışmalarını önlemek adına mantıklıdır.

Java: JDBC ile SQLite

Java tarafında org.xerial:sqlite-jdbc kütüphanesi standarttır. Bağlantı metni şu formattadır: jdbc:sqlite:<path>:

SQL:
-- Java
import java.sql.*;

try (Connection conn = DriverManager.getConnection("jdbc:sqlite:app.db")) {
    try (Statement st = conn.createStatement()) {
        st.execute("CREATE TABLE IF NOT EXISTS notes (id INTEGER PRIMARY KEY, body TEXT)");
        st.execute("PRAGMA journal_mode = WAL");
        st.execute("PRAGMA busy_timeout = 5000");
    }

    try (PreparedStatement ps = conn.prepareStatement("INSERT INTO notes (body) VALUES (?)")) {
        ps.setString(1, "ilk not");
        ps.executeUpdate();
    }

    try (PreparedStatement ps = conn.prepareStatement("SELECT id, body FROM notes");
         ResultSet rs = ps.executeQuery()) {
        while (rs.next()) System.out.println(rs.getInt(1) + " " + rs.getString(2));
    }
}

Bellek içi veritabanı için jdbc:sqlite::memory: kullanabilirsiniz. Salt okunur ayarlar için ise SQLiteConfig sınıfını kullanmak en temiz yoldur.

PHP: PDO Kullanımı

PDO arayüzünde SQLite bağlantı dizgisi (DSN) sqlite:<yol> şeklindedir:

SQL:
-- PHP
$db = new PDO("sqlite:app.db");
$db->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);

$db->exec("CREATE TABLE IF NOT EXISTS notes (id INTEGER PRIMARY KEY, body TEXT)");
$db->exec("PRAGMA journal_mode = WAL");
$db->exec("PRAGMA busy_timeout = 5000");

$stmt = $db->prepare("INSERT INTO notes (body) VALUES (?)");
$stmt->execute(["ilk not"]);

foreach ($db->query("SELECT id, body FROM notes") as $row) {
    echo $row["id"] . " " . $row["body"] . "\n";
}

Hata yönetimi için ATTR_ERRMODE değerini istisna fırlatacak (exception) şekilde ayarlamak, gizli hataları tespit etmek için en iyi yöntemdir.

Bağlantı Dizgileri ve Dosya Yolları

Bağlantı yolları sürücülere göre değişse de iki temel yöntem yaygındır:

• Doğrudan dosya yolu: app.db veya ./data/app.db gibi. Göreli yollar yerine uygulama çalışma dizinine bağımlı olmayan mutlak (absolute) yolları kullanmak daha güvenlidir.
• URI biçimi: file:app.db?mode=rwc&cache=shared gibi formatlarla salt okunur mode=ro veya okuma-yazma gibi modlar ayarlanabilir.

Özel durumlar:

• :memory: - Sadece o bağlantıya özel, geçici bellek veritabanı.
• file::memory:?cache=shared - Aynı süreçteki farklı bağlantıların paylaştığı bellek veritabanı.
• "" - Bağlantı kesildiğinde silinen geçici disk dosyası.

Bağlantı Havuzu (Connection Pooling) ve SQLite

SQLite tek bir yazma kilidi (single-writer) mekanizmasıyla çalışır. Birden fazla bağlantıyı havuza almak, yazma işlemlerini hızlandırmaz; aksine kilit çakışmalarına neden olabilir. Yine de şu durumlarda havuz kullanımı uygundur:

• WAL modu açıkken eş zamanlı okuma işlemlerini hızlandırmak.
• Uzun süren sorguların tüm sistemi tıkamasını (head-of-line blocking) engellemek.

Web projelerinde şu yapı önerilir:

• WAL modunu aktif edin.
• busy_timeout değerini birkaç saniye tutun.
• Havuz boyutunu 1 yazıcı ve ihtiyaç duyulan sayıda okuyucuya göre optimize edin.
• Foreign key kısıtlamalarını her bağlantıda aktif hale getirin.

SQL:
-- Bunları her yeni bağlantıda uygulayın:
PRAGMA journal_mode = WAL;
PRAGMA busy_timeout = 5000;
PRAGMA foreign_keys = ON;
PRAGMA synchronous = NORMAL;   -- WAL ile güvenlidir; FULL'dan daha hızlıdır

synchronous = NORMAL ayarını WAL ile kullanmak, performans ve veri güvenliği arasında iyi bir denge kurar.

Bağlantıyı Kapatmanın Önemi

Bağlantıları conn.close() veya ilgili metodla kapatmak, dosya tanıtıcılarının (file descriptor) sızmasını ve WAL dosyalarının gereksiz büyümesini engeller. Sürekli çalışan servislerde ise bağlantıyı her seferinde kapatıp açmak yerine, bağlantıyı uygulama yaşam döngüsü boyunca canlı tutmak daha performanslıdır.

SQL:
-- Python - süreç başına bir bağlantı, istekler arasında yeniden kullanılır
DB = sqlite3.connect("app.db", check_same_thread=False)
DB.execute("PRAGMA journal_mode = WAL")
DB.execute("PRAGMA busy_timeout = 5000")
DB.execute("PRAGMA foreign_keys = ON")

Python gibi dillerde, thread (iş parçacığı) bazlı çalışırken check_same_thread=False ayarına dikkat etmelisiniz.

Canlı Ortam Öncesi Kontrol Listesi

Uygulamanızı yayına almadan önce şunları onaylayın:

• Dosya yolu için mutlaka mutlak yol tanımlayın.
• PRAGMA journal_mode = WAL modunu aktif edin.
• busy_timeout ayarını 2-10 saniye arası yapılandırın.
• Foreign key kısıtlamalarını etkinleştirin.
• Prepared statement ve parametre bağlama kullanın.
• Uygulamanın veritabanı klasörüne yazma izni olduğundan emin olun.
• Yedekleme stratejinizi belirleyin (VACUUM INTO veya .backup).

Sıradaki Adım: Veritabanı Şeması Yönetimi

Bağlantı kurmak işin başlangıcıdır. Bir sonraki aşamada, veritabanı şemasını manuel işlemler yerine ALTER TABLE ve sürüm kontrolü ile yönetmenizi sağlayacak "migration" yapılarını inceleyeceğiz.
 

Şu an konuyu görüntüleyenler (Toplam : 0, Üye: 0, Misafir: 0)

Geri
Üst