Apakah idempotency dan mengapa ia penting dalam sistem teragih?

Question

Accepted Answer

**Idempotency** bermaksud operasi menghasilkan keputusan yang sama sama ada dilakukan sekali atau berkali-kali. Ia kritikal dalam sistem teragih kerana retry dan mesej pendua tidak dapat dielakkan — operasi idempotent menjadikannya selamat.

## Apakah idempotency

```text
An operation is IDEMPOTENT if doing it MULTIPLE times has the SAME effect as doing it ONCE:
  → "set balance to 100" → idempotent (same result however many times)
  → "add 100 to balance" → NOT idempotent (each call changes it → wrong if duplicated!)
→ in HTTP: GET, PUT, DELETE are idempotent; POST typically is NOT
```

## Mengapa ia penting dalam sistem teragih

```text
Retries and duplicates are INEVITABLE in distributed systems:
  → a request times out → the client RETRIES → but the original may have succeeded →
    the operation runs TWICE (e.g. a payment charged twice! an order placed twice!)
  → message queues often guarantee AT-LEAST-ONCE delivery → duplicates happen
  → network issues, failures → operations get retried
→ if operations are IDEMPOTENT, duplicates/retries are SAFE (no harm from repeating)
→ this is essential for correctness and safe retries.
```

## Mencapai idempotency

```text
✓ IDEMPOTENCY KEYS → client sends a unique key per operation; the server processes each
  key only ONCE (dedupe) → retries with the same key are safe (common for payments/APIs)
✓ Design operations to be naturally idempotent (set vs increment; upsert)
✓ Track processed message/request IDs → skip duplicates
✓ Make consumers handle duplicate messages safely (since queues deliver at-least-once)
```

## Mengapa ia penting

Memahami idempotency bernilai kerana ia **penting untuk ketepatan dalam sistem teragih**, di mana retry dan pendua tidak dapat dielakkan, jadi ia merupakan pengetahuan system design yang penting.

Idempotency — operasi yang menghasilkan keputusan yang sama sama ada dilakukan sekali atau berkali-kali — adalah kritikal kerana dalam sistem teragih, **retry dan mesej pendua tidak dapat dielakkan**: permintaan boleh time out dan dicuba semula sedangkan yang asal sebenarnya berjaya (menjalankan operasi dua kali — berpotensi mengenakan bayaran dua kali atau membuat pesanan pendua!), message queue sering menjamin penghantaran at-least-once (menyebabkan pendua), dan isu rangkaian menyebabkan retry.

Jika operasi adalah **idempotent, pendua dan retry ini adalah selamat** (mengulanginya tidak menyebabkan kemudaratan), yang penting untuk ketepatan — dan memahami perkara ini merupakan pandangan utama untuk membina sistem teragih yang boleh dipercayai.

Memahami perbezaan ("set balance to 100" adalah idempotent; "add 100" tidak — perbezaan kritikal, kerana versi bukan idempotent menyebabkan keputusan yang salah apabila diduakan) dan kaedah HTTP mana yang idempotent (GET, PUT, DELETE lwn POST) menjelaskan konsep tersebut.

Memahami cara **mencapai idempotency** — menggunakan **idempotency key** (klien menghantar kunci unik bagi setiap operasi yang diproses oleh pelayan hanya sekali, menyahduakan — corak yang lazim dan penting untuk pembayaran dan API), mereka bentuk operasi yang secara semula jadi idempotent (set lwn increment, upsert), menjejaki ID permintaan/mesej yang telah diproses untuk melangkau pendua, dan membuat consumer mengendalikan mesej pendua dengan selamat — merupakan pengetahuan praktikal yang penting untuk retry yang selamat dan sistem teragih yang betul.

Memandangkan retry dan pendua tidak dapat dielakkan dalam sistem teragih dan idempotency menjadikannya selamat (mencegah pepijat ketepatan serius seperti caj berganda yang sebaliknya disebabkan oleh pendua), dan memandangkan memahami idempotency dan cara mencapainya (idempotency key, reka bentuk yang secara semula jadi idempotent) adalah penting untuk sistem teragih yang betul, memahami idempotency merupakan pengetahuan system design yang bernilai dan penting secara praktikal — penting untuk ketepatan dalam sistem teragih di mana retry dan pendua tidak dapat dielakkan, mencegah pepijat serius seperti pemprosesan berganda, dan konsep utama (terutamanya idempotency key) untuk membina sistem yang boleh dipercayai dengan retry yang selamat.