{"canonical_url":"https://engineer.company/da/glossary/idempotent/","content_markdown":"# Idempotent\n\n## Hvad det er\n\nEn operation er idempotent, når den har samme virkning udført flere gange som\nudført én gang, og egenskaben kaldes idempotens, på engelsk idempotence eller\nidempotency. Ordet kommer fra matematikken, hvor en funktion er idempotent, når\nden lader sit eget resultat uændret, så f(f(x)) er lig med f(x): at runde et tal\nned, der allerede er rundet ned, giver det samme tal.\n\nI software er den nyttige prøve en kørsel mere. At sætte en værdi er idempotent,\nfordi anden kørsel skriver den værdi, der allerede står der. At lægge noget til\nen værdi er det ikke, fordi anden kørsel lægger til igen:\n\n```sql\n-- idempotent: en kørsel mere sætter den samme værdi\nUPDATE accounts SET plan = 'pro' WHERE id = 42;\n\n-- ikke idempotent: en kørsel mere lægger ti til igen\nUPDATE accounts SET credits = credits + 10 WHERE id = 42;\n```\n\nHTTP giver ordet dets mest præcise definition. RFC 9110 kalder en\nforespørgselsmetode idempotent, hvis den tilsigtede virkning på serveren af\nflere ens forespørgsler er den samme som af én enkelt, og nævner PUT, DELETE og\nde sikre metoder GET, HEAD, OPTIONS og TRACE. To detaljer i definitionen er\nvigtige. Egenskaben gælder den virkning, klienten bad om, så en server må gerne\nlogge hver forespørgsel for sig. Og svaret må gerne være forskelligt: en anden\nDELETE af den samme ressource kan svare 404, hvor den første svarede 200, og\nmetoden er stadig idempotent, fordi ressourcen er væk i begge tilfælde. PATCH\nstår uden for listen. RFC 5789 siger, at den hverken er sikker eller idempotent,\nmen en klient kan sende en bestemt PATCH på en idempotent måde ved at gøre den\nbetinget med et stærkt ETag i en If-Match-header, så en gentaget kopi bliver\nafvist, når den første har ændret ressourcen.\n\nSikker er det strengeste af de to løfter. En sikker metode i RFC 9110's forstand\ner i det væsentlige kun læsende, så hver sikker metode er idempotent, mens\nDELETE er idempotent uden at være sikker.\n\n## Hvorfor det betyder noget\n\nNetværk taber svar. Når en klient sender en forespørgsel, og forbindelsen ryger,\nfør svaret når frem, kan den ikke vide, om serveren aldrig så forespørgslen, så\nden og stoppede, eller udførte den og mistede svaret. At gentage forespørgslen\ner den oplagte udvej, og idempotens er det, der gør gentagelsen ufarlig. RFC\n9110 bygger sine regler for nye forsøg på netop det. En idempotent forespørgsel\nkan gentages automatisk efter en kommunikationsfejl. En klient bør kun gentage\nen ikke-idempotent forespørgsel automatisk, hvis den ved, at forespørgslen i\npraksis er idempotent, eller kan se, at originalen aldrig blev udført, og en\nproxy må aldrig gentage en sådan af sig selv.\n\nKøer rejser samme spørgsmål i stor skala. Mange beskedsystemer lover levering\nmindst én gang: en forbruger, der går ned efter at have gjort arbejdet og før\nden har kvitteret for beskeden, får den samme besked igen. Levering præcis én\ngang over et netværk er et langt sværere løfte, så det praktiske svar er en\nforbruger, hvor en levering mere ikke gør nogen forskel. Konfigurationsstyring\nafhænger også af egenskaben. Et værktøj, der bringer servere til en erklæret\ntilstand, kører igen og igen, efter hver ændring og ofte efter en tidsplan, og\nhver kørsel skal efterlade en korrekt server præcis, som den fandt den.\n\nDen egentlige beslutning er, hvordan man får idempotens, hvor en operation\nmangler den af natur, og der er tre almindelige svar. Det første er design:\nudtryk ændringen som en måltilstand frem for et trin, altså »sørg for, at denne\nlinje står i filen« i stedet for »tilføj denne linje«. Det andet er en nøgle:\nklienten giver forespørgslen et unikt id, serveren gemmer det under en unik\nbegrænsning, og en gentagelse finder posten og får det oprindelige resultat\ntilbage i stedet for en handling mere. Det tredje er at tjekke, før man handler,\nsom de fleste Ansible-moduler gør: de sammenligner den nuværende tilstand med\nden ønskede og afslutter uden at gøre noget, når de to allerede stemmer overens.\nHvert svar har sin pris. Design efter måltilstand kræver en klar model af\nsluttilstanden, nøgler kræver lagerplads og en regel for, hvor længe de gemmes,\nog at tjekke først kræver en pålidelig måde at læse den nuværende tilstand på.\n\n## Sådan ser det ud i praksis\n\nVirksomhedens egne servere konfigureres med Ansible, og i det projekt\n[er idempotens en kontrakt: en konvergeret vært rapporterer nul ændringer](/da/portfolio/servers-you-can-rebuild-from-scratch/).\nKørt uden argumenter bringer provisioneringen hver vært i den tilstand, der er\nerklæret for den, og står værten allerede sådan, skal et play melde nul\nændringer; et play, der ikke kan det, regnes for ufærdigt. Dermed bliver\nidempotens noget, hver kørsel måler, frem for noget, man håber på.\n\nSamme idé anvendt på data ligger bag\n[en test, der kører hele pipelinen i nitten trin to gange](/da/portfolio/held-the-generator-to-981-tests-and-92-coverage/).\nSiden navngiver den slags fejl, testen er til for: en generator, der virker\nførste gang og korrumperer anden gang, gennem trin, der indsætter uden at\ntjekke, eller afhænger af rækkefølgen i et tidligere trins output. Testen bygger\ndatabasen fra en tom fil, tager et øjebliksbillede, kører hele pipelinen igen\nover resultatet og kræver, at det andet gennemløb lader alt være, ned til\nantal rækker, indhold og identifikatorer. Testen giver dokumentation for gentagne kørsler med de input og den databasetilstand, den afprøver.\n\nTil salg af et begrænset lager, hvor hver enhed kun må sælges én gang,\nkombinerer\n[en note om flash-salg](/da/notes/selling-limited-stock-without-overselling/) en\nnøgle med betingede skrivninger. Hvert checkout bærer en idempotensnøgle, og\nreservationstabellen bærer `UNIQUE (tenant_id, idempotency_key)`, så et gentaget\nklik får den reservation, det allerede har, og ikke en enhed mere. En\nfrigivelse, der kører to gange, fra en timeout og en annullér-knap for eksempel,\ngiver enheden tilbage én gang, fordi den kun giver lageret tilbage, hvis dens\negen opdatering ændrede præcis én række. Længere fremme er hver forbruger af\nbeskeder idempotent med ordren som nøgle: beskeder kommer mindst én gang, og\nidempotens gør det til i praksis én gang.\n\n## Hvor det går galt\n\n**Et nyt forsøg trækker beløbet to gange.** En POST, der opretter en betaling,\nen ordre eller en e-mail, er ikke idempotent som udgangspunkt, og en klient\neller proxy, der gentager den efter en timeout, opretter en til. Giv sådanne\nforespørgsler en idempotensnøgle, som serveren gemmer under en unik begrænsning,\nog returnér det gemte resultat, når den samme nøgle kommer igen.\n\n**Et svar uden rækker bliver læst som en fejl.** I PostgreSQL springer\n`INSERT ... ON CONFLICT DO NOTHING` en række over, der ville bryde en unik\nbegrænsning, og `RETURNING` giver kun de rækker tilbage, der faktisk blev indsat\neller opdateret. En gentaget indsættelse af den samme række returnerer derfor\ningen rækker, hvilket er det korrekte udfald af en kørsel mere. Kode, der\nbehandler det svar som en fejl, gør et ufarligt nyt forsøg til en fejlside; den\nbør slå den række op, der allerede ligger der.\n\n**En kommandoopgave ændrer værten ved hver kørsel.** Ansibles dokumentation\nsiger, at de fleste moduler tjekker, om den ønskede tilstand allerede er nået,\nog også, at ikke alle playbooks og ikke alle moduler opfører sig sådan. En\nopgave, der kører en kommando, er den typiske undtagelse, fordi kommandoen er\nvilkårlig, og Ansible har ingen måde at vide, hvad den gør. Kommandomodulets\n`creates` springer trinnet over, når en given fil allerede findes, `removes`\nkører det kun, mens filen stadig er der, og `changed_when` bestemmer, hvilket\nudfald der tæller som en ændring. En kommandoopgave uden nogen af dem kører igen\nved hver konvergering, uanset hvilken tilstand værten er i.\n\n**En tæller tæller det nye forsøg med.** Ved levering mindst én gang gør en\nforbruger, der tæller en tæller op eller sender en notifikation for hver besked,\ndet to gange for en besked, der leveres to gange. Gem beskedens forretningsnøgle\nsammen med virkningen i samme transaktion, og spring enhver nøgle over, der\nallerede er gemt.\n\n**Anden kørsel ødelægger det, den første byggede.** Et trin kan være korrekt på\nen tom database og forkert på en fuld, fordi det indsætter en dublet, nummererer\nidentifikatorer om eller bygger på en rækkefølge, den første kørsel efterlod. En\ntest, der starter fra ingenting og kører én gang, består alligevel. Kør hele\njobbet to gange, og kræv, at anden kørsel lader alt være, som pipelinetesten\novenfor gør.\n\n## Læs mere\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 idempotente metoder og reglerne for automatiske nye\n  forsøg.\n- [RFC 5789: PATCH Method for HTTP](https://www.rfc-editor.org/rfc/rfc5789) —\n  hvorfor PATCH hverken er sikker eller idempotent, og hvordan en betinget\n  forespørgsel gør den sikker at gentage.\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  — `creates` og `removes`, de indstillinger, der gør en kommando sikker at\n  køre igen.\n- [PostgreSQL: INSERT](https://www.postgresql.org/docs/current/sql-insert.html)\n  — `ON CONFLICT`, og hvad `RETURNING` giver tilbage, når en række allerede\n  findes.\n\n\u003chttps://engineer.company/da/glossary/idempotent/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Hvad der gør en operation idempotent, hvornår et nyt forsøg, en ny kørsel eller en dobbelt besked kræver det, og de tællere og kommandoer, der bryder det.","formats":{"gemtext":"https://engineer.company/da/glossary/idempotent/index.gmi","gopher":"https://engineer.company/da/glossary/idempotent/gophermap","html":"https://engineer.company/da/glossary/idempotent/","json":"https://engineer.company/da/glossary/idempotent/index.json","markdown":"https://engineer.company/da/glossary/idempotent/index.md","pdf":"https://engineer.company/da/glossary/idempotent/index.pdf"},"kind":"page","language":"da","title":"Hvad betyder idempotent?","url":"https://engineer.company/da/glossary/idempotent/","version":1}