Geliştirme

PostgreSQL generate_series: Raporda Eksik Günleri Göstermek

Mehmet Fatih Ünal
17 Kasım 2026
7 dk okuma
#PostgreSQL#SQL#generate_series#Raporlama#LEFT JOIN
PostgreSQL generate_series: Raporda Eksik Günleri Göstermek

Bir günde kayıt yoksa grafik o günü göstermeli mi?

Etkinlik tablosunu güne göre grupladığınızda yalnızca kayıt bulunan günler döner. Haftalık grafikte boş günlerin de sıfırla görünmesini istiyorsanız önce raporun takvimini üretip kayıtları bu takvime bağlayabilirsiniz. PostgreSQL'in generate_series fonksiyonu bu amaçla kullanılabilecek satır üreticilerinden biridir.

Bu örnekte olayların günü zaten date olarak saklanıyor. Saat dilimi veya gün sonu dönüşümü yapmıyoruz. Bir timestamptz kaydının hangi iş gününe ait olduğunu ayrıca belirlemelisiniz; tarih aralıkları yazısı bu ayrımı ele alır. Fonksiyonun davranışı için PostgreSQL seri üretme belgesini temel alıyoruz.

İçinde boş günler bulunan küçük bir veri kümesi kurun

CREATE TEMP TABLE demo_events (
  id integer PRIMARY KEY,
  event_day date NOT NULL,
  kind text NOT NULL
);
INSERT INTO demo_events VALUES
  (1, '2026-11-10', 'view'),
  (2, '2026-11-10', 'view'),
  (3, '2026-11-12', 'click'),
  (4, '2026-11-16', 'view'),
  (5, '2026-11-17', 'view');

Rapor 10–16 Kasım günlerini kapsayacak. 17 Kasım kaydı, aralığın dışındaki bir satırın yanlışlıkla rapora girmediğini kontrol etmek için var. 11, 13, 14 ve 15 Kasım'da hiç kayıt bulunmuyor.

Önce yedi takvim satırı üretin

SELECT DATE '2026-11-10' + g.n AS day
FROM generate_series(0, 6) AS g(n)
ORDER BY g.n;

Varsayılan adım 1'dir. Sıfırdan altıya kadar yedi tam sayı üretilir; tarihe eklenen her tam sayı bir günü ilerletir. Sonuç 10 Kasım ile başlar ve 16 Kasım ile biter. Bu, timestamp üzerine 24 saatlik aralıklar ekleyen bir örnek değildir.

Üretilen değerler durma sınırını aşmaz; 0, 6 ve varsayılan adımla iki uç da sonuçtadır. Negatif adım kullanırsanız yön değişir. Adım sıfır olamaz. Bu ayrıntıları ezberlemek yerine örnek takvimin satır sayısını ve iki uç tarihini kontrol edin.

Boş günü koruyun ve gerçek kaydı sayın

WITH days AS (
  SELECT DATE '2026-11-10' + g.n AS day
  FROM generate_series(0, 6) AS g(n)
)
SELECT d.day,
       COUNT(e.id) AS event_count,
       COUNT(*) AS joined_rows
FROM days AS d
LEFT JOIN demo_events AS e ON e.event_day = d.day
GROUP BY d.day
ORDER BY d.day;

event_count sırasıyla 2, 0, 1, 0, 0, 0, 1 olur. Buna karşılık joined_rows boş günlerde 1'dir: LEFT JOIN o günü korumak için sağ sütunları NULL olan bir sonuç satırı üretir. Bir etkinliğin oluştuğunu saymak için burada boş olamayan e.id kullanıyoruz.

COUNT(e.id) bu grupta zaten sıfır döndürür; onu COALESCE ile sarmalamak gerekli değildir. COUNT(*) ile gerçek kayıt sayısının neden farklı olduğunu LEFT JOIN ve COUNT rehberinde de görebilirsiniz.

Önceden gruplanmış sonucu bağlarken sıfırı yerleştirin

Sadece view olayları gerekiyorsa bunları ayrı bir toplama adımında filtreleyip gün başına tek satıra indirebilirsiniz.

WITH days AS (
  SELECT DATE '2026-11-10' + g.n AS day
  FROM generate_series(0, 6) AS g(n)
), counts AS (
  SELECT event_day, COUNT(*) AS views
  FROM demo_events
  WHERE kind = 'view'
    AND event_day >= DATE '2026-11-10'
    AND event_day < DATE '2026-11-17'
  GROUP BY event_day
)
SELECT d.day, COALESCE(c.views, 0) AS views
FROM days AS d
LEFT JOIN counts AS c ON c.event_day = d.day
ORDER BY d.day;

Bu sonuç 2, 0, 0, 0, 0, 0, 1 olur. 12 Kasım'daki click, view değildir. Boş günler için counts içinde grup satırı hiç oluşmaz; LEFT JOIN sonrasında c.views NULL olduğundan COALESCE burada anlamlıdır. Dışarıya WHERE c.views > 0 koyarsanız sıfırlı günleri tekrar kaybedersiniz.

Bu CTE'ler okuma adımlarını adlandırır; sorgunun mutlaka ayrı ayrı maddileştirileceğini veya otomatik olarak hızlanacağını varsaymayın. WITH ve CTE yazısı bu kullanımın sınırlarını açıklar.

Bitiş tarihini dışlayan bir takvim kurun

WITH bounds AS (
  SELECT DATE '2026-11-10' AS start_day,
         DATE '2026-11-17' AS end_day
)
SELECT b.start_day + g.n AS day
FROM bounds AS b
CROSS JOIN LATERAL generate_series(0, b.end_day - b.start_day - 1) AS g(n)
ORDER BY day;

İki date değerinin farkı gün sayısını verir. Bir çıkarmamız, end_day gününü dışarıda tutar. Başlangıç ile bitiş aynıysa bu sorgu gün üretmez. Bitiş daha erkense varsayılan pozitif adım yine boş sonuç verir; yanlış aralığı otomatik düzeltmez. Kullanıcıdan aralık alıyorsanız geçerli yönü ve izin verilen gün sayısını uygulama sözleşmesinde belirleyin.

Rapor satırlarının sırasını son ORDER BY belirler. Grafik için yedi satır üretmek ile yedi gerçek olay bulmak aynı kontrol değildir: Bu veri kümesinde tüm olayların hafta içi toplamı 4, yalnızca view toplamı 3 olmalıdır. Üretim verisinde bu iki sayıyı ayrı doğrulayın.

Sık sorulan sorular

Boş etkinlik tablosunda sonuç da boş mu olur? Takvim yedi gün üretmeye devam eder; eşleşen olay sayıları sıfır olur.

Bu yöntem saat dilimini çözer mi? Hayır. Örnek date sütununa dayanır. Bir anı iş takviminin gününe dönüştürmek ayrı bir karardır.

Her raporda geçici takvim üretmek zorunda mıyım? Hayır. Tatil, çalışma günü veya mali dönem bilgisi gerekiyorsa kalıcı bir takvim tablosu daha uygun olabilir. Bu örnek yalnızca ardışık günleri üretir.

Daha Fazla İçerik

Blog sayfasında diğer yazılarımı keşfedin

Tüm Yazılar