Menu

PostgreSQL generate_series: Sayı, Tarih Dizisi ve Boşluklar

generate_series, bir başlangıç değerinden bitiş değerine kadar bir satır kümesi döndürür: sayılar, tarihler ve timestamp'ler. Raporlardaki boşlukları doldurmak, test verisi üretmek ve takvim kurmak için kullan.

Bu sayfada çalıştırılabilir editörler var. Düzenle, çalıştır ve sonucu anında gör.

generate_series(start, stop, step), start'tan başlayıp stop dahil olmak üzere step adımlarıyla ilerleyerek (verilmezse 1) her değer için bir satır döndürür. Tam sayılar, numeric değerler ve interval adımlı timestamp'lerle çalışır. Onu FROM içinde bir tablo gibi kullan.

Bu sorgu 1, 4, 7 ve 10'u kareleriyle birlikte döndürür. Negatif bir adım geriye doğru sayar: generate_series(5, 1, -2) 5, 3, 1 verir. generate_series(5, 1) gibi sonuna ulaşamayan bir dizi hiç satır döndürmez. generate_series(0, 1, 0.25) numeric değerler üzerinde ilerler.

Tarih dizisi üretmek

interval adımıyla timestamp ya da tarih ver. date sürümü olmadığı için değerler timestamptz olarak döner; onları ::date ile çevir:

Ay sonunu aşarak 26 Şubat'tan 2 Mart'a kadar beş gün döner. Adım olarak her interval çalışır: interval '1 hour', interval '15 minutes', interval '1 month', interval '1 week'.

timestamptz değerlerinde interval '1 day' adımı oturumun TimeZone takvimini izler. Yaz saati geçişinde bir adım 23 ya da 25 saat olabilir. PostgreSQL 16'dan beri dördüncü bir argüman, oturum ne kullanırsa kullansın adımların hangi saat diliminde atılacağını belirtir:

SELECT generate_series(
    timestamptz '2026-03-28 00:00 Europe/Berlin',
    timestamptz '2026-03-31 00:00 Europe/Berlin',
    interval '1 day',
    'Europe/Berlin');

Bir rapordaki eksik günleri doldurmak

Verilerin üzerindeki bir GROUP BY yalnızca satırı olan dönemleri döndürür. Siparişi olmayan günler için sıfırla birlikte her günü göstermek için günleri üret ve verileri onlara LEFT JOIN ile bağla:

1 Kasım'da 2, 4 Kasım'da 1 sipariş var; 2, 3 ve 5 Kasım ise 0 gösteriyor. count(*) değil, join edilen tablonun bir sütununu say (count(o.id)); yoksa her boş gün 1 sayılır.

created_at::date = d yerine created_at değerini bir aralıkla karşılaştırmak, created_at üzerindeki bir indeksin kullanılmasını sağlar. Aynı yöntem interval '1 month' ve date_trunc ile boş ayları doldurur (tarih fonksiyonları sayfasına bak).

Test verisi üretmek

Bir diziden yapılan INSERT ... SELECT, tek komutta ihtiyacın kadar satır oluşturur:

Tablo, 30 kayıt gününe yayılmış 1.000 kullanıcı alır. Değerler i'den hesaplandığı için her çalıştırma aynı sonucu verir; değişmelerini istiyorsan random() kullan. Bir indeksi denemek ve planları EXPLAIN ANALYZE ile karşılaştırmak için aynı şekilde bir milyon satır üret.

Satırları numaralandırmak ve dizileri join'lerde kullanmak

WITH ORDINALITY, küme döndüren her fonksiyona bir konum sütunu ekler:

Bu sorgu 09:00'dan 10:00'a kadar 1'den 5'e numaralandırılmış beş adet 15 dakikalık dilimi listeler. Bir dizi CROSS JOIN içinde de çalışır; örneğin her kullanıcıyı ayın her günüyle eşleştirmek için.

SELECT listesindeki generate_series de birkaç satır döndürür, ama farklı uzunluktaki iki böyle çağrı kısa olanı NULL'larla doldurur. Küme döndüren fonksiyonları FROM içinde tut. Bir ağaçta gezinmek gibi tek bir fonksiyonun ifade edemediği diziler için recursive bir CTE kullan.

Sıkça Sorulan Sorular

generate_series bitiş değerini dahil eder mi?

Evet, adımlar ona denk geliyorsa: generate_series(1, 5) 1'den 5'e kadar döndürür. Denk gelmiyorsa dizi bitişi geçmeyen son değerde durur; yani generate_series(1, 10, 4) 1, 5 ve 9 döndürür.

MySQL'de generate_series var mı?

Hayır. MySQL'de diziyi recursive bir CTE (WITH RECURSIVE) ile kurarsın; bu PostgreSQL'de de çalışır ama yazması daha uzundur.

Tarihlerle kullanılan generate_series neden timestamp döndürüyor?

Fonksiyonun date sürümü yok, bu yüzden PostgreSQL timestamptz sürümünü kullanır. Her değeri ::date ile geri çevir.

Her satır için nasıl rastgele bir sayı üretirim?

Seçim listesinde random() çağır: SELECT i, random() FROM generate_series(1, 5) AS i her satır için 0 ile 1 arasında bir değer, floor(random() * 100)::int ise 0 ile 99 arasında bir tam sayı verir. PostgreSQL 17'den beri random(1, 100) doğrudan o aralıkta rastgele bir tam sayı döndürür.

Coddy programlama dilleri çizimi

Coddy ile kodlamayı öğren

Başla