dataiotech Labs
dbaguide.com · Senior DBA & SRE Diagnostic Standard v2.0
Home/Hata Kütüphanesi/POSTGRESQL/postgresql-canceling-statement-statement-timeout
PostgreSQL
PostgreSQL 14–18SEVERITY: P2 MEDIUM
8 dk okuma
ERROR: canceling statement due to statement timeout (SQLSTATE 57014)

PostgreSQL "canceling statement due to statement timeout" — Sorgu mu Yavaş, Kilit mi Bekliyor?

57014 kodunun arkasındaki dört farklı olay, pg_settings ile eşiğin kaynağını bulma ve timeout'u rol bazlı yönetme.

İnceleyen:Principal Database Reliability Architect·30 Ekim 2026

Teshis & Ayırt Etme Protokolü (Disambiguation)

Ne Zaman Görülür?

PostgreSQL 14–18 ortamında istemci ile veritabanı arasındaki bağlantı, soket veya ağ zaman aşımı durumunu ifade eder.

Ne Zaman Bu Hata DEĞİLDİR?

Sorgu optimizasyonu veya veri bozulması değildir; bağlantı ve kimlik doğrulama katmanına aittir.

Operasyonel Kanıt & Laboratuvar Doğrulaması

Gerçek veritabanı sürümlerinde test edilmiş teknik sınırlar ve güvenlik protokolü.

Laboratuvarda Doğrulandı
Test Edilen Sürümler

PostgreSQL 18.6 & 17.11 (Alpine / Docker 29.7) | Tarihsel: PostgreSQL 14.10, 15.6, 16.4

Gerekli Yetki

SUPERUSER veya pg_read_all_stats (pg_stat_statements ve pg_blocking_pids analizi için)

Risk & Etki Alanı
Mediumstatement_timeout değerini global olarak 0 (sınırsız) yapmak bağlantı havuzlarının kilitlenmesine ve sistem çöküşüne yol açar
Geri Alma (Rollback)

Timeout süresini global değil rol bazlı (web vs rapor) kademelendirme ve lock_timeout değerini statement_timeouttan kısa tutma

Beklenen Çıktı & Doğrulama Kriteri

57014 kodunun 4 farklı kaynağının (statement timeout, lock timeout, user cancel, recovery conflict) net ayrılması

Resmî Dokümantasyon Referansı

PostgreSQL Docs: Statement Timeout Configuration

Belgeyi Yeni Sekmede Aç
İlk 60 Saniye Teşhis Protokolü (Read-Only Safety Rule):

Hata mesajı bir semptomdur, kök neden değildir. Sunucuyu veya veritabanı servisini körü körüne yeniden başlatmayın! Önce aşağıdaki salt-okunur (read-only) teşhis sorgularını çalıştırarak gerçek arıza modunu tespit edin; ardından kontrollü müdahaleye geçin.

▸Belirti

plaintext
ERROR: canceling statement due to statement timeout

Aynı PostgreSQL SQLSTATE kodu olan 57014 (query_canceled) altında dört tamamen farklı olay yaşanabilir:

