# Kuyruk tablosu: 30 saniyede kazanan, 15 dakikada kaybeden index

> Postgres 17'de kuyruk tablosu için dört index stratejisi: 30 saniyelik ölçüm, generic plan uçurumu ve 15 dakikalık churn altında index boyutu ile autovacuum.

- Tür: Sunum
- Yayın: 2026-10-03
- Slayt sayısı: 22
- Dayandığı yazılar: https://muhammetsafak.com/tr/research/partial-index-kuyruk-tablosu/ · https://muhammetsafak.com/tr/research/kuyruk-tablosunda-bloat-ve-autovacuum/ · https://muhammetsafak.com/tr/research/planner-generic-plana-ne-zaman-geciyor/ · https://muhammetsafak.com/tr/muhendislik/notlar/kuyruk-tablosunu-canli-kumeye-gore-kurmak/
- Kaynak: https://muhammetsafak.com/tr/gorseller/d/kuyruk-tablosu-index-secimi/
- Dil: tr-TR
- Yazar: Muhammet Şafak

---
## Slayt 1 — 30 saniyede kazanan, 15 dakikada kaybeden index

PostgreSQL · Kuyruk tablosu

Aynı tablo, Postgres 17, üç ölçüm.

Muhammet Şafak 3 Ekim 2026

## Slayt 2

Tek makine, Postgres 17, sentetik tezgâh

30 saniyede neredeyse eşit. 15 dakikada ayrıldılar.

Partial ve composite index otuz saniyede 11.537'ye 10.795 tps. On beş dakikalık sürekli yükte composite hedefi tutamadı.

## Slayt 3 — Bir tabloda iki küme

Postgres bu ayrımı bilmez

|  | Arşiv · done | Canlı küme · pending |
| --- | --- | --- |
| Kim bakar | Kimse sorgulamaz | Worker'lar arar, claim'ler kilitler |
| Boyut | Silinmezse sonsuza büyür | Kabaca sabit durur |
| Ölçülen | n\_live\_tup 10.005.726 | 5.000 satır |
| Postgres | Canlı tuple: index, istatistik ve vacuum eşiği onu sayar | Aynı muamele; ikisi ayırt edilmez |

## Slayt 4 — Otuz saniye

Bölüm 01

Dört strateji, üç ölü satır kademesi. Canlı küme her kademede 5.000 satır.

## Slayt 5 — Üç kademe, dört strateji

SKIP LOCKED · 8 istemci · 30 sn · üç tekrarın medyanı

FOR UPDATE SKIP LOCKED ile claim; 8 istemci, 30 saniye, üç tekrarın medyanı. Canlı küme her kademede 5.000 satır.

| Strateji | 100k ölü satır | 1M | 10M | Index (10M) |
| --- | --- | --- | --- | --- |
| index yok | 2.001 tps | 247 tps | 7 tps | — |
| (status) | 6.499 tps | 6.417 tps | 6.426 tps | 66,1 MB |
| (status, created\_at) | 12.414 tps | 11.202 tps | 10.795 tps | 310,4 MB |
| partial (created\_at) WHERE pending | 13.041 tps | 11.707 tps | 11.537 tps | 7,6 MB |

## Slayt 6

Index yok

Index'siz kuyruk yok oluyor.

Ölü satırla birlikte çökmüyor: 2.001'den 7 tps'ye. 10 milyon satırın arasından 5.000 satırı sequential scan saniyede yedi kez bulabiliyor.

## Slayt 7

41×

Asıl fark boyutta

daha küçük index

10 milyon ölü satırda partial 7,6 MB, composite 310,4 MB. Throughput farkı yalnız %6,9: seçme sebebi hız değil, index'in tabloyla birlikte büyümemesi.

## Slayt 8 — Partial index tabloyla büyümüyor

Ölü satır arttıkça

index boyutu, MB

-   composite · 100k 11.2
-   composite · 1M 40.3
-   composite · 10M 310.4
-   partial · 100k 6.5
-   partial · 1M 7.6
-   partial · 10M 7.6

pg\_relation\_size, bench/run.sh

## Slayt 9 — Planner

Bölüm 02

Aynı tablo, aynı index, aynı sorgu. Değişen tek şey planın türü.

## Slayt 10 — Generic plan uçurumu

10M ölü satır · aynı sorgu, parametreyle

Aynı tablo, aynı index, aynı sorgu. Partial index generic planda hiç taranmadı: Limit, LockRows, Sort, Seq Scan.

| Index · plan | tps | Gecikme | Plan |
| --- | --- | --- | --- |
| partial · custom | 11.752 | 0,68 ms | `Index Scan` |
| partial · generic | 7 | 1.113 ms | `Sort → Seq Scan` |
| composite · custom | 11.105 | 0,72 ms | `Index Scan` |
| composite · generic | 11.416 | 0,70 ms | `Index Scan` |

## Slayt 11 — Yaklaşık 1.635 kat

Neden

