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

SQLite Migrations: user_version ile Şema Versiyonlama

  • 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 13
image1b4bbda66acb6973.jpg


Veritabanı Şemalarındaki Evrim Süreci

Tasarladığınız veritabanı yapısı zamanla sabit kalmayacaktır. Projeniz geliştikçe yeni sütunlar eklenmesi, tabloların ayrıştırılması veya indeks yapılarının güncellenmesi gibi ihtiyaçlar doğacaktır. Buradaki temel mesele değişikliğin kendisi değil, bu güncellemelerin; sunucuda, yerel bilgisayarlarda veya kullanıcı cihazlarında hatasız bir şekilde uygulanabilmesidir.

Migration kavramı, veritabanını N sürümünden N+1 sürümüne geçiren düzenli SQL betikleri bütünüdür. Bu betikleri sıralı bir şekilde çalıştırarak veritabanınızı her zaman güncel tutabilirsiniz. Bu disiplinden uzaklaşmak, genellikle farklı ortamlarda yaşanan beklenmedik hataları beraberinde getirir.

SQLite'ta bu işi yönetmek için dahili olarak sunulan PRAGMA user_version aracı kullanılır. Bu, SQLite'ın müdahale etmediği ve tamamen sizin kontrolünüzde olan 32-bit'lik bir tam sayıdır.

SQL:
PRAGMA user_version;
PRAGMA user_version = 1;
PRAGMA user_version;

Yeni oluşturulan bir veritabanı varsayılan olarak 0 değerine sahiptir. Uygulamanız başladığında bu değeri kontrol ederek hangi aşamada olduğunuzu anlayabilir ve eksik olan migration adımlarını sırayla uygulayabilirsiniz.

Temel Migration Akışı

Migration sürecini, sıralı SQL dosyaları olarak düşünebilirsiniz. Uygulama, güncel user_version değerini okur ve bu değerden büyük olan tüm betikleri sırayla işler, ardından versiyon numarasını günceller.

Örnek olarak, ilk tablonuzu oluşturduğunuz 1 numaralı migration:

SQL:
BEGIN;

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

PRAGMA user_version = 1;

COMMIT;

Bu süreçte BEGIN; ... COMMIT; bloklarını kullanarak atomik bir yapı kurmalısınız. Eğer CREATE TABLE sırasında bir sorun çıkarsa, user_version güncellenmez ve hatayı giderme şansınız olur. PRAGMA user_version = 1 komutunun işlemin en sonunda yer alması, tüm adımların başarıyla tamamlandığını garanti altına alır.

Yeni bir sütun eklemek istediğinizde ise 2 numaralı migration şu şekilde görünür:

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

BEGIN;

ALTER TABLE users ADD COLUMN created_at TEXT
    NOT NULL DEFAULT (datetime('now'));

PRAGMA user_version = 2;

COMMIT;

SELECT sql FROM sqlite_master WHERE name = 'users';

Sistem, veritabanının mevcut sürümüne göre hangi adımların atılacağına karar verir. Sıralama, projenizin tutarlılığı için hayati öneme sahiptir.

ALTER TABLE Kısıtlamaları

SQLite'ın ALTER TABLE desteği oldukça sade tutulmuştur:

• ADD COLUMN: Opsiyonel varsayılan değere sahip sütunlar ekler.
• DROP COLUMN: Sütun siler (3.35+ sürümü).
• RENAME COLUMN: Sütun adını değiştirir (3.25+ sürümü).
• RENAME TO: Tabloyu yeniden adlandırır.

Bu komutlar ile sütun tipi değiştirmek, kısıtlamaları (NOT NULL, CHECK, FOREIGN KEY) güncellemek mümkün değildir.

SQL:
-- Desteklenmiyor:
ALTER TABLE users ALTER COLUMN email TYPE VARCHAR(255);
ALTER TABLE users ADD CONSTRAINT users_email_check CHECK (email LIKE '%@%');

Karmaşık şema değişikliklerinde, mevcut tabloyu yeniden oluşturma yöntemine başvurmanız gerekir.

Tabloyu Yeniden İnşa Etme Yöntemi

İstediğiniz yapıda yeni bir tablo oluşturup, verileri eski tablodan yeniye aktarmak ve ardından eski tabloyu silmek en güvenli yoldur.

SQL:
BEGIN;

CREATE TABLE users (
    id    INTEGER PRIMARY KEY,
    email TEXT NOT NULL UNIQUE,
    name  TEXT NOT NULL
);
INSERT INTO users (email, name) VALUES ('a@x.com', 'Ada'), ('b@x.com', 'Boris');

-- Şimdi email üzerine bir CHECK kısıtlaması istiyoruz. Yeniden oluşturalım:
CREATE TABLE users_new (
    id    INTEGER PRIMARY KEY,
    email TEXT NOT NULL UNIQUE CHECK (email LIKE '%@%'),
    name  TEXT NOT NULL
);

