dataiotech Labs
Home/Kontrol Listeleri/postgresql-19-upgrade-checklist
9 Faz · PostgreSQL 19 Upgrade Kontrol Listesi
10 dk operasyon

PostgreSQL 19 Upgrade Kontrol Listesi: 9 Fazlık DBA Geçiş Rehberi

pg_upgrade Blocker Maddeleri, btree_gist Düzeltmesi, JIT Değerlendirmesi, Sequence Senkronizasyonu ve Geri Dönüş Güvencesi

Tatbikat / Kontrol İlerlemesi: 0 / 24
%0
Faz 0: Karar ve ZamanlamaCRITICAL

1. Mevcut PostgreSQL Sürümünün Destek (EOL) Durumu Doğrulandı mı?

PostgreSQL 14 desteği 12 Kasım 2026'da bitti; PG 14 ve öncesi için upgrade acil güvenlik/risk maddesidir. PG 15 desteği Kasım 2027'de bitecek; PG 16-18 için karar eklenti ve staging provasına dayanmalıdır.

SELECT version();
-- https://www.postgresql.org/support/versioning/
Faz 0: Karar ve ZamanlamaHIGH

2. Minor Sürüm Takvimi ve Managed Servis Sağlayıcı Desteği İncelendi mi?

19.1 veya 19.2'yi bekleme kararı sabit bir kural değildir; kaynak sürümün EOL durumuna, AWS RDS/GCP Cloud SQL desteğine ve staging provasında ölçülen stabiliteye göre belirlenmelidir.

Faz 1: Envanter & BağımlılıklarCRITICAL

3. Kurulu Tüm Eklentilerin PostgreSQL 19 Uyumlu Sürümleri Doğrulandı mı?

PostgreSQL 19 C11 ve IndexAmRoutine değişiklikleri getirdiğinden, C ile yazılmış harici eklentilerin (PostGIS, TimescaleDB, pg_stat_statements vb.) 19 derlemeleri temin edilmelidir.

SELECT extname, extversion FROM pg_extension;
Faz 1: Envanter & BağımlılıklarHIGH

4. Veritabanı Encoding, Locale Provider ve LC_CTYPE Ayarları Kaydedildi mi?

PostgreSQL 19'da FTS ve pg_trgm karakter sınıflandırması veritabanı locale provider'ına devredildi. Mevcut sağlayıcı ve CTYPE bilgisi kaydedilmelidir.

SELECT datname, pg_encoding_to_char(encoding), datlocprovider, datctype FROM pg_database;
Faz 2: pg_upgrade Blocker MaddeleriCRITICAL

5. btree_gist inet/cidr İndeksleri Tespit Edilip Bağımlılıklarıyla Çözüldü mü?

PostgreSQL 19 pg_upgrade, inet/cidr üzerindeki btree_gist indekslerini kesin olarak engeller. Tanımlar ve kısıtlar kaydedilmeli, geçiş öncesi kontrollü kaldırılıp hedefte GiST ile yeniden oluşturulmalıdır.

SELECT c.relname AS index_name, t.relname AS table_name, con.conname AS constraint_name, pg_get_indexdef(c.oid) AS index_def
FROM pg_index x
JOIN pg_class c ON c.oid = x.indexrelid
JOIN pg_class t ON t.oid = x.indrelid
JOIN pg_am am ON am.oid = c.relam
LEFT JOIN pg_constraint con ON con.conindid = c.oid
WHERE am.amname = 'gist' AND EXISTS (
  SELECT 1 FROM pg_attribute a JOIN pg_type ty ON ty.oid = a.atttypid
  WHERE a.attrelid = c.oid AND ty.typname IN ('inet', 'cidr')
);
Faz 2: pg_upgrade Blocker MaddeleriCRITICAL

6. Veritabanı, Rol ve Tablespace Adlarında Satır Sonu (CR/LF) Olmadığı Teyit Edildi mi?

PostgreSQL 19 nesne adlarında kontrol karakterlerini yasaklar. pg_upgrade bu tür tanımları reddeder.

SELECT datname FROM pg_database WHERE datname ~ '[\r\n]';
SELECT rolname FROM pg_roles WHERE rolname ~ '[\r\n]';
Faz 2: pg_upgrade Blocker MaddeleriCRITICAL

7. Kaldırılan RADIUS ve MULE_INTERNAL Kullanımları Temizlendi mi?

