{"canonical_url":"https://engineer.company/sv/glossary/idempotent/","content_markdown":"# Idempotent\n\n## Vad det är\n\nEn operation är idempotent om en upprepning med samma indata ger samma avsedda effekt som en\nenda körning. Aktivera abonnemanget Pro på samma konto två gånger, så har kontot fortfarande\nsamma abonnemang. Lägg i stället till tio krediter två gånger, så ökar saldot med tjugo. En\nandra körning är ett praktiskt sätt att se skillnaden.\n\nEgenskapen kallas idempotens. Ordet kommer från matematiken, där en funktion är idempotent om\nden ger samma värde när den tillämpas på sitt eget resultat, så att f(f(x)) är lika med f(x).\nAvrunda ett tal nedåt till ett heltal. Vid en andra avrundning förblir heltalet detsamma.\n\nDe här två SQL-satserna visar skillnaden i en databas:\n\n```sql\n-- idempotent: a second run sets the same value\nUPDATE accounts SET plan = 'pro' WHERE id = 42;\n\n-- not idempotent: a second run adds ten more\nUPDATE accounts SET credits = credits + 10 WHERE id = 42;\n```\n\nHTTP ger ordet dess mest precisa definition. RFC 9110 kallar en metod idempotent om den avsedda\neffekten på servern av flera identiska begäranden är densamma som effekten av en enda, och räknar\nupp PUT, DELETE och de säkra metoderna GET, HEAD, OPTIONS och TRACE. Två detaljer i den\ndefinitionen gör skillnad. Egenskapen gäller den effekt som klienten bad om, så servern får gärna\nlogga varje begäran för sig. Och svaret får skilja sig: en andra DELETE av samma resurs kan svara\n404 där den första svarade 200, och metoden är ändå idempotent, eftersom resursen är borta i båda\nfallen.\n\nPATCH står utanför listan. Enligt RFC 5789 är den varken säker eller idempotent, men en klient kan\nskicka en viss PATCH på ett idempotent sätt genom att göra den villkorad, med en stark ETag i ett\nhuvudfält `If-Match`. En upprepad kopia avvisas då så snart den första har ändrat resursen.\n\nSäker är det strängare av de två löftena. En säker metod i RFC 9110:s mening är i allt väsentligt\nen läsoperation, så varje säker metod är idempotent, medan DELETE är idempotent utan att vara säker.\n\n## Varför det spelar roll\n\nNätverk tappar svar. När en klient skickar en begäran och anslutningen bryts innan svaret kommer\nfram kan den inte avgöra om servern aldrig såg begäran, såg den och avbröt, eller utförde den och\ntappade svaret. Att upprepa begäran är den självklara vägen tillbaka, och det är idempotensen som\ngör upprepningen ofarlig. RFC 9110 bygger sina regler för nya försök på just det. En idempotent\nbegäran får upprepas automatiskt efter ett kommunikationsfel. En klient bör inte automatiskt\nförsöka igen med en begäran som inte är idempotent, om den inte vet att begäran i praktiken är\nidempotent eller kan se att originalet aldrig verkställdes. En proxy får aldrig automatiskt\nupprepa en begäran som inte är idempotent.\n\nKöer ställer samma fråga i större skala. Många meddelandesystem lovar leverans minst en gång: en\nkonsument som kraschar efter att ha gjort sitt arbete men innan den har kvitterat meddelandet får\nsamma meddelande en gång till. Leverans exakt en gång över ett nätverk är ett betydligt svårare\nlöfte, så det praktiska svaret är en konsument för vilken en andra leverans inte ändrar något.\nKonfigurationshantering vilar också på egenskapen. Ett verktyg som för servrar till ett deklarerat\ntillstånd körs om och om igen, efter varje ändring och ofta enligt schema, och varje körning måste\nlämna en korrekt server exakt som den hittade den.\n\nDet verkliga beslutet är hur ni får idempotens där en operation saknar den av naturen, och det\nfinns tre vanliga svar.\n\n- **Design.** Uttryck ändringen som ett måltillstånd i stället för ett steg, alltså ”se till att\n  den här raden finns i filen” i stället för ”lägg till den här raden”.\n- **En nyckel.** Klienten bifogar en unik identifierare till begäran, servern sparar den under ett\n  unikhetsvillkor, och en upprepning hittar posten och får tillbaka det ursprungliga resultatet i\n  stället för en andra åtgärd.\n- **Kontroll före handling.** Så fungerar de flesta moduler i Ansible: de jämför det aktuella\n  tillståndet med det önskade och avslutar utan att göra något när de redan stämmer överens.\n\nVar och en har sin kostnad. Design kring måltillstånd kräver en tydlig modell av sluttillståndet,\nnycklar kräver lagring och en regel för hur länge de sparas, och kontroll före handling kräver ett\npålitligt sätt att läsa av det aktuella tillståndet.\n\n## Så ser det ut i praktiken\n\nFöretagets egna servrar konfigureras med Ansible, och i det projektet\n[är idempotens ett kontrakt: en konvergerad värd rapporterar noll ändringar](/sv/portfolio/servers-you-can-rebuild-from-scratch/).\nProvisionering utan argument konvergerar varje värd till dess deklarerade tillstånd, och en play\nsom inte kan rapportera noll ändringar på en värd som redan är korrekt räknas som ofärdig. Det gör\nidempotens till något som varje körning mäter, i stället för något man hoppas på.\n\nSamma idé tillämpad på data ligger bakom\n[ett test som kör hela byggpipelinen i nitton steg två gånger](/sv/portfolio/held-the-generator-to-981-tests-and-92-coverage/).\nSidan namnger den sorts bugg som testet finns till för: en generator som fungerar första gången\noch korrumperar andra gången, genom steg som infogar utan att kontrollera eller som beror på\nordningen i ett tidigare stegs utdata. Testet bygger databasen från en tom fil, tar en\nögonblicksbild, kör hela pipelinen igen över resultatet och kräver att den andra körningen inte\nändrar någonting, ända ned till radantal, innehåll och identifierare. Testet ger belägg för upprepade körningar med de indata och det databastillstånd som det prövar.\n\nFör försäljning av begränsat lager kombinerar anteckningen om att\n[sälja den sista biljetten exakt en gång](/sv/notes/selling-limited-stock-without-overselling/)\nen nyckel med villkorade skrivningar. Varje köp i kassan bär en idempotensnyckel, och\nreservationstabellen har `UNIQUE (tenant_id, idempotency_key)`, så att ett upprepat klick får\ntillbaka den reservation det redan har i stället för en andra enhet. En åtgärd som frigör en reservation och körs två\ngånger, t.ex. från en timeout och en avbrytknapp, lämnar tillbaka enheten en gång, eftersom\nlagersaldot bara krediteras när åtgärdens egen uppdatering ändrade exakt en rad. Längre fram i\nflödet är varje meddelandekonsument idempotent, nycklad på ordern: meddelanden kommer fram minst\nen gång, och idempotensen gör det i praktiken till en gång.\n\n## Var det går fel\n\n**En begäran som görs om debiterar två gånger.** En POST som skapar en betalning, en order eller\nett mejl är inte idempotent som standard, och en klient eller proxy som försöker igen efter en\ntimeout skapar en till. Ge sådana begäranden en idempotensnyckel som servern sparar under ett\nunikhetsvillkor, och returnera det sparade resultatet när samma nyckel kommer tillbaka.\n\n**Ett tomt resultat tolkas som ett fel.** I PostgreSQL hoppar\n`INSERT ... ON CONFLICT DO NOTHING` över en rad som skulle bryta mot ett unikhetsvillkor, och\n`RETURNING` lämnar bara tillbaka rader som faktiskt infogades eller uppdaterades. En upprepad\ninfogning av samma rad returnerar därför ingenting, vilket är det korrekta utfallet av en andra\nkörning. Kod som behandlar det tomma resultatet som ett misslyckande gör ett ofarligt nytt försök\ntill en felsida; den borde slå upp raden som redan finns.\n\n**En kommandotask ändrar värden vid varje körning.** Ansibles dokumentation säger att de flesta\nmoduler kontrollerar om det önskade tillståndet redan är uppnått, och också att inte alla\nplaybooks och inte alla moduler beter sig så. En task som kör ett kommando är det vanliga\nundantaget, eftersom kommandot är godtyckligt och Ansible inte kan veta vad det gör.\nKommandomodulens alternativ `creates` hoppar över steget när en viss fil redan finns, `removes`\nkör det bara så länge filen finns kvar, och `changed_when` anger vilket utfall som räknas som en\nändring. En kommandotask utan något av dem körs igen vid varje konvergering, oavsett i vilket\ntillstånd värden är.\n\n**En räknare räknar med det nya försöket.** Vid leverans minst en gång gör en konsument som räknar\nupp en räknare eller skickar en avisering för varje meddelande det två gånger för ett meddelande\nsom levereras två gånger. Spara meddelandets affärsnyckel tillsammans med effekten, i samma\ntransaktion, och hoppa över varje nyckel som redan är sparad.\n\n**Den andra körningen korrumperar det som den första byggde.** Ett steg kan vara korrekt på en tom\ndatabas och fel på en full, genom att infoga en dubblett, numrera om identifierare eller luta sig\nmot en ordning som den första körningen lämnade efter sig. Ett test som börjar från ingenting och\nkörs en gång går igenom ändå. Kör hela jobbet två gånger och kräv att den andra körningen inte\nändrar något, precis som byggtestet ovan gör.\n\n## Läs mer\n\n- [RFC 9110, section 9.2.2: Idempotent Methods](https://www.rfc-editor.org/rfc/rfc9110#name-idempotent-methods)\n  — HTTP:s definition, de idempotenta metoderna och reglerna för automatiska nya försök.\n- [RFC 5789: PATCH Method for HTTP](https://www.rfc-editor.org/rfc/rfc5789) — varför PATCH varken\n  är säker eller idempotent, och hur en villkorad begäran gör den ofarlig att upprepa.\n- [Ansible: Introduction to playbooks](https://docs.ansible.com/ansible/latest/playbook_guide/playbooks_intro.html)\n  — önskat tillstånd, idempotens och check mode med Ansibles egna ord.\n- [Ansible: command module](https://docs.ansible.com/ansible/latest/collections/ansible/builtin/command_module.html)\n  — alternativen `creates` och `removes`, som gör ett kommando ofarligt att köra om.\n- [PostgreSQL: INSERT](https://www.postgresql.org/docs/current/sql-insert.html) — `ON CONFLICT`\n  och vad `RETURNING` lämnar tillbaka när en rad redan finns.\n\n\u003chttps://engineer.company/sv/glossary/idempotent/\u003e\n","date_modified":"2026-11-19T06:00:51Z","description":"En idempotent operation ger samma avsedda effekt när den upprepas. Se exempel från HTTP och SQL och när det är rimligt att göra ett nytt försök.","formats":{"gemtext":"https://engineer.company/sv/glossary/idempotent/index.gmi","gopher":"https://engineer.company/sv/glossary/idempotent/gophermap","html":"https://engineer.company/sv/glossary/idempotent/","json":"https://engineer.company/sv/glossary/idempotent/index.json","markdown":"https://engineer.company/sv/glossary/idempotent/index.md","pdf":"https://engineer.company/sv/glossary/idempotent/index.pdf"},"kind":"page","language":"sv","title":"Vad betyder idempotent?","url":"https://engineer.company/sv/glossary/idempotent/","version":1}