Soft Delete — Silinen Hesap Gerçekten Gitti mi?

Bir kütüphane, rafından kaldırdığı kitapları çöpe atmaz; üstüne “kaldırıldı” etiketi yapıştırır. Katalog bilgisayarı etiketli kitapları göstermez. Ama rafa doğrudan bakan biri, o kitabı hâlâ orada görür.

Neden silmiyoruz?

Bankalar kapanan bir hesabın bilgisini yıllarca saklamak zorundadır; denetçi ya da mahkeme sorabilir. Satırı DELETE ile silmek bu bilgiyi geri dönülmez biçimde yok eder.

Soft delete?Terimin tanımını açsoft deleteSatırı silmek yerine deleted gibi bir alanla işaretleyip uygulamada gizlemek. Bilgi denetim için tabloda kalır.Sözlükte gör →, satırı silmek yerine deleted = true gibi bir alanla işaretlemektir. Satır tabloda kalır; uygulama onu “yokmuş gibi” davranarak gizler.

İşareti kim okur?

İşareti her sorguda elle süzmek, unutulan her sorguda silinen satırı geri getirir. Hibernate’in @SQLRestriction notası filtreyi varlığın üstüne koyar ve Hibernate’in yazdığı her sorguya kendisi ekler. Ama Hibernate’in yazmadığı bir native SQL?Terimin tanımını açnative SQLHibernate'in değil, doğrudan senin yazdığın SQL. Varlığa konan filtreler ve bazı Hibernate özellikleri ona uygulanmaz.Sözlükte gör → sorgusu bu filtreyi görmez.

Bir sorun daha var: silinen satır tabloda kaldığı için IBAN üzerindeki benzersiz indekste yer tutmaya devam eder. Çözüm, yalnızca silinmemiş satırları kapsayan bir kısmi indeks?Terimin tanımını açkısmi indeksYalnızca bir koşulu sağlayan satırları kapsayan indeks, örneğin WHERE deleted = false. Benzersizliği canlı satırlarla sınırlamak için kullanılır.Sözlükte gör →tir.

Kendin gör

1. Varsayılanla oynat. Elle yazılan filtre: kapanan hesap aktif listede göründü, yeni hesap IBAN’a takıldı, gece raporu onu saydı.
2. “@SQLRestriction” seç. Liste düzeldi; ama IBAN çakışması ve native rapor sorunu sürdü.
3. “Kısmi benzersiz indeks”i aç. IBAN yeniden kullanılabildi; geriye yalnızca native rapor kaldı.
4. “DELETE” seç. Her şey temiz görünüyor, ama denetçiye verecek bilgi kalmadı.

Tuzaklar

Native sorguları unutmak: raporlar ve toplu işler çoğu zaman native SQL yazar. Onları deleted = false koşuluyla yaz ya da yalnızca canlı satırları gösteren bir veritabanı görünümünden oku.

Benzersiz indeksi olduğu gibi bırakmak. Silinen satır aynı IBAN’ı tutmaya devam eder. Benzersizliği WHERE deleted = false ile yalnızca canlı satırlara uygula.

Kim ve ne zaman sildi bilgisini atlamak. Yalnızca deleted = true demek, denetçinin asıl sorusunu cevaplamaz. Silme zamanını ve kimin sildiğini de sakla.

Aşağıdaki örnek bir bankanın hesap tablosundan: Hibernate’in silmeyi güncellemeye çevirdiği, filtreyi kendisi eklediği ve kimin sildiğini sakladığı bir varlık.

1
@Entity
2
@SQLDelete(sql = "UPDATE account SET deleted = true, closed_at = now() WHERE id = ?")   // delete becomes an update
3
@SQLRestriction("deleted = false")   // added to entity loads and JPQL/HQL, not to native SQL
4
public class Account {
5

6
    @Id
7
    @GeneratedValue
8
    private Long id;
9

10
    private String iban;
11
    private boolean deleted;
12
    private Instant closedAt;
13
    private String closedBy;
14

15
    void markClosedBy(String operator) {
16
        this.closedBy = operator;   // who closed it: the auditor's real question
17
    }
18
}

1
@Service
2
class AccountClosing {
3

4
    private final AccountRepository accounts;
5

6
    AccountClosing(AccountRepository accounts) {
7
        this.accounts = accounts;
8
    }
9

10
    @Transactional
11
    void close(Long accountId, String operator) {
12
        Account account = accounts.findById(accountId).orElseThrow();
13
        account.markClosedBy(operator);
14
        accounts.delete(account);   // runs the @SQLDelete UPDATE; the row stays for the audit trail
15
    }
16
}

1
ALTER TABLE account ADD COLUMN deleted   boolean     NOT NULL DEFAULT false;
2
ALTER TABLE account ADD COLUMN closed_at timestamptz;
3
ALTER TABLE account ADD COLUMN closed_by varchar(64);
4

5
-- Unique only among live rows: a closed account's IBAN can be reused.
6
DROP INDEX IF EXISTS ux_account_iban;
7
CREATE UNIQUE INDEX ux_account_iban_live ON account (iban) WHERE deleted = false;

1
@Repository
2
class NightlyBalanceReport {
3

4
    private final JdbcClient jdbc;
5

6
    NightlyBalanceReport(JdbcClient jdbc) {
7
        this.jdbc = jdbc;
8
    }
9

10
    long activeAccounts() {
11
        // Native SQL: @SQLRestriction does not apply here, so the condition is written out.
12
        return jdbc.sql("SELECT count(*) FROM account WHERE deleted = false").query(Long.class).single();
13
    }
14
}

Kendini sına