# PostgreSQL 19 Upgrade Kontrol Listesi (9 Fazlık DBA Rehberi) > **Kaynak:** [PostgreSQL 19 Resmi Sürüm Notları ("Migration to Version 19")](https://www.postgresql.org/docs/19/release-19.html) > **Sürüm:** PostgreSQL 19.0 GA (19 Kasım 2026) · **Teknik İnceleme Tarihi:** 20 Kasım 2026 > **İlgili Makale:** [dbaguide.com/versions/postgresql-19](https://dbaguide.com/versions/postgresql-19) --- ## Proje & Küme Bilgileri | Parametre | Değer | |---|---| | Sistem / Küme Adı | | | Mevcut PostgreSQL Sürümü | | | Hedef PostgreSQL Sürümü | 19.0 (veya güncel 19.x) | | Geçiş Yöntemi | [ ] pg_upgrade [ ] Mantıksal Replikasyon [ ] pg_dumpall | | Planlanan Geçiş Tarihi | | | Sorumlu DBA / Platform Mühendisi | | **Öncelik Seviyeleri:** 🔴 **Kritik (Blocker):** Geçişi durdurur veya veri tutarsızlığına yol açar. 🟠 **Yüksek:** Davranış, performans veya bellek boyutlandırma değişikliği. 🟢 **Orta:** Operasyonel gözden geçirme ve izleme uyarlaması. --- ## Faz 0: Karar, Destek Durumu ve Zamanlama - [ ] 🔴 **Mevcut sürümün EOL desteği kontrol edildi:** - PostgreSQL 14 ve öncesi: Topluluk desteği **12 Kasım 2026'da sona erdi**. Desteksiz sürümden çıkış acil risk maddesidir. - PostgreSQL 15: Destek 11 Kasım 2027'de sona erecek (~1 yıl kaldı). - PostgreSQL 16–18: Destek devam ediyor. Karar, 19'daki özellik ihtiyacına (REPACK, plan advice, WAIT FOR LSN) ve staging ölçümlerine bağlanmalıdır. - [ ] 🟠 **Minor sürüm politikası belirlendi:** "19.1 veya 19.2'yi bekleme" kuralı sabit dogmatik bir tavsiye değildir; mevcut sürümün destek durumuna, harici eklenti uyumuna ve staging provasında ölçülen stabiliteye göre esnetilebilir. - [ ] 🟠 **Yönetilen bulut sağlayıcı (Managed Cloud) desteği doğrulandı:** AWS RDS, Azure Database for PostgreSQL veya GCP Cloud SQL kullanılıyorsa sağlayıcının 19.0 desteği ve eklenti paketleri resmi duyurulardan teyit edildi. - [ ] 🟢 **Bakım penceresi ve paydaş onayı alındı:** SLA gereksinimlerine göre `pg_upgrade --link` (hızlı, kısa kesinti) veya mantıksal replikasyon (sıfıra yakın kesinti) yöntemi seçildi. --- ## Faz 1: Envanter ve Bağımlılık Taraması - [ ] 🔴 **Kurulu eklentiler listelendi ve 19 uyumluluğu doğrulandı:** ```sql SELECT extname, extversion FROM pg_extension; ``` *Not: C ile yazılmış harici eklentiler (ör. PostGIS, TimescaleDB, pg_stat_statements) PostgreSQL 19 için derlenmiş binary paketlerine ihtiyaç duyar (`IndexAmRoutine` ve C11 değişiklikleri nedeniyle).* - [ ] 🟠 **Varsayılandan farklı yapılandırma parametreleri çıkarıldı:** ```sql SELECT name, setting, source FROM pg_settings WHERE source NOT IN ('default', 'override'); ``` - [ ] 🟠 **Veritabanı encoding, locale provider ve LC_CTYPE bilgileri kaydedildi:** ```sql SELECT datname, pg_encoding_to_char(encoding), datlocprovider, datctype FROM pg_database; ``` - [ ] 🟠 **Full text search (FTS), pg_trgm ve fuzzystrmatch kullanan indeksler envanterlendi.** - [ ] 🟢 **İstemci sürücüleri, ORM ve havuzlayıcılar (connection pooler) test edildi:** PgBouncer, pgpool-II, Go pgx, JDBC, Npgsql sürücülerinin 19 ile uyumluluğu kontrol edildi. --- ## Faz 2: pg_upgrade Blocker Maddeleri & btree_gist Düzeltmesi 🔴 - [ ] 🔴 **`btree_gist` inet/cidr indeksleri tespit edildi ve kontrollü olarak çözüldü:** PostgreSQL 19 `pg_upgrade`, inet/cidr veri tipleri üzerinde `btree_gist` indeksi bulunan cluster'ları **kesinlikle yükseltmez ve durdurur**. ```sql -- Etkilenen indeksleri ve varsa EXCLUDE/UNIQUE kısıtlarını tespit et: 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') ); ``` *Uygulama Adımı:* Tanımları ve kısıtları kaydedin. Geçiş provası öncesinde kısıtı veya indeksi kontrollü kaldırın (`DROP INDEX` / `ALTER TABLE DROP CONSTRAINT`). Bağımlılıkları kontrol etmeden asla toplu `CASCADE` çalıştırmayın. Hedefte güncel GiST opclass ile yeniden oluşturun. - [ ] 🔴 **Veritabanı, rol veya tablespace adlarında CR/LF satır sonu karakteri olmadığı doğrulandı:** `pg_upgrade` bu tür nesneleri doğrudan reddeder. - [ ] 🔴 **`MULE_INTERNAL` encoding kullanan veritabanı bulunmadığı doğrulandı:** Bu encoding 19'da tamamen kaldırılmıştır (başka bir encoding ile dump/restore gerektirir). - [ ] 🔴 **RADIUS kimlik doğrulaması kaldırıldı:** PostgreSQL 19 RADIUS desteğini sonlandırdı. `pg_hba.conf` içinde SCRAM-SHA-256, LDAP veya TLS sertifika doğrulamasına geçildi. - [ ] 🔴 **`pg_upgrade --check` testi sıfır hata ile tamamlandı:** ```bash 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 Parametre Değişiklikleri 🟠 - [ ] 🟠 **`io_workers` parametresi kaldırıldı:** Yapılandırmada varsa `io_min_workers` ve `io_max_workers` ile değiştirildi (`io_worker_idle_timeout` ve `io_worker_launch_interval` ayarlandı). - [ ] 🟠 **`max_locks_per_transaction` yeniden boyutlandırıldı:** Varsayılan 64'ten 128'e yükseltildi. Kilit bellek tahsis mimarisi değiştiği için, özel bir değer kullanıyorsanız önceki kilit kapasitesini korumak adına **mevcut ayarınızı 2 katına çıkarın**. - [ ] 🟠 **JIT (Just-In-Time) varsayılan olarak KAPALI:** Analitik sorgularınız varsa staging ortamında `SET jit = on` ve `off` sürelerini ölçün; yalnızca somut fayda görülen ortamlarda açık tutun. - [ ] 🟠 **`log_lock_waits` artık varsayılan olarak AÇIK:** Log hacmi ve disk doluluk alarmlarını gözden geçirin. - [ ] 🟠 **`default_toast_compression` = `lz4` (LZ4 derlemelerinde):** Yeni yazılan büyük metin ve JSON verileri LZ4 ile sıkıştırılır. - [ ] 🟢 **`escape_string_warning` kaldırıldı:** `standard_conforming_strings` artık daima açıktır. --- ## Faz 4: Veri, İndeks, FTS ve Stemmer Uyumluluğu 🟠 - [ ] 🟠 **Full Text Search (FTS) ve `pg_trgm` İndeksleri:** PostgreSQL 19 karakter sınıflandırmasında veritabanının locale provider'ını (ICU/Builtin) esas alır. `LC_CTYPE` ayarı farklı olan sistemlerde geçiş sonrası: 1. İlgili GIN/GiST indekslerini yeniden oluşturun (`REINDEX INDEX ...`). 2. Tablolarda saklanan `tsvector` sütunlarını `UPDATE` ile yeniden hesaplayın. - [ ] 🟠 **Türkçe ve Çok Dilli Stemmer Güncellemeleri:** Türkçe, İngilizce, Almanca, Fransızca ve İspanyolca stemmer'ları güncellendi; bazı kelimeler için farklı kök üretilmektedir. Hollandaca algoritması tamamen değişti. Türkçe FTS kullanan uygulamalarda arama sorgu sonuçlarını test edin ve ilgili indeksleri `REINDEX` yapın. - [ ] 🟠 **`fuzzystrmatch` indeksleri:** `soundex`, `metaphone` ve `dmetaphone` fonksiyonlarına dayanan indeksler ASCII dışı karakter davranışı değiştiği için `REINDEX` edilmelidir. --- ## Faz 5: Uygulama Davranışı ve Mantıksal Replikasyon 🟠 - [ ] 🟠 **`json_array()` boş küme davranışı:** Satır dönmeyen bir alt sorgu ile çağrılan `json_array()` artık `NULL` yerine boş JSON dizisi (`[]`) döndürür. Uygulama kodundaki `IS NULL` kontrolleri gözden geçirildi. - [ ] 🟠 **`postgres_fdw` oturumları:** Artık yerel transaction'ın `READ ONLY` ve `DEFERRABLE` durumunu devralır. Salt okunur transaction içinde uzak tabloya yazma hatası oluşmayacağı teyit edildi. - [ ] 🟠 **18 → 19 Mantıksal Replikasyon Geçişinde Sequence Senkronizasyonu:** Mantıksal replikasyonda sequence'ler anlık `nextval()` çağrısıyla sürekli akıtılmaz. `ALTER SUBSCRIPTION ... REFRESH SEQUENCES` yayıncının da PG 19 olmasını gerektirir. *18'den 19'a geçiş kesinti prosedürü:* 1. Kaynakta (PG 18) yazma trafiğini kesin (read-only mode). 2. Replikasyon slotunun gecikmesinin 0 bayt olduğunu doğrulayın. 3. Kaynaktaki tüm sequence değerlerini (`last_value`, `is_called`) okuyup hedefte (PG 19) `setval()` ile eşitleyin. 4. Hedefte sequence tutarlılığını doğruladıktan sonra canlı trafiği açın. - [ ] 🟢 **Restart'sız Mantıksal Replikasyon:** Sunucunun zaten `wal_level = replica` modunda çalıştığı doğrulandı. --- ## Faz 6: Gözlemlenebilirlik, Wait Events ve Monitoring 🟢 - [ ] 🟠 **Wait Event adları güncellendi:** - `BUFFERPIN` → `BUFFER` - `BufferPin` → `BufferCleanup` - `BufferContent` kaldırıldı; yerine `BufferShared`, `BufferShareExclusive`, `BufferExclusive` geldi. - Prometheus, Datadog veya pg_stat_activity izleme panoları ve alarmları güncellendi. - [ ] 🟠 **`sync_error_count` sütun adı:** `pg_stat_subscription_stats` tablosundaki `sync_error_count` sütunu `sync_table_error_count` olarak güncellendi. - [ ] 🟢 **Yeni istatistik görünümleri entegre edildi:** `pg_stat_lock`, `pg_stat_recovery`, `pg_stat_autovacuum_scores`, `pg_stat_progress_repack`. - [ ] 🟢 **Wraparound alarm eşikleri:** Transaction ID wraparound uyarıları 40 milyondan 100 milyon kala başlatıldığı için alarm tetikleyicileri güncellendi. --- ## Faz 7: Staging Provası ve Yük Testi - [ ] 🔴 **Maskelenmiş üretim verisiyle uçtan uca yükseltme provası yapıldı:** Kesinti süresi ve disk alanı ölçüldü. - [ ] 🟠 **Kritik sorguların `EXPLAIN (ANALYZE, BUFFERS)` planları karşılaştırıldı:** Plan regresyonu tespit edilen sorgular için `pg_plan_advice` veya istatistik müdahalesi planlandı. - [ ] 🟠 **Paralel VACUUM süreleri ölçüldü:** Lider ve worker'lar maliyet gecikme limitini (cost delay) paylaştığı için paralel vacuum sürelerindeki değişim izlendi. - [ ] 🔴 **Geri dönüş (Rollback) senaryosu test edildi:** `pg_upgrade --link` kullanıldığında eski veri dizini bozulabileceğinden yedekleme ve snapshot geri alma provası tamamlandı. --- ## Faz 8: Geçiş Günü (Cutover Window) - [ ] 🔴 **Doğrulanmış tam yedek (Cold / Hot Backup + WAL) alındı ve restore edilebilirliği kanıtlandı.** - [ ] 🔴 **Geri dönüş (Rollback) adımları yazıldı ve nöbetçi ekibe dağıtıldı.** - [ ] 🔴 **Uygulama trafiği bakım moduna alındı ve tüm aktif oturumlar sonlandırıldı:** ```sql SELECT pg_terminate_backend(pid) FROM pg_stat_activity WHERE pid <> pg_backend_pid(); ``` - [ ] 🔴 **Yükseltme komutu çalıştırıldı (`pg_upgrade --link`):** - [ ] 🔴 **Faz 4 kapsamındaki REINDEX ve `tsvector` güncelleme scriptleri çalıştırıldı.** - [ ] 🔴 **Optimizer istatistikleri toplandı:** ```bash /usr/lib/postgresql/19/bin/vacuumdb --all --analyze-in-stages ``` - [ ] 🟢 **Uygulama duman testleri (smoke tests) başarıyla geçti.** - [ ] 🟢 **Canlı trafik açıldı ve replikasyon akışı başlatıldı.** --- ## Faz 9: Geçiş Sonrası İlk 2 Hafta & Kademeli Özellik Açılışı - [ ] 🟠 **Hata logları, kilit beklemeleri (`log_lock_waits`) ve replika gecikmeleri 7/24 izlendi.** - [ ] 🟠 **Autovacuum ilerleme ve puanlama durumları takip edildi (`pg_stat_autovacuum_scores`).** - [ ] 🔴 **Yeni PostgreSQL 19 özellikleri tek tek ve ayrı bakım pencerelerinde devreye alındı:** - [ ] `REPACK (CONCURRENTLY)`: Önce staging ortamında disk ve WAL etkisi ölçülerek denendi; canlıda Primary Key'e sahip şişkin tablolarda `lock_timeout` tanımlanarak uygulandı. - [ ] `pg_plan_advice` / `pg_stash_advice`: Yalnızca plan regresyonu yaşayan sorgularda taktiksel olarak devreye alındı. - [ ] `WAIT FOR LSN`: Uygulama katmanında `MODE 'standby_replay'`, sonlu `TIMEOUT` ve primary fallback mekanizması kodlandıktan sonra açıldı. --- ## Yetkili Onay Formu | Rol | Yetkili Adı | Onay Tarihi | İmza / Durum | |---|---|---|---| | Kıdemli DBA | | | [ ] ONAYLANDI | | Platform / SRE Lideri | | | [ ] ONAYLANDI | | Baş Yazılım Mimarı / CTO | | | [ ] ONAYLANDI |