Idempotency ni nini na kwa nini ni muhimu katika mifumo iliyosambazwa?

Question

Accepted Answer

**Idempotency** inamaanisha operesheni hutoa matokeo sawa iwapo imetendeliwa mara moja au maruwaka nyingi. Ni muhimu katika mifumo iliyosambazwa kwa sababu kujaribu tena na ujumbe unaonirudia si wa kawaida — operesheni zenye idempotency zinafanya hizi kuwa salama.

## Idempotency ni nini

```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
```

## Kwa nini ni muhimu katika mifumo iliyosambazwa

```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.
```

## Kufikia 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)
```

## Kwa nini ni muhimu

Kuelewa idempotency ni muhimu kwa sababu ni **muhimu kwa usahihi katika mifumo iliyosambazwa**, ambapo kujaribu tena na ujumbe unaonirudia si wa kawaida, kwa hivyo ni maarifa muhimu ya kubuni mifumo.

Idempotency — operesheni inayotoa matokeo sawa iwapo imetendeliwa mara moja au maruwaka nyingi — ni muhimu kwa sababu katika mifumo iliyosambazwa, **kujaribu tena na ujumbe unaonirudia si wa kawaida**: ombi linaweza kuishia muda na kujaribu tena wakati original ilifanikiwa (kuendesha operesheni mara mbili — kukamatia kulipwa mara mbili au kuweka agizo lililorudia!), milangu ya ujumbe mara nyingi inahakikisha utoaji wa angalau mara moja (kusababisha ujumbe unaonirudia), na matatizo ya mtandao husababisha kujaribu tena.

Kama operesheni zina **idempotency, ujumbe huu unaonirudia na kujaribu tena kuwa salama** (kurudia kusababisha si kitu), ambayo ni muhimu kwa usahihi — na kuelewa hii ni mtazamo muhimu kwa kujenga mifumo iliyotegemeka iliyosambazwa.

Kuelewa tofauti ("weka salio la 100" ni idempotent; "ongeza 100" sio — tofauti muhimu, kwa sababu toleo lisilobadilika lusababisha matokeo mabaya wakati lilirudia) na njia gani za HTTP ni idempotent (GET, PUT, DELETE vs POST) inaceza wazo.

Kuelewa jinsi ya **kufikia idempotency** — kutumia **funguo za idempotency** (waajiri wanaotuma funguo ya kipekee kwa operesheni ambayo severi inakataa mara moja, kuondoa ujumbe unaonirudia — kiwango cha kawaida, muhimu kwa malipo na APIs), kubuni operesheni zilizo na idempotency kwa asili (weka vs ongeza, upsert), kumfuata ID za ombi/ujumbe uliotoka ili kuruka ujumbe unaonirudia, na kufanya watumiaji kushughulikia ujumbe unaonirudia kwa usalama — ni maarifa ya vitendo muhimu kwa kujaribu tena salama na mifumo iliyosambazwa na usahihi.

Kwa sababu kujaribu tena na ujumbe unaonirudia si wa kawaida katika mifumo iliyosambazwa na idempotency inafanya kuwa salama (kuzuia mababa ya usahihi kama malipo mara mbili ambayo ujumbe unaonirudia husababisha vinginevyo), na kwa sababu kuelewa idempotency na jinsi ya kuifikia (funguo za idempotency, kubuni la asili ya idempotency) ni muhimu kwa mifumo iliyosambazwa na usahihi, kuelewa idempotency ni maarifa muhimu, yanayofaa makubunya — muhimu kwa usahihi katika mifumo iliyosambazwa ambapo kujaribu tena na ujumbe unaonirudia si wa kawaida, kuzuia mababa makubwa kama kunoza mara mbili, na wazo muhimu (hasa funguo za idempotency) kwa kujenga mifumo iliyotegemeka iliyo na kujaribu tena salama.