Database Migrations

-- İYİ: Nullable sütun, kilit yokALTER TABLE users ADD COLUMN avatar_url TEXT;
-- İYİ: Varsayılanlı sütun (Postgres 11+ anlık, yeniden yazma yok)ALTER TABLE users ADD COLUMN is_active BOOLEAN NOT NULL DEFAULT true;
-- KÖTÜ: Mevcut tabloda varsayılansız NOT NULL (tam yeniden yazma gerektirir)ALTER TABLE users ADD COLUMN role TEXT NOT NULL;-- Bu tabloyu kilitler ve her satırı yeniden yazar

-- KÖTÜ: Büyük tablolarda yazmaları engellerCREATE INDEX idx_users_email ON users (email);
-- İYİ: Engellemez, concurrent yazmalara izin verirCREATE INDEX CONCURRENTLY idx_users_email ON users (email);
-- Not: CONCURRENTLY transaction bloğu içinde çalıştırılamaz-- Çoğu migration aracı bunun için özel işleme ihtiyaç duyar

-- Adım 1: Yeni sütun ekle (migration 001)ALTER TABLE users ADD COLUMN display_name TEXT;
-- Adım 2: Veriyi backfill et (migration 002, veri migration'ı)UPDATE users SET display_name = username WHERE display_name IS NULL;
-- Adım 3: Uygulama kodunu her iki sütunu okuma/yazma için güncelle-- Uygulama değişikliklerini deploy et
-- Adım 4: Eski sütuna yazmayı durdur, kaldır (migration 003)ALTER TABLE users DROP COLUMN username;

-- Adım 1: Sütuna tüm uygulama referanslarını kaldır-- Adım 2: Sütun referansı olmadan uygulamayı deploy et-- Adım 3: Sonraki migration'da sütunu kaldırALTER TABLE orders DROP COLUMN legacy_status;
-- Django için: SeparateDatabaseAndState kullanarak modelden kaldır-- DROP COLUMN oluşturmadan (sonra sonraki migration'da kaldır)

-- KÖTÜ: Tüm satırları tek transaction'da günceller (tabloyu kilitler)UPDATE users SET normalized_email = LOWER(email);
-- İYİ: İlerleme ile batch güncellemeDO $$DECLARE  batch_size INT := 10000;  rows_updated INT;BEGIN  LOOP    UPDATE users    SET normalized_email = LOWER(email)    WHERE id IN (      SELECT id FROM users      WHERE normalized_email IS NULL      LIMIT batch_size      FOR UPDATE SKIP LOCKED    );    GET DIAGNOSTICS rows_updated = ROW_COUNT;    RAISE NOTICE 'Updated % rows', rows_updated;    EXIT WHEN rows_updated = 0;    COMMIT;  END LOOP;END $$;

-- migrations/20240115_add_email_index/migration.sql-- Prisma CONCURRENTLY oluşturamaz, bu yüzden manuel yazıyoruzCREATE INDEX CONCURRENTLY IF NOT EXISTS idx_users_email ON users (email);

-- migrations/000003_add_user_avatar.up.sqlALTER TABLE users ADD COLUMN avatar_url TEXT;CREATE INDEX CONCURRENTLY idx_users_avatar ON users (avatar_url) WHERE avatar_url IS NOT NULL;
-- migrations/000003_add_user_avatar.down.sqlDROP INDEX IF EXISTS idx_users_avatar;ALTER TABLE users DROP COLUMN IF EXISTS avatar_url;