plaintext
ERROR: canceling statement due to statement timeout ERROR: canceling statement due to lock timeout ERROR: canceling statement due to user request ERROR: canceling statement due to conflict with recovery
ÖNEMLİ
SQLSTATE Kodunu ve Hata Mesajı Bağlamını Birlikte Değerlendirin! Yalnızca 57014 (query_canceled) kodunu görüp *"Sorgumuz yavaş çalışıyor, hemen yeni indeks ekleyelim"* demek arıza senaryolarında yanlış teşhise yol açar: - `statement timeout` (SQLSTATE 57014): Sorgu işlemci veya disk üzerinde statement_timeout eşiğini aştığında motor tarafından sonlandırılır (L4 laboratuvar kanıtı: 500ms eşiğinde 0.52s'de tetiklendi). - `user request` (SQLSTATE 57014): İptal emri harici bir istemciden veya DBA'nın pg_cancel_backend(pid) komutundan gelir (L4 laboratuvar kanıtı: "canceling statement due to user request"). - `lock timeout` Ayrımı (SQLSTATE 55P03): lock_timeout aşımı 57014 değil, 55P03 (lock_not_available) üretir ("canceling statement due to lock timeout"). Sorgu milisaniyelik olabilir; ancak başka bir oturum satırı veya tabloyu kilitlediği için bekleme sınırına takılmıştır (L3 laboratuvar kanıtı). - `conflict with recovery` (SQLSTATE 57014): Read replica üzerinde çalışan sorgunun Master'dan gelen WAL replay işlemiyle çakışması. İptal edilen bir sorgu, açık transaction bloğunu aborted durumuna düşürür; oturum explicit ROLLBACK yapana kadar sonraki tüm komutlar reddedilir. Ayrıntılı kilit grafı ve müdahale adımları için: PostgreSQL Kilitlerini Okumak: Blocking, Deadlock ve Uzun Transaction'lar ve Kilit Zinciri Kök Bloklayıcı Runbook'u.

▸Eşiğin Nereden Geldiğini Tespit Edin (`pg_settings`)

PostgreSQL'de statement_timeout ayarı beş farklı hiyerarşik katmandan gelebilir:

sql
SELECT name, setting, unit, source, sourcefile, sourceline FROM pg_settings WHERE name IN ('statement_timeout', 'lock_timeout', 'idle_in_transaction_session_timeout');

source sütunu teşhisi netleştirir:

  • •configuration file: postgresql.conf dosyasından gelen global ayar.
  • •database: ALTER DATABASE dbname SET statement_timeout = ... ile verilmiş veritabanı ayarı.
  • •user: ALTER ROLE app_user SET statement_timeout = ... ile atanmış rol düzeyi kısıtlama.
  • •client: Bağlantı havuzu (PgBouncer) veya uygulama kodu oturum açarken SET statement_timeout = ... gönderdi.
  • •default: Ayarlanmamış; PostgreSQL varsayılanı 0 (sınırsız).

▸Adım Adım Teşhis ve Çözüm Akışı

1. Yavaş Sorguyu pg_stat_statements ile Ölçün

Tahmin yürütmek yerine gerçek kaynak tüketimini sorgulayın:

sql
CREATE EXTENSION IF NOT EXISTS pg_stat_statements; SELECT queryid, calls, round(mean_exec_time::numeric, 1) AS ortalama_ms, round(total_exec_time::numeric) AS toplam_ms, left(query, 100) AS sorgu FROM pg_stat_statements ORDER BY total_exec_time DESC LIMIT 15;
  • •total_exec_time veritabanına en çok kümülatif yük getiren sorguları gösterir.
  • •mean_exec_time tek başına timeout eşiğini aşan sorguları listeler.

2. Kilit Beklemesi (Lock Wait) Kontrolü

sql
SELECT pid, now() - query_start AS suredir, wait_event_type, wait_event, cardinality(pg_blocking_pids(pid)) AS bloklayan_sayisi, pg_blocking_pids(pid) AS bloklayan_pidler, left(query, 80) AS sorgu FROM pg_stat_activity WHERE state = 'active' AND pid <> pg_backend_pid() ORDER BY suredir DESC;

Eğer wait_event_type = 'Lock' ise sorgu CPU tüketmiyor; başka bir oturumun açtığı satır/tablo kilidini bekliyor demektir.

3. Gerçek Yürütme Planını (BUFFERS Dahil) Alın

sql
EXPLAIN (ANALYZE, BUFFERS) SELECT ...;

BUFFERS ibaresi olmadan diskten okunan blok sayısını göremezsiniz; bellek (shared hit) ile disk (read) arasındaki farkı yalnızca buffers çıktısı gösterir.


▸Kalıcı Çözüm: Timeout Yönetimi Bir Politikadır

1. Global Timeout'u Sıfırlamak Büyük Bir Hatadır!

Timeout aldığında ilk yapılan hatalı refleks statement_timeout = 0 yapmaktır. Zaman aşımı eşiği bir emniyet kemeridir; onu kaldırmak yavaş sorguyu çözmez, aksine o sorgunun bağlantı havuzunu tüketip tüm siteyi çökertmesine yol açar.

2. Rol Bazlı Kademeli Zaman Aşımı Tanımlayın

Web kullanıcıları ile analitik rapor servisleri asla aynı timeout sınırına tabi olmamalıdır:

sql
-- Web API kullanıcıları için agresif sınır (5 saniye) ALTER ROLE app_web SET statement_timeout = '5s'; -- Gece çalışan raporlama kullanıcısı için geniş sınır (15 dakika) ALTER ROLE app_rapor SET statement_timeout = '15min';

3. lock_timeout Değerini statement_timeout Değerinden Kısa Tutun

sql
ALTER SYSTEM SET lock_timeout = '3s'; ALTER SYSTEM SET statement_timeout = '10s'; SELECT pg_reload_conf();

Bu sayede bir sorgu kilit yüzünden takıldığında, 10 saniye boyunca havuzu meşgul etmeden 3. saniyede canceling statement due to lock timeout hatasıyla hızla başarısız olur ve hatanın kilit kaynaklı olduğu logda açıkça belgelenir.


▸İlgili Hata Rehberleri & Hub Bağlantıları

YENİ KONSEPTMÜHENDİSLİK BECERİSİ
Senior Mülakat Hazırlığı

POSTGRESQL Bağlantı Havuzu (Connection Pooling), Ağ Zaman Aşımları ve Soket Yönetimi.

Bu hata yalnızca bir parametre eksikliği değil; veri tutarlılığı, concurrency mimarisi ve kapasite planlaması dersidir.

Öğrenme Hedefleri (Ölçülebilir Çıktılar):
  • İstemci bağlantı havuzu tükenmesi ile veritabanı listener arızasını ayırt edebilmek.
  • Ağ güvenlik duvarı ve keepalive parametrelerini production standardına getirebilmek.

Senior Mülakatında Bu Hatadan Ne Sorulur?

Q1POSTGRESQL üzerinde bağlantı kesintilerini izlerken ilk hangi işletim sistemi ve veritabanı metriğine bakılmalıdır?
Mid
Senior Mühendis / Mimar Yanıtı:

Veritabanı aktif/idle bağlantı sayıları, OS seviyesinde netstat/ss soket durumları (TIME_WAIT, CLOSE_WAIT) ve listener hata logları kontrol edilmelidir.

Q2Keepalive ayarları bağlantı kopmalarını nasıl engeller?
Senior
Senior Mühendis / Mimar Yanıtı:

Güvenlik duvarları veya load balancerlar boşta kalan TCP oturumlarını sessizce düşürür. TCP keepalive periyodik boş paket göndererek oturumun canlı kalmasını sağlar.

Q3Uygulama katmanında bağlantı sızıntısı (connection leak) nasıl tespit edilir?
Junior
Senior Mühendis / Mimar Yanıtı:

Veritabanı oturum listesinde uzun süre idle kalan bağlantılar, artan havuz kullanım oranları ve uygulama APM araçlarındaki unclosed connection uyarıları izlenir.

Kıdemli DBA & SRE Kariyer Yol Haritası

Veritabanı güvenilirliği, kriz yönetimi ve mimarlık aşamalarını keşfedin.

Yol Haritasını İncele

POSTGRESQL Hata Kütüphanesinden Diğer Başlıklar

Kriz anında başvurabileceğiniz diğer doğrulanmış teşhis rehberleri.

Tümünü Gör
dbaguide.com · PostgreSQL "canceling statement due to statement timeout" Çözümü · Kanıt Odaklı Teşhis Standardı
Son Güncelleme: 2 Kasım 2026 · Format v2.0