Liquibase — Bir Satırı Düzelttim, Uygulama Neden Açılmadı?

Resmî bir defterde her satır yazıldığı gün mühürlenir. Eski bir satırı silip yeniden yazarsan mühür tutmaz. Denetçi defteri açar ve “burada bir şey değişmiş” der.

Her changeset bir kez çalışır

Liquibase şema değişikliklerini bir changelog?Terimin tanımını açchangelogLiquibase'in şema değişikliklerini sırayla tuttuğu dosya. Her değişiklik bir changeset'tir ve bir kez çalışır.Sözlükte gör → dosyasında sırayla tutar. Her değişiklik bir changeset’tir ve kimliği; id, yazar ve dosya yolundan oluşur.

Uygulama açılırken Liquibase hangi changeset’lerin çalıştığına DATABASECHANGELOG tablosundan bakar. Yalnızca çalışmamış olanları sırayla uygular.

Uygulanmış olan değişmez

Liquibase her changeset’i uyguladığında bir checksum?Terimin tanımını açchecksumBir içerikten hesaplanan kısa özet. İçerik değişirse özet de değişir; Liquibase uygulanmış changeset'lerin değişip değişmediğini böyle anlar.Sözlükte gör → da kaydeder. Sonraki her açılışta dosyadaki changeset’lerin checksum’ını yeniden hesaplayıp karşılaştırır.

Doğru yol, değişikliği yeni bir changeset olarak eklemektir: “bakiye sütununu genişlet”. Eski changeset’e dokunulmaz; production ve yeni kurulan ortamlar aynı yolu yürür.

Kilidi kim tutuyor?

İki uygulama aynı anda migration yapmasın diye Liquibase önce bir kilit?Terimin tanımını açchangelog kilidiİki uygulamanın aynı anda migration yapmasını önleyen, DATABASECHANGELOGLOCK tablosundaki tek satır. Ölen bir deploy onu bırakmayabilir.Sözlükte gör → alır ve iş bitince bırakır. Kilit, DATABASECHANGELOGLOCK tablosundaki tek bir satırdır.

Migration ortasında öldürülen bir pod kilidi bırakamaz. Sonraki her açılış o kilidi bekler ve bir süre sonra vazgeçer. Kilit release-locks ile bırakılır; ama önce gerçekten çalışan bir migration olmadığından emin olunur.

Kendin gör

1. Varsayılanla oynat. Changeset 2 düzenlendi: kilit alındı, doğrulama başarısız, uygulama açılmadı.
2. Değişikliği “yeni changeset 4” yap. Doğrulama geçti, changeset 4 uygulandı, uygulama açıldı.
3. “Önceki deploy kilitte öldü”yü aç. Uygulama ilk adımda takıldı. Sonra “release-locks”u aç: açıldı.

Tuzaklar

Dosyayı taşımak. Changeset’in kimliğinde dosya yolu da olduğu için, dosyayı taşımak bütün changeset’leri yeni gibi gösterebilir. logicalFilePath ile yolu sabitle.

validCheckSum ile susturmak. Checksum hatasını validCheckSum ile kabul ettirmek mümkündür. Bunu yalnızca değişikliğin veritabanını etkilemediğinden eminsen, örneğin bir yorum düzeltmesinde yap.

Ortamlar arası fark. Test ortamı her seferinde sıfırdan kuruluyorsa, düzenlenmiş changeset orada sorun çıkarmaz. Production’a benzeyen, eski şemadan güncellenen bir ortamda da dene.

Aşağıda bir bankanın hesap şeması için changelog’u var: eski changeset’lere dokunulmadan yeni bir changeset eklenmiş.

1
databaseChangeLog:
2
  - include:
3
      file: db/changelog/2026/001-accounts.yaml
4
  - include:
5
      file: db/changelog/2026/002-widen-balance.yaml

1
databaseChangeLog:
2
  - logicalFilePath: accounts/001-accounts.yaml   # identity survives a file move
3
  - changeSet:
4
      id: 001-create-accounts
5
      author: core-banking
6
      changes:
7
        - createTable:
8
            tableName: account
9
            columns:
10
              - column: { name: id, type: BIGINT, constraints: { primaryKey: true } }
11
              - column: { name: iban, type: VARCHAR(34), constraints: { nullable: false } }
12
              - column: { name: balance, type: DECIMAL(12,2), constraints: { nullable: false } }

1
databaseChangeLog:
2
  - logicalFilePath: accounts/002-widen-balance.yaml
3
  - changeSet:
4
      id: 002-widen-balance
5
      author: core-banking
6
      comment: 001 is already applied in production, so the fix is a new changeset.
7
      changes:
8
        - modifyDataType:
9
            tableName: account
10
            columnName: balance
11
            newDataType: DECIMAL(19,2)
12
      rollback:
13
        - modifyDataType:
14
            tableName: account
15
            columnName: balance
16
            newDataType: DECIMAL(12,2)

1
spring:
2
  liquibase:
3
    change-log: classpath:db/changelog/db.changelog-master.yaml

Kendini sına