PostgreSQL 19 RADIUS desteğini ve MULE_INTERNAL encoding'ini tamamen kaldırmıştır. pg_hba.conf SCRAM-SHA-256 veya LDAP/TLS'e taşınmalıdır.

Faz 2: pg_upgrade Blocker MaddeleriCRITICAL

8. pg_upgrade --check Simülasyonu Sıfır Hata ile Başarıyla Tamamlandı mı?

Kümeler üzerinde hiçbir veri değişikliği yapmadan binary ve katalog uyumluluğunu doğrulayan resmi ön kontrol.

pg_upgrade --old-datadir=/var/lib/postgresql/18/data --new-datadir=/var/lib/postgresql/19/data --old-bindir=/usr/lib/postgresql/18/bin --new-bindir=/usr/lib/postgresql/19/bin --check
Faz 3: Yapılandırma ve ParametrelerHIGH

9. Kaldırılan io_workers Parametresi io_min/max_workers ile Değiştirildi mi?

PostgreSQL 18'deki statik io_workers kaldırıldı. Otomatik ölçekleme için io_min_workers ve io_max_workers yapılandırılmalıdır.

# postgresql.conf
io_min_workers = 4
io_max_workers = 16
io_worker_idle_timeout = 60s
Faz 3: Yapılandırma ve ParametrelerHIGH

10. max_locks_per_transaction Özel Ayarı 2 Katına Çıkarıldı mı?

Varsayılan değer 64'ten 128'e yükseltildi. Kilit bellek tahsis mimarisi değiştiğinden, eski kapasiteyi korumak için özel ayarlar 2 katına çıkarılmalıdır.

# postgresql.conf (Örn. eski değer 256 ise):
max_locks_per_transaction = 512
Faz 3: Yapılandırma ve ParametrelerHIGH

11. JIT (Just-In-Time) Varsayılanı Kapalı; Analitik İş Yüklerinde Karar Verildi mi?

Maliyet tahminlerindeki sapmalar nedeniyle JIT varsayılan olarak kapalıdır (jit = off). Analitik yüklerde staging ortamında ölçülmeden açılmamalıdır.

SHOW jit;
-- Staging testi: SET jit = on; EXPLAIN (ANALYZE, BUFFERS) <query>;
Faz 3: Yapılandırma ve ParametrelerMEDIUM

12. log_lock_waits Varsayılan Olarak Açık; Disk ve Log Hacmi Değerlendirildi mi?

İşlemler deadlock_timeout süresince kilit beklediğinde log üretilir. Yüksek eşzamanlı sistemlerde log hacmi değerlendirilmelidir.

SHOW log_lock_waits;
SHOW deadlock_timeout;
Faz 4: Veri, İndeks ve FTS UyumluluğuHIGH

13. Full Text Search ve pg_trgm İndeksleri Yeniden Oluşturulacak mı (REINDEX)?

Locale provider mimarisi değiştiği için ICU veya builtin provider kullanan veritabanlarında FTS GIN indeksleri ve tsvector değerleri yenilenmelidir.

REINDEX INDEX CONCURRENTLY idx_articles_fts_gin;
Faz 4: Veri, İndeks ve FTS UyumluluğuHIGH

14. Türkçe ve Çok Dilli Stemmer Değişimi: Saklanan tsvector Sütunları Yenilendi mi?

Türkçe, İngilizce, Almanca ve diğer dillerin stemmer algoritmaları güncellendi. Tablolarda saklanan tsvector sütunları UPDATE ile yeniden hesaplanmalıdır.

UPDATE articles SET fts_vector = to_tsvector('turkish', coalesce(title, '') || ' ' || coalesce(body, ''));
Faz 5: Uygulama Davranışı & ReplikasyonHIGH

15. json_array() Boş Kümede Artık [] Döndürüyor; IS NULL Kontrolleri Gözden Geçirildi mi?

Eski sürümlerde alt sorgu satır üretmediğinde NULL dönerken, PostgreSQL 19'da standart gereği boş dizi ([]) döner. Kod assertions kontrol edilmelidir.

SELECT json_array((SELECT 1 WHERE false)); -- Returns [] in PG 19 (was NULL)
Faz 5: Uygulama Davranışı & ReplikasyonHIGH

