Kafka'nın teslimat semantikleri nelerdir (en-az-bir-kez, tam-bir-kez)?

Question

Accepted Answer

Kafka, farklı **teslimat garantileri** — **en-fazla-bir-kez**, **en-az-bir-kez** ve **tam-bir-kez** — destekler. Bu garantiler, mesajların kaybolup kaybılmayacağını veya çoğaltılıp çoğaltılmayacağını belirler. Bu garantileri anlamak ve bunları nasıl elde edeceğinizi bilmek, güvenilir sistemler oluşturmak için önemlidir.

## Üç teslimat semantiği

```text
AT-MOST-ONCE → messages may be LOST but never duplicated:
  → commit offset BEFORE processing → if processing fails, the message is skipped (lost)
  → for: when occasional loss is acceptable and duplicates are not (rare)
AT-LEAST-ONCE → messages are never lost but may be DUPLICATED:
  → commit offset AFTER processing → if a crash occurs before commit, the message is
    reprocessed (duplicate) → requires IDEMPOTENT processing
  → the common default; safe (no loss) but handle duplicates
EXACTLY-ONCE → each message is processed exactly once (no loss, no duplicates):
  → the strongest, but hardest; requires Kafka transactions + idempotent producers
```

## Garantileri elde etme

```text
→ AT-LEAST-ONCE → process then commit; make consumers IDEMPOTENT (handle duplicates safely
  via dedup keys, idempotent operations) — practical and common
→ EXACTLY-ONCE → Kafka's transactional API + idempotent producer (enable.idempotence) →
  produce + commit offsets atomically (exactly-once within Kafka, e.g. Kafka Streams)
  ⚠️ exactly-once is complex and has overhead; often AT-LEAST-ONCE + idempotency is simpler
    and sufficient
```

## Pratik rehberlik

```text
✓ Most systems use AT-LEAST-ONCE + idempotent processing (simple, reliable)
✓ Use EXACTLY-ONCE when duplicates are truly unacceptable AND idempotency is hard
✓ Producer acks (acks=all) → durability (don't lose on the produce side)
→ understand the trade-offs; design for the guarantee your use case needs
```

## Neden önemli

Kafka'nın teslimat semantiklerini anlamak değerlidir çünkü **teslimat garantileri güvenilirliği belirler** (mesajların kaybolup kaybılmayacağını veya çoğaltılıp çoğaltılmayacağını), bu nedenle anlaşılmaları güvenilir sistemler oluşturmak için önemlidir.

Teslimat semantiklerinin seçimi doğrudan doğruluk etkilenir.

**Üç teslimat semantiğini** anlamak — **en-fazla-bir-kez** (mesajlar kaybolabilir ancak çoğaltılmaz, offset'i işlemeden önce commit ederek — ara sıra kaybın kabul edilebilir olduğu durumlarda), **en-az-bir-kez** (mesajlar asla kaybolmaz ancak muhtemelen çoğaltılır, işlemeden sonra commit ederek, idempotent işleme gerektiren — yaygın, güvenli varsayılan), ve **tam-bir-kez** (her mesaj tam olarak bir kez işlenir, en güçlü ancak en zor, işlemler ve idempotent producer'lar gerektiren) — güvenilirlik ticari anlaşmalarını anlamak için gereklidir.

**Garantileri nasıl elde edeceğinizi** anlamak — en-az-bir-kez için işlem yapıp commit etmek ve consumer'ları **idempotent** yapmak (kopyaları dedup anahtarları ve idempotent işlemler aracılığıyla ele almak — pratik ve yaygın), ve tam-bir-kez için Kafka'nın işlemsel API'si ve idempotent producer aracılığıyla (üretim ve offset commit'lerini atomik olarak yapmak), **en-az-bir-kez artı idempotency çoğunlukla daha basit ve yeterli** olduğu önemli caveat ile — pratik yaklaşımı yansıtır.

**Pratik rehberligi** anlamak — çoğu sisteme en-az-bir-kez artı idempotent işleme (basit ve güvenilir) kullandığında, tam-bir-kez'i yalnızca kopyaların gerçekten kabul edilemez olması ve idempotency zor olduğunda kullandığında, ve dayanıklılık için producer acks'i kullandığında — ses tasarım yargısını yansıtır.

Ana fikir, teslimat semantiklerinin ticari anlaşmalar (kayıp vs kopyalar vs karmaşıklık) içermesidir ve yaygın, pratik seçim en-az-bir-kez idempotency ile ilgilidir; bu, dağıtılmış sistemlerde idempotency'nin daha geniş önemine bağlantılıdır.

Teslimat garantileri mesajların kaybolup kaybılmayacağını veya çoğaltılıp çoğaltılmayacağını belirlemesinden (doğrudan güvenilirliği etkileyen) ve semantikleri, bunları nasıl elde edeceğinizi (özellikle pratik varsayılan olarak idempotency ile en-az-bir-kez), ve ticari anlaşmaları anlamanın güvenilir sistemler oluşturmak için önemli olmasından dolayı, Kafka'nın teslimat semantiklerini anlamak değerli, pratik olarak önemli Kafka bilgisidir — güvenilirliğe merkezi, sistemleri doğru garantilerle (yaygınlıkla idempotency ile en-az-bir-kez) tasarlamak için önemli, ve güvenilir Kafka tabanlı sistemler oluşturmak için gerekli olan anlayışı yansıtır.