-   **Note** Generic plan $1'in ne olduğunu bilmeden kurulur. status = $1'in 'pending' olduğunu kanıtlayamaz, partial index'i eler.
-   **Tip** Composite etkilenmez: kanıtlanacak bir predicate'i yok, status index'in içindeki bir kolon.
-   **Warning** Uçuruma düşmek için force\_generic\_plan gerekti. Bu bir üretim ayarı değil.

## Slayt 12 — Kırk çalıştırma, kırk custom plan

Tek oturum, varsayılan auto mod

1.   İlk beş çalıştırma: üçü de custom plan done
2.   Altıncı: composite generic'e geçer done
3.   Partial: 40'ın 40'ı custom done
4.   (status): 40'ın 40'ı custom done

## Slayt 13 — Bu koşullarda geçmedi

Düzeltme

-   **Düzeltme** Önceki kaydımda 'ısındıkça bozulur' demiştim. Ölçüldüğünde yanlış çıktı; kırk çalıştırmanın kırkı custom plan kaldı.
-   **Neden** En olası açıklama: partial index'i kullanamayan generic planın tahmini maliyeti yüksek çıkıyor. Plan maliyetleri kaydedilmedi.
-   **Bedel** Partial her çalıştırmada yeniden planlanır. Bu ölçekte fark ölçülemedi: 0,20 ms'ye 0,21 ms.

## Slayt 14 — Şimdi 15 dakika

Bölüm 03

Sürekli churn: saniyede 2.000 iş, varsayılan autovacuum ayarları.

## Slayt 15 — Canlı küme sabit, index büyüyor

Partial · ~305 kat

index boyutu, MB

Canlı küme sabit, index büyüyor (index boyutu, MB): 0 sn: 0.125, 135 sn: 5.9, 286 sn: 12.4, 436 sn: 18.8, 587 sn: 25.3, 738 sn: 31.7, 888 sn: 38.2.

pg\_relation\_size, 15 saniyede bir örnek, bench/endurance.sh. pending→done geçişi vacuum'a kadar ölü girdi bırakır.

## Slayt 16 — Composite daha az oranla, daha çok MB şişti

Composite · %42, +126 MB

index boyutu, MB

Composite daha az oranla, daha çok MB şişti (index boyutu, MB): 0 sn: 301, 135 sn: 321, 286 sn: 344, 436 sn: 366, 587 sn: 388, 738 sn: 409, 888 sn: 427.

pg\_relation\_size, 15 saniyede bir örnek, bench/endurance.sh

## Slayt 17 — Şişen index sürdürülebilir yükü taşımıyor

Hedef 2.000 iş/sn · 900. saniye

|  | composite | partial |
| --- | --- | --- |
| Başlangıç | 2.000 tps · 0,52 ms | 2.024 tps · 1,7 ms |
| 900\. saniye | 1.204 tps · 61.533 ms | 2.016 tps · 4.906 ms |
| Bekleyen iş | 5.000 → 126.024 | 5.003 → 14.364 |
| Sonuç | Hedefi tutamadı | Hedefi tuttu |

## Slayt 18 — İki not

Okurken

-   **Note** Gecikme pgbench'in zamanlama gecikmesini içeriyor: hedef hıza yetişemeyen istemcinin borcu buraya yazılıyor.
-   **Note** Fark sürdürülebilir yükte açılıyor: 427 MB'a şişen index artık belleğe sığmıyor, her tarama diske gidiyor.

## Slayt 19 — Autovacuum hiç gelmedi

Eşik tabloyla büyür

-   1,75 Milyon ölü satır 15 dakikada 1.753.949
-   0 Autovacuum Bir kez bile koşmadı
-   ≈2 Eşik, milyon satır 50 + 0,2 × 10.005.000 ≈ 2.001.050
-   17 Dakika, tahmini aralık Bu iş yüküne özgü; vacuum maliyeti ölçülmedi

## Slayt 20 — Eşiği tablodan koparın

Öneri

Bu ayarı ölçmedim. 50.000 bir başlangıç noktası; kendi throughput'unuza göre ayarlayın.

jobs.sql

```
1ALTER TABLE jobs SET (2  autovacuum_vacuum_scale_factor = 0,3  autovacuum_vacuum_threshold    = 500004);56CREATE INDEX CONCURRENTLY7  jobs_pending_created_at8  ON jobs (created_at)9WHERE status = 'pending';
```

## Slayt 21 — Sor Bakalım cevabındaki iddialar, ölçülünce

Sonuç

-   Partial index küçük kalır: 10M'de 7,6 MB (done)
-   (status) index'inden üstün: 11.537'ye 6.426 tps (done)
-   ORDER BY kolonu index'e girmeli (done)
-   Parametreyle planner partial'ı seçemeyebilir: doğru ama dar (done)
-   Churn ve bloat: ilk kayıtta ölçülmedi, sonradan ölçüldü (done)

## Slayt 22 — Koşulu bulun

[github.com/muhammetsafak/pg-queue-bench](https://github.com/muhammetsafak/pg-queue-bench)

Bir tavsiyeyi ölçmenin değeri onu doğrulamak değil. Değeri, doğru bir cümlenin hangi koşulda tersine döndüğünü bulmakta.