16. postgres_fdw Oturumları READ ONLY Durumunu Devralıyor mu?

Yerel transaction READ ONLY olduğunda uzak sunucudaki oturum da READ ONLY kabul edilir; uzak tabloya yazma girişimleri hata verir.

Faz 5: Uygulama Davranışı & ReplikasyonCRITICAL

17. 18 → 19 Mantıksal Replikasyon Geçişinde Sequence Sayaç Eşitleme Planlandı mı?

Mantıksal replikasyon anlık nextval akıtmaz. 18'den 19'a geçerken kaynakta yazma durdurulmalı, lag sıfırlanmalı ve sequence değerleri setval ile eşitlenmelidir.

-- Kaynakta: SELECT last_value, is_called FROM order_id_seq;
-- Hedefte: SELECT setval('order_id_seq', <last_value>, <is_called>);
Faz 6: İzleme, Telemetri & AlarmlarMEDIUM

18. Yeniden Adlandırılan Wait Event ve Metrik İsimleri Monitoring Sistemine Yansıtıldı mı?

BUFFERPIN -> BUFFER, BufferPin -> BufferCleanup ve sync_error_count -> sync_table_error_count oldu. Grafana/Prometheus metrik sorguları güncellenmelidir.

SELECT wait_event_type, wait_event, count(*) FROM pg_stat_activity GROUP BY 1, 2;
Faz 6: İzleme, Telemetri & AlarmlarMEDIUM

19. Transaction ID Wraparound Uyarı Eşiği 100 Milyon Seviyesine Uyarlandı mı?

PostgreSQL 19'da wraparound log uyarıları 40 milyon yerine 100 milyon transaction kala başlar. DBA alarm eşikleri buna göre ayarlanmalıdır.

SELECT datname, age(datfrozenxid), 2147483648 - age(datfrozenxid) AS remaining_xids FROM pg_database;
Faz 7: Staging Provası & BenchmarkCRITICAL

20. Maskelenmiş Canlı Veri Kopyasıyla Uçtan Uca Yükseltme Provası Yapıldı mı?

Staging kümesinde pg_upgrade --link süresi, disk kullanımı ve rollback senaryoları gerçekçi veri hacmiyle test edilmelidir.

Faz 8: Geçiş Penceresi & Canlıya AlmaCRITICAL

21. Geçiş Öncesi Doğrulanmış Tam Yedek Alındı ve Geri Dönüş (Rollback) Hazır mı?

pg_upgrade --link eski küme dosyalarını bağladığı için geri dönüşte eski veri dizinine dönülemez; snapshot veya bağımsız yedek zorunludur.

pgbackrest --stanza=db-prod --type=full backup
Faz 8: Geçiş Penceresi & Canlıya AlmaCRITICAL

22. Yükseltme Sonrası vacuumdb --analyze-in-stages ile İstatistikler Toplandı mı?

pg_upgrade sonrası planlayıcı istatistikleri boş gelir. Sorguların yavaşlamaması için ilk trafik öncesi kademeli analiz çalıştırılmalıdır.

/usr/lib/postgresql/19/bin/vacuumdb --all --analyze-in-stages
Faz 9: Geçiş Sonrası & Özellik AçılışıHIGH

23. REPACK (CONCURRENTLY) Tabloların Primary Key Şartı ve lock_timeout ile Test Edildi mi?

Yalnızca Primary Key / Replica Identity olan tablolarda çalıştırılmalıdır. Son aşamadaki dosya takası (swap) kısa süreli ACCESS EXCLUSIVE kilit alır; 2 kat boş disk alanı ve lock_timeout şarttır.

SET lock_timeout = '5s';
REPACK (CONCURRENTLY) orders;
SELECT * FROM pg_stat_progress_repack;
Faz 9: Geçiş Sonrası & Özellik AçılışıHIGH

24. WAIT FOR LSN: Uygulamada MODE standby_replay, Sonlu TIMEOUT ve Fallback Kodlandı mı?

Standby gecikirse sorgu asılı kalmamalıdır. Sonlu TIMEOUT tanımlanmalı; zaman aşımında primary sunucuya fallback veya kontrollü hata yönetimi sağlanmalıdır.

-- Standby session:
WAIT FOR LSN '0/3B19A40' MODE 'standby_replay' TIMEOUT '5000ms';
SELECT * FROM user_orders WHERE user_id = 101;