{"canonical_url":"https://engineer.company/nb/glossary/idempotent/","content_markdown":"# Idempotent\n\n## Hva det er\n\nEn operasjon er idempotent når det å utføre den flere ganger har samme virkning som å utføre den én\ngang, og egenskapen kalles idempotens. Ordet kommer fra matematikken, der en funksjon er idempotent\nnår den kan brukes på sitt eget resultat uten at noe endres, slik at f(f(x)) er lik f(x): runder du\nned et tall som allerede er rundet ned, får du det samme tallet.\n\nI programvare er den nyttige testen en kjøring nummer to. Å sette en verdi er idempotent, fordi den\nandre kjøringen skriver verdien som allerede står der. Å legge til på en verdi er det ikke, fordi\nden andre kjøringen legger til én gang til:\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 gir ordet sin mest presise definisjon. RFC 9110 kaller en forespørselsmetode idempotent hvis\nden tilsiktede virkningen på serveren av flere identiske forespørsler er den samme som virkningen av\nén, og lister opp PUT, DELETE og de trygge metodene GET, HEAD, OPTIONS og TRACE. To detaljer i den\ndefinisjonen betyr noe. Egenskapen gjelder virkningen klienten ba om, så serveren står fritt til å\nlogge hver forespørsel for seg. Og svaret kan være forskjellig: en ny DELETE av den samme ressursen\nkan svare 404 der den første svarte 200, og metoden er likevel idempotent, fordi ressursen er borte\ni begge tilfeller. PATCH står utenfor listen. RFC 5789 sier at den verken er trygg eller idempotent,\nmen en klient kan sende en bestemt PATCH på en idempotent måte ved å gjøre den betinget, med en\nsterk ETag i en If-Match-header, slik at en gjentatt kopi blir avvist så snart den første har endret\nressursen.\n\nTrygg er det strengeste av de to løftene. En trygg metode i betydningen fra RFC 9110 er i det vesentlige en leseoperasjon, så hver trygg metode er idempotent, mens DELETE er idempotent uten å være\ntrygg.\n\n## Hvorfor det er viktig\n\nNettverk mister svar. Når en klient sender en forespørsel og forbindelsen brytes før svaret kommer,\nhar klienten ingen måte å vite om serveren aldri fikk forespørselen, fikk den og stoppet underveis,\neller utførte den og svaret gikk tapt på veien tilbake. Å gjenta forespørselen er den åpenbare måten\nå komme seg på, og idempotens er det som gjør gjentakelsen ufarlig. RFC 9110 bygger reglene for nye\nforsøk på nettopp det. En idempotent forespørsel kan gjentas automatisk etter en kommunikasjonsfeil.\nEn klient bør ikke prøve en ikke-idempotent forespørsel på nytt automatisk med mindre den vet at\nforespørselen er idempotent i praksis, eller kan se at originalen aldri ble utført, og en proxy skal\naldri prøve en slik forespørsel på nytt på egen hånd.\n\nEn kø reiser det samme spørsmålet i stor skala. Mange meldingssystemer lover levering minst én gang:\nen konsument som krasjer etter å ha gjort jobben, men før den har kvittert for meldingen, får den\nsamme meldingen en gang til. Levering nøyaktig én gang over et nettverk er et langt vanskeligere\nløfte, så det praktiske svaret er en konsument der en ny levering ikke endrer noe. Styring av\nkonfigurasjon er også avhengig av egenskapen. Et verktøy som bringer servere til en deklarert\ntilstand, kjører igjen og igjen, etter hver endring og ofte etter en tidsplan, og hver kjøring må la\nen server som allerede er riktig, stå nøyaktig slik den var.\n\nDet du faktisk må avgjøre, er hvordan du får idempotens der en operasjon mangler det av natur, og\ndet finnes tre vanlige svar. Det første er design: uttrykk endringen som en måltilstand i stedet for\net steg, altså «sørg for at denne linjen står i filen» i stedet for «legg til denne linjen». Det\nandre er en nøkkel: klienten fester en unik identifikator til forespørselen, serveren lagrer den\nunder en unikhetsbegrensning, og en gjentakelse finner posten og får det opprinnelige resultatet\ntilbake i stedet for en ny handling. Det tredje er å sjekke før man handler, og slik virker de\nfleste moduler i Ansible: de sammenligner den gjeldende tilstanden med den ønskede og avslutter uten\nå gjøre noe når de to allerede stemmer overens. Hvert svar har sin pris. Design etter måltilstand\nkrever en klar modell av sluttilstanden, nøkler krever lagring og en regel for hvor lenge de\nbeholdes, og å sjekke først krever en pålitelig måte å lese den gjeldende tilstanden på.\n\n## Slik ser det ut i praksis\n\nSelskapets egne servere konfigureres med Ansible, og i det prosjektet\n[er idempotens en kontrakt: en konvergert vert rapporterer null endringer](/nb/portfolio/servers-you-can-rebuild-from-scratch/).\nDen samme klargjøringen, startet uten argumenter, skal bringe hver vert til tilstanden den er\ndeklarert med, og når den kjøres på nytt mot en vert som allerede er riktig, skal den rapportere\nnull endringer. En play som ikke klarer det, regnes som uferdig. Dermed blir idempotens noe hver\nkjøring måler, og ikke noe man håper på.\n\nDen samme tanken, brukt på data, ligger bak\n[en test som kjører hele byggepipelinen på nitten trinn to ganger](/nb/portfolio/held-the-generator-to-981-tests-and-92-coverage/).\nSiden navngir hvilken type feil testen finnes for: en generator som virker første gang og ødelegger\nandre gang, gjennom steg som setter inn uten å sjekke, eller som avhenger av rekkefølgen i utdataene\nfra et tidligere steg. Testen bygger databasen fra en tom fil, tar et øyeblikksbilde, kjører hele\npipelinen på nytt over resultatet og krever at den andre kjøringen ikke endrer noe, ned til\nradantall, innhold og identifikatorer. Testen gir dokumentasjon for gjentatte kjøringer med inndataene og databasetilstanden den prøver ut.\n\nFor salg av en begrenset beholdning kombinerer notatet om\n[å selge den siste billetten nøyaktig én gang](/nb/notes/selling-limited-stock-without-overselling/)\nen nøkkel med betingede skrivinger. Hver utsjekking har en idempotensnøkkel, og reservasjonstabellen\nhar `UNIQUE (tenant_id, idempotency_key)`, slik at et klikk som prøves på nytt, får tilbake\nreservasjonen det allerede har, i stedet for en enhet til. En frigivelse som kjører to ganger, for\neksempel fra et tidsavbrudd og en avbryt-knapp, gir enheten tilbake bare én gang, fordi den fører\nbeholdningen tilbake bare når dens egen oppdatering endret nøyaktig én rad. Lenger ut i flyten er\nhver meldingskonsument idempotent, med ordren som nøkkel: meldinger kommer minst én gang, og\nidempotensen gjør det i praksis til én gang.\n\n## Hvor det går galt\n\n**En forespørsel som prøves på nytt, belaster kunden to ganger.** En POST som oppretter en betaling,\nen ordre eller en e-post, er ikke idempotent i utgangspunktet, og en klient eller proxy som prøver\nden på nytt etter et tidsavbrudd, oppretter en til. Gi slike forespørsler en idempotensnøkkel som\nserveren lagrer under en unikhetsbegrensning, og returner det lagrede resultatet når den samme\nnøkkelen kommer igjen.\n\n**Et tomt resultat leses som en feil.** I PostgreSQL hopper `INSERT ... ON CONFLICT DO NOTHING` over\nen rad som ville brutt en unikhetsbegrensning, og `RETURNING` gir bare tilbake rader som faktisk ble\nsatt inn eller oppdatert. En gjentatt innsetting av den samme raden returnerer derfor ingenting, og\ndet er det riktige utfallet av en kjøring nummer to. Kode som behandler det tomme resultatet som en\nfeil, gjør et ufarlig nytt forsøk om til en feilside; den bør heller slå opp raden som allerede står\nder.\n\n**En kommandooppgave endrer verten ved hver kjøring.** Dokumentasjonen til Ansible sier at de fleste\nmoduler sjekker om den ønskede tilstanden allerede er nådd, og også at ikke alle playbooks og ikke\nalle moduler oppfører seg slik. En oppgave som kjører en kommando, er det vanlige unntaket, fordi\nkommandoen er vilkårlig og Ansible ikke kan vite hva den gjør. Valget `creates` i kommandomodulen\nhopper over steget når en gitt fil allerede finnes, `removes` kjører det bare mens filen fortsatt er\nder, og `changed_when` definerer hvilket utfall som teller som en endring. En kommandooppgave uten\nnoen av dem kjører igjen ved hver konvergering, uansett hvilken tilstand verten er i.\n\n**En teller teller også det nye forsøket.** Ved levering minst én gang gjør en konsument som øker en\nteller eller sender et varsel for hver melding, det to ganger for en melding som leveres to ganger.\nLagre meldingens forretningsnøkkel sammen med virkningen, i den samme transaksjonen, og hopp over\nenhver nøkkel som allerede er lagret.\n\n**Den andre kjøringen ødelegger det den første bygde.** Et steg kan være riktig på en tom database\nog galt på en full, ved at det setter inn et duplikat, nummererer om identifikatorer eller stoler på\nen rekkefølge den første kjøringen etterlot seg. En test som starter fra ingenting og kjører én\ngang, går likevel gjennom. Kjør hele jobben to ganger og krev at den andre kjøringen ikke endrer\nnoe, slik pipelinetesten ovenfor gjør.\n\n## Les mer\n\n- [RFC 9110, section 9.2.2: Idempotent Methods](https://www.rfc-editor.org/rfc/rfc9110#name-idempotent-methods)\n  — definisjonen i HTTP, de idempotente metodene og reglene for automatiske nye forsøk.\n- [RFC 5789: PATCH Method for HTTP](https://www.rfc-editor.org/rfc/rfc5789) — hvorfor PATCH verken\n  er trygg eller idempotent, og hvordan en betinget forespørsel gjør den trygg å gjenta.\n- [Ansible: Introduction to playbooks](https://docs.ansible.com/ansible/latest/playbook_guide/playbooks_intro.html)\n  — ønsket tilstand, idempotens og check mode med Ansibles egne ord.\n- [Ansible: command module](https://docs.ansible.com/ansible/latest/collections/ansible/builtin/command_module.html)\n  — valgene `creates` og `removes`, som gjør en kommando trygg å kjøre på nytt.\n- [PostgreSQL: INSERT](https://www.postgresql.org/docs/current/sql-insert.html) — `ON CONFLICT` og\n  hva `RETURNING` gir tilbake når en rad allerede finnes.\n\n\u003chttps://engineer.company/nb/glossary/idempotent/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Når en operasjon tåler å kjøres to ganger, hvor nye forsøk, køer og Ansible krever det, og tellerne, innsettingene og kommandoene som bryter det.","formats":{"gemtext":"https://engineer.company/nb/glossary/idempotent/index.gmi","gopher":"https://engineer.company/nb/glossary/idempotent/gophermap","html":"https://engineer.company/nb/glossary/idempotent/","json":"https://engineer.company/nb/glossary/idempotent/index.json","markdown":"https://engineer.company/nb/glossary/idempotent/index.md","pdf":"https://engineer.company/nb/glossary/idempotent/index.pdf"},"kind":"page","language":"nb","title":"Hva betyr idempotent?","url":"https://engineer.company/nb/glossary/idempotent/","version":1}