INSERT INTO users_new (id, email, name)
    SELECT id, email, name FROM users;

DROP TABLE users;
ALTER TABLE users_new RENAME TO users;

COMMIT;

SELECT * FROM users;

Bu "12 adımlı tarif" olarak bilinen yöntemi uygularken tetikleyicilere (trigger), görünümlere (view) ve yabancı anahtar (foreign key) bağımlılıklarına dikkat etmelisiniz. Eğer tablolar arası referans bütünlüğü varsa, migration sırasında PRAGMA foreign_keys = OFF komutuyla kontrolleri devre dışı bırakıp, işlem sonunda tekrar açmanız gerekir.

Uygulama Seviyesinde Migration Yönetimi

Bu basit takip sistemini kodunuz içerisine kolayca entegre edebilirsiniz. Örneğin Python ile şu şekilde yönetilebilir:

SQL:
-- Kavramsal olarak, uygulamanız başlangıçta şunu yapar:
--
--   current = SELECT user_version FROM PRAGMA;
--   for i in range(current + 1, len(MIGRATIONS) + 1):
--       MIGRATIONS[i]'yi bir transaction içinde çalıştır
--       PRAGMA user_version = i;
--
-- Her adımın çalıştırdığı SQL, yukarıdaki migration'lara benzer.

PRAGMA user_version;

Uygulamanız gereken temel kurallar şunlardır:

• Migration dosyaları 1'den başlayarak ardışık numaralandırılmalıdır.
• Her adım, versiyon artırımıyla beraber tek bir transaction içinde tamamlanmalıdır.
• Yayına alınmış hiçbir migration dosyası daha sonra değiştirilmemelidir; yeni değişiklikler yeni dosyalarla eklenmelidir.

Son kurala uymamak, farklı veritabanı sürümleri arasında ciddi uyumsuzluklara yol açar.

İzlenebilirlik İçin Kayıt Tablosu

user_version sadece o anki sürümü söyler. Geçmişteki işlemleri takip etmek için ayrı bir kayıt tablosu kullanabilirsiniz:

SQL:
CREATE TABLE schema_migrations (
    version    INTEGER PRIMARY KEY,
    name       TEXT NOT NULL,
    applied_at TEXT NOT NULL DEFAULT (datetime('now'))
);

BEGIN;

CREATE TABLE posts (
    id     INTEGER PRIMARY KEY,
    title  TEXT NOT NULL,
    body   TEXT NOT NULL
);

INSERT INTO schema_migrations (version, name)
    VALUES (1, 'create_posts');
PRAGMA user_version = 1;

COMMIT;

SELECT * FROM schema_migrations;

Bu tablo, hangi migration dosyasının ne zaman çalıştırıldığını tutarak hata ayıklama süreçlerinde büyük kolaylık sağlar.

Geri Alma (Rollback) İşlemleri

Transaction'lar sayesinde başarısız olan migration işlemleri veritabanını bozmaz, ROLLBACK ile işlem öncesi duruma dönülür.

SQL:
BEGIN;

CREATE TABLE accounts (id INTEGER PRIMARY KEY, balance INTEGER NOT NULL);
INSERT INTO accounts (id, balance) VALUES (1, 100);

-- Burada bir şeyin yanlış gittiğini varsayalım:
ROLLBACK;

-- Tablo mevcut değil:
SELECT name FROM sqlite_master WHERE type='table' AND name='accounts';

Ancak başarıyla tamamlanmış bir işlemi geri almak için "down-migration" denilen, tam tersi işlemleri yapan betikler yazmanız gerekir. SQLite'ın bu konuda otomatik bir aracı yoktur. Birçok geliştirici bu riski, düzenli yedekler alarak yönetmeyi tercih eder.

En İyi Uygulamalar

• Her bir mantıksal değişiklik için tek bir migration dosyası oluşturun.
• Değişiklikleri mutlaka canlı ortamın bir kopyasında önceden test edin.
• Yayınlanmış betikleri hiçbir zaman güncellemeyin.
• Mutlaka yedek alın.
• Tablo yapısını baştan oluştururken PRAGMA foreign_keys durumuna dikkat edin.

Büyük ölçekli projelerde tekrarı önlemek ve süreci otomatize etmek için SQLAlchemy (Alembic), Knex veya Flyway gibi profesyonel araçlardan faydalanabilirsiniz. Bu araçların temel çalışma mantığı da yukarıdaki döngüyle aynıdır.

Sırada: WAL Modu ve Eşzamanlılık

Migration işlemleri genellikle tekil erişim gerektirir, ancak uygulama genelinde çoklu bağlantı yönetimi farklı bir konudur. Bir sonraki bölümde, SQLite performansını ve eşzamanlılığı artıran WAL modunu inceleyeceğiz.
 

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

Geri
Üst