[{"data":1,"prerenderedAt":1414},["ShallowReactive",2],{"navigation_docs":3,"-backend-development-transactions":377,"-backend-development-transactions-surround":1409},[4,39,114,144,184,244,293,362],{"title":5,"icon":6,"path":7,"stem":8,"children":9,"page":6},"Getting Started",false,"\u002Fgetting-started","1.getting-started",[10,15,20,25,30,35],{"title":11,"path":12,"stem":13,"icon":14},"Learning Path","\u002Fgetting-started\u002Flearning-path","1.getting-started\u002F1.learning-path","i-lucide-map",{"title":16,"path":17,"stem":18,"icon":19},"Introduction","\u002Fgetting-started\u002Fintroduction","1.getting-started\u002F2.introduction","i-lucide-house",{"title":21,"path":22,"stem":23,"icon":24},"Installation","\u002Fgetting-started\u002Finstallation","1.getting-started\u002F3.installation","i-lucide-download",{"title":26,"path":27,"stem":28,"icon":29},"Your First Program","\u002Fgetting-started\u002Ffirst-program","1.getting-started\u002F4.first-program","i-lucide-play",{"title":31,"path":32,"stem":33,"icon":34},"Modules and Dependencies","\u002Fgetting-started\u002Fmodules-and-dependencies","1.getting-started\u002F5.modules-and-dependencies","i-lucide-package-open",{"title":36,"path":37,"stem":38,"icon":34},"Advanced Modules","\u002Fgetting-started\u002Fadvanced-modules","1.getting-started\u002F6.advanced-modules",{"title":40,"path":41,"stem":42,"children":43,"page":6},"Fundamentals","\u002Ffundamentals","2.fundamentals",[44,49,54,59,64,69,74,79,84,89,94,99,104,109],{"title":45,"path":46,"stem":47,"icon":48},"Program Structure","\u002Ffundamentals\u002Fprogram-structure","2.fundamentals\u002F1.program-structure","i-lucide-workflow",{"title":50,"path":51,"stem":52,"icon":53},"Structs and Methods","\u002Ffundamentals\u002Fstructs-and-methods","2.fundamentals\u002F10.structs-and-methods","i-lucide-box",{"title":55,"path":56,"stem":57,"icon":58},"Interfaces","\u002Ffundamentals\u002Finterfaces","2.fundamentals\u002F11.interfaces","i-lucide-plug",{"title":60,"path":61,"stem":62,"icon":63},"Error Handling","\u002Ffundamentals\u002Ferrors","2.fundamentals\u002F12.errors","i-lucide-triangle-alert",{"title":65,"path":66,"stem":67,"icon":68},"Defined Types and Type Aliases","\u002Ffundamentals\u002Fdefined-types","2.fundamentals\u002F13.defined-types","i-lucide-tags",{"title":70,"path":71,"stem":72,"icon":73},"Generics","\u002Ffundamentals\u002Fgenerics","2.fundamentals\u002F14.generics","i-lucide-blocks",{"title":75,"path":76,"stem":77,"icon":78},"Project Structure","\u002Ffundamentals\u002Fproject-structure","2.fundamentals\u002F2.project-structure","i-lucide-folder-tree",{"title":80,"path":81,"stem":82,"icon":83},"Project Layout","\u002Ffundamentals\u002Fproject-layout","2.fundamentals\u002F3.project-layout","i-lucide-layout",{"title":85,"path":86,"stem":87,"icon":88},"Variables and Data Types","\u002Ffundamentals\u002Fvariables-and-types","2.fundamentals\u002F4.variables-and-types","i-lucide-variable",{"title":90,"path":91,"stem":92,"icon":93},"Functions","\u002Ffundamentals\u002Ffunctions","2.fundamentals\u002F5.functions","i-lucide-braces",{"title":95,"path":96,"stem":97,"icon":98},"Control Statements","\u002Ffundamentals\u002Fcontrol-statements","2.fundamentals\u002F6.control-statements","i-lucide-git-branch",{"title":100,"path":101,"stem":102,"icon":103},"Pointers","\u002Ffundamentals\u002Fpointers","2.fundamentals\u002F7.pointers","i-lucide-mouse-pointer-2",{"title":105,"path":106,"stem":107,"icon":108},"Arrays and Slices","\u002Ffundamentals\u002Farrays-and-slices","2.fundamentals\u002F8.arrays-and-slices","i-lucide-list",{"title":110,"path":111,"stem":112,"icon":113},"Maps","\u002Ffundamentals\u002Fmaps","2.fundamentals\u002F9.maps","i-lucide-table-properties",{"title":115,"path":116,"stem":117,"children":118,"page":6},"Concurrency","\u002Fconcurrency","3.concurrency",[119,124,129,134,139],{"title":120,"path":121,"stem":122,"icon":123},"Concurrency Model","\u002Fconcurrency\u002Fconcurrency-model","3.concurrency\u002F1.concurrency-model","i-lucide-network",{"title":125,"path":126,"stem":127,"icon":128},"Goroutines","\u002Fconcurrency\u002Fgoroutines","3.concurrency\u002F2.goroutines","i-lucide-git-fork",{"title":130,"path":131,"stem":132,"icon":133},"Channels","\u002Fconcurrency\u002Fchannels","3.concurrency\u002F3.channels","i-lucide-arrow-left-right",{"title":135,"path":136,"stem":137,"icon":138},"Select and Cancellation","\u002Fconcurrency\u002Fselect-and-cancellation","3.concurrency\u002F4.select-and-cancellation","i-lucide-circle-stop",{"title":140,"path":141,"stem":142,"icon":143},"Synchronization","\u002Fconcurrency\u002Fsynchronization","3.concurrency\u002F5.synchronization","i-lucide-lock-keyhole",{"title":145,"path":146,"stem":147,"children":148,"page":6},"Standard Library","\u002Fstandard-library","4.standard-library",[149,154,159,164,169,174,179],{"title":150,"path":151,"stem":152,"icon":153},"Standard Library Overview","\u002Fstandard-library\u002Foverview","4.standard-library\u002F1.overview","i-lucide-library",{"title":155,"path":156,"stem":157,"icon":158},"Text and Formatting","\u002Fstandard-library\u002Ftext-and-formatting","4.standard-library\u002F2.text-and-formatting","i-lucide-text",{"title":160,"path":161,"stem":162,"icon":163},"Files and JSON","\u002Fstandard-library\u002Ffiles-and-json","4.standard-library\u002F3.files-and-json","i-lucide-file-json",{"title":165,"path":166,"stem":167,"icon":168},"HTTP Clients and Servers","\u002Fstandard-library\u002Fhttp","4.standard-library\u002F4.http","i-lucide-server",{"title":170,"path":171,"stem":172,"icon":173},"Testing","\u002Fstandard-library\u002Ftesting","4.standard-library\u002F5.testing","i-lucide-flask-conical",{"title":175,"path":176,"stem":177,"icon":178},"Command-Line Tools and Configuration","\u002Fstandard-library\u002Fcommand-line-and-configuration","4.standard-library\u002F6.command-line-and-configuration","i-lucide-terminal-square",{"title":180,"path":181,"stem":182,"icon":183},"Structured Logging","\u002Fstandard-library\u002Fstructured-logging","4.standard-library\u002F7.structured-logging","i-lucide-scroll-text",{"title":185,"path":186,"stem":187,"children":188,"page":6},"Backend Development","\u002Fbackend-development","5.backend-development",[189,194,199,204,209,214,219,224,229,234,239],{"title":190,"path":191,"stem":192,"icon":193},"Backend Roadmap","\u002Fbackend-development\u002Fbackend-roadmap","5.backend-development\u002F1.backend-roadmap","i-lucide-route",{"title":195,"path":196,"stem":197,"icon":198},"Graceful Shutdown","\u002Fbackend-development\u002Fgraceful-shutdown","5.backend-development\u002F10.graceful-shutdown","i-lucide-power",{"title":200,"path":201,"stem":202,"icon":203},"Production Checklist","\u002Fbackend-development\u002Fproduction-checklist","5.backend-development\u002F11.production-checklist","i-lucide-clipboard-check",{"title":205,"path":206,"stem":207,"icon":208},"HTTP API Design","\u002Fbackend-development\u002Fhttp-api-design","5.backend-development\u002F2.http-api-design","i-lucide-waypoints",{"title":210,"path":211,"stem":212,"icon":213},"Middleware","\u002Fbackend-development\u002Fmiddleware","5.backend-development\u002F3.middleware","i-lucide-layers-3",{"title":215,"path":216,"stem":217,"icon":218},"Validation","\u002Fbackend-development\u002Fvalidation","5.backend-development\u002F4.validation","i-lucide-list-checks",{"title":220,"path":221,"stem":222,"icon":223},"Application Wiring","\u002Fbackend-development\u002Fapplication-wiring","5.backend-development\u002F5.application-wiring","i-lucide-cable",{"title":225,"path":226,"stem":227,"icon":228},"Observability","\u002Fbackend-development\u002Fobservability","5.backend-development\u002F6.observability","i-lucide-activity",{"title":230,"path":231,"stem":232,"icon":233},"Database SQL","\u002Fbackend-development\u002Fdatabase-sql","5.backend-development\u002F7.database-sql","i-lucide-database",{"title":235,"path":236,"stem":237,"icon":238},"Transactions","\u002Fbackend-development\u002Ftransactions","5.backend-development\u002F8.transactions","i-lucide-repeat-2",{"title":240,"path":241,"stem":242,"icon":243},"Authentication and Authorization","\u002Fbackend-development\u002Fauthentication","5.backend-development\u002F9.authentication","i-lucide-shield-check",{"title":245,"path":246,"stem":247,"children":248,"page":6},"Advanced Go","\u002Fadvanced-go","6.advanced-go",[249,254,259,264,269,274,278,283,288],{"title":250,"path":251,"stem":252,"icon":253},"Advanced Go Roadmap","\u002Fadvanced-go\u002Fadvanced-roadmap","6.advanced-go\u002F1.advanced-roadmap","i-lucide-brain-circuit",{"title":255,"path":256,"stem":257,"icon":258},"Reflection","\u002Fadvanced-go\u002Freflection","6.advanced-go\u002F2.reflection","i-lucide-scan-search",{"title":260,"path":261,"stem":262,"icon":263},"Memory and Garbage Collection","\u002Fadvanced-go\u002Fmemory-and-garbage-collection","6.advanced-go\u002F3.memory-and-garbage-collection","i-lucide-memory-stick",{"title":265,"path":266,"stem":267,"icon":268},"Benchmarking and Profiling","\u002Fadvanced-go\u002Fbenchmarking-and-profiling","6.advanced-go\u002F4.benchmarking-and-profiling","i-lucide-gauge",{"title":270,"path":271,"stem":272,"icon":273},"Advanced Testing and Fuzzing","\u002Fadvanced-go\u002Fadvanced-testing-and-fuzzing","6.advanced-go\u002F5.advanced-testing-and-fuzzing","i-lucide-microscope",{"title":275,"path":276,"stem":277,"icon":48},"Advanced Concurrency","\u002Fadvanced-go\u002Fadvanced-concurrency","6.advanced-go\u002F6.advanced-concurrency",{"title":279,"path":280,"stem":281,"icon":282},"Unsafe and C Boundaries","\u002Fadvanced-go\u002Funsafe-and-cgo","6.advanced-go\u002F7.unsafe-and-cgo","i-lucide-radiation",{"title":284,"path":285,"stem":286,"icon":287},"Package and API Design","\u002Fadvanced-go\u002Fpackage-and-api-design","6.advanced-go\u002F8.package-and-api-design","i-lucide-boxes",{"title":289,"path":290,"stem":291,"icon":292},"Distributed Reliability","\u002Fadvanced-go\u002Fdistributed-reliability","6.advanced-go\u002F9.distributed-reliability","i-lucide-cloud-cog",{"title":294,"path":295,"stem":296,"children":297,"page":6},"Projects","\u002Fprojects","7.projects",[298,316,332,347],{"title":299,"path":300,"stem":301,"children":302,"icon":305},"CLI Task Manager","\u002Fprojects\u002Fcli-task-manager","7.projects\u002F1.cli-task-manager\u002Findex",[303,306,311],{"title":304,"path":300,"stem":301,"icon":305},"Project — CLI Task Manager","i-lucide-list-todo",{"title":307,"path":308,"stem":309,"icon":310},"CLI — Domain and Storage","\u002Fprojects\u002Fcli-task-manager\u002Fdomain-and-storage","7.projects\u002F1.cli-task-manager\u002F1.domain-and-storage","i-lucide-save",{"title":312,"path":313,"stem":314,"icon":315},"CLI — Commands and Tests","\u002Fprojects\u002Fcli-task-manager\u002Fcommands-and-tests","7.projects\u002F1.cli-task-manager\u002F2.commands-and-tests","i-lucide-terminal",{"title":317,"path":318,"stem":319,"children":320,"icon":323},"Concurrent URL Checker","\u002Fprojects\u002Fconcurrent-url-checker","7.projects\u002F2.concurrent-url-checker\u002Findex",[321,324,328],{"title":322,"path":318,"stem":319,"icon":323},"Project — Concurrent URL Checker","i-lucide-radar",{"title":325,"path":326,"stem":327,"icon":128},"URL Checker — Worker Pipeline","\u002Fprojects\u002Fconcurrent-url-checker\u002Fworker-pipeline","7.projects\u002F2.concurrent-url-checker\u002F1.worker-pipeline",{"title":329,"path":330,"stem":331,"icon":173},"URL Checker — Cancellation and Tests","\u002Fprojects\u002Fconcurrent-url-checker\u002Fcancellation-and-tests","7.projects\u002F2.concurrent-url-checker\u002F2.cancellation-and-tests",{"title":333,"path":334,"stem":335,"children":336},"File-backed API","\u002Fprojects\u002Ffile-backed-api","7.projects\u002F3.file-backed-api\u002Findex",[337,339,343],{"title":338,"path":334,"stem":335},"File-backed notes API",{"title":340,"path":341,"stem":342},"File store and concurrency","\u002Fprojects\u002Ffile-backed-api\u002Ffile-store-and-concurrency","7.projects\u002F3.file-backed-api\u002F1.file-store-and-concurrency",{"title":344,"path":345,"stem":346},"HTTP layer and tests","\u002Fprojects\u002Ffile-backed-api\u002Fhttp-and-tests","7.projects\u002F3.file-backed-api\u002F2.http-and-tests",{"title":348,"path":349,"stem":350,"children":351},"Production REST API","\u002Fprojects\u002Fproduction-rest-api","7.projects\u002F4.production-rest-api\u002Findex",[352,354,358],{"title":353,"path":349,"stem":350},"Production REST API capstone",{"title":355,"path":356,"stem":357},"Persistence and authentication","\u002Fprojects\u002Fproduction-rest-api\u002Fpersistence-and-auth","7.projects\u002F4.production-rest-api\u002F1.persistence-and-auth",{"title":359,"path":360,"stem":361},"Operations and release","\u002Fprojects\u002Fproduction-rest-api\u002Foperations-and-release","7.projects\u002F4.production-rest-api\u002F2.operations-and-release",{"title":363,"path":364,"stem":365,"children":366,"page":6},"Meta","\u002Fmeta","99.meta",[367,372],{"title":368,"path":369,"stem":370,"icon":371},"About","\u002Fmeta\u002Fabout","99.meta\u002F1.about","i-lucide-info",{"title":373,"path":374,"stem":375,"icon":376},"Acknowledgements","\u002Fmeta\u002Facknowledgements","99.meta\u002F2.acknowledgements","i-lucide-heart-handshake",{"id":378,"title":235,"body":379,"description":1401,"extension":1402,"links":1403,"meta":1404,"navigation":1405,"path":236,"seo":1406,"stem":237,"__hash__":1408},"docs\u002F5.backend-development\u002F8.transactions.md",{"type":380,"value":381,"toc":1387},"minimark",[382,388,393,397,425,429,432,435,439,831,838,842,853,912,919,923,926,1089,1092,1096,1103,1167,1170,1173,1177,1180,1197,1200,1204,1207,1210,1213,1217,1220,1223,1227,1272,1276,1283,1343,1347,1367,1377,1380,1383],[383,384],"learning-lesson-meta",{"level":385,"prerequisites":386,"time":387},"Advanced","Database SQL, context, errors, and database transaction basics","50–65 minutes",[389,390,392],"h2",{"id":391},"what-you-will-learn","What you will learn",[394,395,396],"p",{},"By the end of this lesson, you will be able to:",[398,399,400,404,412,419,422],"ul",{},[401,402,403],"li",{},"decide when several database operations require a transaction;",[401,405,406,407,411],{},"use ",[408,409,410],"code",{},"BeginTx",", deferred rollback, and commit correctly;",[401,413,414,415,418],{},"keep every transactional query on ",[408,416,417],{},"*sql.Tx",";",[401,420,421],{},"reason about isolation and retryable conflicts;",[401,423,424],{},"avoid pretending a database transaction includes external side effects.",[389,426,428],{"id":427},"mental-model-one-atomic-database-decision","Mental model: one atomic database decision",[394,430,431],{},"A transaction groups database operations so they commit together or do not commit at all.",[394,433,434],{},"For example, transferring credits requires both account changes. Applying only one would violate the business invariant.",[389,436,438],{"id":437},"the-standard-pattern","The standard pattern",[440,441,446],"pre",{"className":442,"code":443,"language":444,"meta":445,"style":445},"language-go shiki shiki-themes solarized-light material-theme one-dark-pro","func (r *Repository) Transfer(ctx context.Context, fromID, toID string, amount int64) error {\n    tx, err := r.database.BeginTx(ctx, nil)\n    if err != nil {\n        return fmt.Errorf(\"begin transfer: %w\", err)\n    }\n    defer tx.Rollback()\n\n    if err := debit(ctx, tx, fromID, amount); err != nil {\n        return err\n    }\n    if err := credit(ctx, tx, toID, amount); err != nil {\n        return err\n    }\n\n    if err := tx.Commit(); err != nil {\n        return fmt.Errorf(\"commit transfer: %w\", err)\n    }\n    return nil\n}\n","go","",[408,447,448,525,566,583,619,625,642,649,688,696,701,739,746,751,756,783,811,816,825],{"__ignoreMap":445},[449,450,453,457,461,465,468,472,475,479,482,485,488,491,494,497,500,502,505,509,511,514,517,519,522],"span",{"class":451,"line":452},"line",1,[449,454,456],{"class":455},"sEOdo","func",[449,458,460],{"class":459},"shFME"," (",[449,462,464],{"class":463},"syre3","r ",[449,466,467],{"class":455},"*",[449,469,471],{"class":470},"snwKR","Repository",[449,473,474],{"class":459},")",[449,476,478],{"class":477},"sisdC"," Transfer",[449,480,481],{"class":459},"(",[449,483,484],{"class":463},"ctx",[449,486,487],{"class":470}," context",[449,489,490],{"class":459},".",[449,492,493],{"class":470},"Context",[449,495,496],{"class":459},",",[449,498,499],{"class":463}," fromID",[449,501,496],{"class":459},[449,503,504],{"class":463}," toID",[449,506,508],{"class":507},"sF6sA"," string",[449,510,496],{"class":459},[449,512,513],{"class":463}," amount",[449,515,516],{"class":507}," int64",[449,518,474],{"class":459},[449,520,521],{"class":507}," error",[449,523,524],{"class":459}," {\n",[449,526,528,532,534,537,541,544,546,549,551,553,555,557,559,563],{"class":451,"line":527},2,[449,529,531],{"class":530},"s45-6","    tx",[449,533,496],{"class":459},[449,535,536],{"class":530}," err",[449,538,540],{"class":539},"su2KV"," :=",[449,542,543],{"class":530}," r",[449,545,490],{"class":459},[449,547,548],{"class":530},"database",[449,550,490],{"class":459},[449,552,410],{"class":477},[449,554,481],{"class":459},[449,556,484],{"class":530},[449,558,496],{"class":459},[449,560,562],{"class":561},"sp8Z5"," nil",[449,564,565],{"class":459},")\n",[449,567,569,573,575,579,581],{"class":451,"line":568},3,[449,570,572],{"class":571},"s7Bcg","    if",[449,574,536],{"class":530},[449,576,578],{"class":577},"sRBoR"," !=",[449,580,562],{"class":561},[449,582,524],{"class":459},[449,584,586,589,592,594,597,599,603,607,611,613,615,617],{"class":451,"line":585},4,[449,587,588],{"class":571},"        return",[449,590,591],{"class":530}," fmt",[449,593,490],{"class":459},[449,595,596],{"class":477},"Errorf",[449,598,481],{"class":459},[449,600,602],{"class":601},"sED5a","\"",[449,604,606],{"class":605},"sVazx","begin transfer: ",[449,608,610],{"class":609},"st3jj","%w",[449,612,602],{"class":601},[449,614,496],{"class":459},[449,616,536],{"class":530},[449,618,565],{"class":459},[449,620,622],{"class":451,"line":621},5,[449,623,624],{"class":459},"    }\n",[449,626,628,631,634,636,639],{"class":451,"line":627},6,[449,629,630],{"class":571},"    defer",[449,632,633],{"class":530}," tx",[449,635,490],{"class":459},[449,637,638],{"class":477},"Rollback",[449,640,641],{"class":459},"()\n",[449,643,645],{"class":451,"line":644},7,[449,646,648],{"emptyLinePlaceholder":647},true,"\n",[449,650,652,654,656,658,661,663,665,667,669,671,673,675,677,680,682,684,686],{"class":451,"line":651},8,[449,653,572],{"class":571},[449,655,536],{"class":530},[449,657,540],{"class":539},[449,659,660],{"class":477}," debit",[449,662,481],{"class":459},[449,664,484],{"class":530},[449,666,496],{"class":459},[449,668,633],{"class":530},[449,670,496],{"class":459},[449,672,499],{"class":530},[449,674,496],{"class":459},[449,676,513],{"class":530},[449,678,679],{"class":459},");",[449,681,536],{"class":530},[449,683,578],{"class":577},[449,685,562],{"class":561},[449,687,524],{"class":459},[449,689,691,693],{"class":451,"line":690},9,[449,692,588],{"class":571},[449,694,695],{"class":530}," err\n",[449,697,699],{"class":451,"line":698},10,[449,700,624],{"class":459},[449,702,704,706,708,710,713,715,717,719,721,723,725,727,729,731,733,735,737],{"class":451,"line":703},11,[449,705,572],{"class":571},[449,707,536],{"class":530},[449,709,540],{"class":539},[449,711,712],{"class":477}," credit",[449,714,481],{"class":459},[449,716,484],{"class":530},[449,718,496],{"class":459},[449,720,633],{"class":530},[449,722,496],{"class":459},[449,724,504],{"class":530},[449,726,496],{"class":459},[449,728,513],{"class":530},[449,730,679],{"class":459},[449,732,536],{"class":530},[449,734,578],{"class":577},[449,736,562],{"class":561},[449,738,524],{"class":459},[449,740,742,744],{"class":451,"line":741},12,[449,743,588],{"class":571},[449,745,695],{"class":530},[449,747,749],{"class":451,"line":748},13,[449,750,624],{"class":459},[449,752,754],{"class":451,"line":753},14,[449,755,648],{"emptyLinePlaceholder":647},[449,757,759,761,763,765,767,769,772,775,777,779,781],{"class":451,"line":758},15,[449,760,572],{"class":571},[449,762,536],{"class":530},[449,764,540],{"class":539},[449,766,633],{"class":530},[449,768,490],{"class":459},[449,770,771],{"class":477},"Commit",[449,773,774],{"class":459},"();",[449,776,536],{"class":530},[449,778,578],{"class":577},[449,780,562],{"class":561},[449,782,524],{"class":459},[449,784,786,788,790,792,794,796,798,801,803,805,807,809],{"class":451,"line":785},16,[449,787,588],{"class":571},[449,789,591],{"class":530},[449,791,490],{"class":459},[449,793,596],{"class":477},[449,795,481],{"class":459},[449,797,602],{"class":601},[449,799,800],{"class":605},"commit transfer: ",[449,802,610],{"class":609},[449,804,602],{"class":601},[449,806,496],{"class":459},[449,808,536],{"class":530},[449,810,565],{"class":459},[449,812,814],{"class":451,"line":813},17,[449,815,624],{"class":459},[449,817,819,822],{"class":451,"line":818},18,[449,820,821],{"class":571},"    return",[449,823,824],{"class":561}," nil\n",[449,826,828],{"class":451,"line":827},19,[449,829,830],{"class":459},"}\n",[394,832,833,834,837],{},"The deferred rollback is safe after a successful commit; it returns ",[408,835,836],{},"sql.ErrTxDone",", which is intentionally ignored. Its purpose is to roll back every early return.",[389,839,841],{"id":840},"use-only-the-transaction-handle","Use only the transaction handle",[394,843,844,845,848,849,852],{},"Inside the transaction, every related query must use ",[408,846,847],{},"tx",", not the original ",[408,850,851],{},"*sql.DB",":",[440,854,856],{"className":442,"code":855,"language":444,"meta":445,"style":445},"tx.ExecContext(ctx, query, args...)\ntx.QueryRowContext(ctx, query, args...)\n",[408,857,858,887],{"__ignoreMap":445},[449,859,860,862,864,867,869,871,873,876,878,881,885],{"class":451,"line":452},[449,861,847],{"class":530},[449,863,490],{"class":459},[449,865,866],{"class":477},"ExecContext",[449,868,481],{"class":459},[449,870,484],{"class":530},[449,872,496],{"class":459},[449,874,875],{"class":530}," query",[449,877,496],{"class":459},[449,879,880],{"class":530}," args",[449,882,884],{"class":883},"sN42N","...",[449,886,565],{"class":459},[449,888,889,891,893,896,898,900,902,904,906,908,910],{"class":451,"line":527},[449,890,847],{"class":530},[449,892,490],{"class":459},[449,894,895],{"class":477},"QueryRowContext",[449,897,481],{"class":459},[449,899,484],{"class":530},[449,901,496],{"class":459},[449,903,875],{"class":530},[449,905,496],{"class":459},[449,907,880],{"class":530},[449,909,884],{"class":883},[449,911,565],{"class":459},[394,913,914,915,918],{},"Calling ",[408,916,917],{},"db.QueryContext"," in the middle may use another connection outside the transaction, producing inconsistent state or blocking behaviour.",[389,920,922],{"id":921},"accept-a-small-query-interface","Accept a small query interface",[394,924,925],{},"Helpers can work with both a database and a transaction when their required methods match:",[440,927,929],{"className":442,"code":928,"language":444,"meta":445,"style":445},"type Queryer interface {\n    ExecContext(context.Context, string, ...any) (sql.Result, error)\n    QueryRowContext(context.Context, string, ...any) *sql.Row\n}\n\nfunc debit(ctx context.Context, q Queryer, accountID string, amount int64) error {\n    \u002F\u002F Execute a bounded, parameterized update through q.\n    return nil\n}\n",[408,930,931,944,988,1023,1027,1031,1073,1079,1085],{"__ignoreMap":445},[449,932,933,936,939,942],{"class":451,"line":452},[449,934,935],{"class":455},"type",[449,937,938],{"class":470}," Queryer",[449,940,941],{"class":455}," interface",[449,943,524],{"class":459},[449,945,946,949,951,954,956,958,960,962,964,967,970,972,974,977,979,982,984,986],{"class":451,"line":527},[449,947,948],{"class":477},"    ExecContext",[449,950,481],{"class":459},[449,952,953],{"class":470},"context",[449,955,490],{"class":459},[449,957,493],{"class":470},[449,959,496],{"class":459},[449,961,508],{"class":507},[449,963,496],{"class":459},[449,965,966],{"class":883}," ...",[449,968,969],{"class":470},"any",[449,971,474],{"class":459},[449,973,460],{"class":459},[449,975,976],{"class":470},"sql",[449,978,490],{"class":459},[449,980,981],{"class":470},"Result",[449,983,496],{"class":459},[449,985,521],{"class":507},[449,987,565],{"class":459},[449,989,990,993,995,997,999,1001,1003,1005,1007,1009,1011,1013,1016,1018,1020],{"class":451,"line":568},[449,991,992],{"class":477},"    QueryRowContext",[449,994,481],{"class":459},[449,996,953],{"class":470},[449,998,490],{"class":459},[449,1000,493],{"class":470},[449,1002,496],{"class":459},[449,1004,508],{"class":507},[449,1006,496],{"class":459},[449,1008,966],{"class":883},[449,1010,969],{"class":470},[449,1012,474],{"class":459},[449,1014,1015],{"class":455}," *",[449,1017,976],{"class":470},[449,1019,490],{"class":459},[449,1021,1022],{"class":470},"Row\n",[449,1024,1025],{"class":451,"line":585},[449,1026,830],{"class":459},[449,1028,1029],{"class":451,"line":621},[449,1030,648],{"emptyLinePlaceholder":647},[449,1032,1033,1035,1037,1039,1041,1043,1045,1047,1049,1052,1054,1056,1059,1061,1063,1065,1067,1069,1071],{"class":451,"line":627},[449,1034,456],{"class":455},[449,1036,660],{"class":477},[449,1038,481],{"class":459},[449,1040,484],{"class":463},[449,1042,487],{"class":470},[449,1044,490],{"class":459},[449,1046,493],{"class":470},[449,1048,496],{"class":459},[449,1050,1051],{"class":463}," q",[449,1053,938],{"class":470},[449,1055,496],{"class":459},[449,1057,1058],{"class":463}," accountID",[449,1060,508],{"class":507},[449,1062,496],{"class":459},[449,1064,513],{"class":463},[449,1066,516],{"class":507},[449,1068,474],{"class":459},[449,1070,521],{"class":507},[449,1072,524],{"class":459},[449,1074,1075],{"class":451,"line":644},[449,1076,1078],{"class":1077},"sJsHy","    \u002F\u002F Execute a bounded, parameterized update through q.\n",[449,1080,1081,1083],{"class":451,"line":651},[449,1082,821],{"class":571},[449,1084,824],{"class":561},[449,1086,1087],{"class":451,"line":690},[449,1088,830],{"class":459},[394,1090,1091],{},"Keep the interface local to the consumer and include only the operations it uses.",[389,1093,1095],{"id":1094},"isolation-and-locking","Isolation and locking",[394,1097,1098,1099,1102],{},"Concurrent transactions can observe or overwrite state depending on the database, query shape, and isolation level. ",[408,1100,1101],{},"sql.TxOptions"," can request an isolation level:",[440,1104,1106],{"className":442,"code":1105,"language":444,"meta":445,"style":445},"tx, err := database.BeginTx(ctx, &sql.TxOptions{\n    Isolation: sql.LevelSerializable,\n})\n",[408,1107,1108,1144,1162],{"__ignoreMap":445},[449,1109,1110,1112,1114,1116,1118,1121,1123,1125,1127,1129,1131,1134,1136,1138,1141],{"class":451,"line":452},[449,1111,847],{"class":530},[449,1113,496],{"class":459},[449,1115,536],{"class":530},[449,1117,540],{"class":539},[449,1119,1120],{"class":530}," database",[449,1122,490],{"class":459},[449,1124,410],{"class":477},[449,1126,481],{"class":459},[449,1128,484],{"class":530},[449,1130,496],{"class":459},[449,1132,1133],{"class":455}," &",[449,1135,976],{"class":470},[449,1137,490],{"class":459},[449,1139,1140],{"class":470},"TxOptions",[449,1142,1143],{"class":459},"{\n",[449,1145,1146,1149,1151,1154,1156,1159],{"class":451,"line":527},[449,1147,1148],{"class":530},"    Isolation",[449,1150,852],{"class":459},[449,1152,1153],{"class":530}," sql",[449,1155,490],{"class":459},[449,1157,1158],{"class":530},"LevelSerializable",[449,1160,1161],{"class":459},",\n",[449,1163,1164],{"class":451,"line":568},[449,1165,1166],{"class":459},"})\n",[394,1168,1169],{},"Drivers and databases differ in supported levels and exact behaviour. Read the database documentation and design queries and constraints for the invariant being protected.",[394,1171,1172],{},"Higher isolation may increase waiting or transaction aborts. It is not a substitute for understanding the access pattern.",[389,1174,1176],{"id":1175},"retrying-conflicts","Retrying conflicts",[394,1178,1179],{},"Some serialization failures or deadlocks may be safe to retry. Retry only when:",[398,1181,1182,1185,1188,1191,1194],{},[401,1183,1184],{},"the database\u002Fdriver error is positively classified as retryable;",[401,1186,1187],{},"the complete operation is safe to repeat;",[401,1189,1190],{},"attempts are bounded;",[401,1192,1193],{},"backoff respects context cancellation;",[401,1195,1196],{},"the final error preserves useful context.",[394,1198,1199],{},"Do not retry every error. Syntax errors, validation failures, and most constraint violations will not improve.",[389,1201,1203],{"id":1202},"external-side-effects-are-not-included","External side effects are not included",[394,1205,1206],{},"A database transaction cannot roll back an email, HTTP request, or message already sent to another system.",[394,1208,1209],{},"For reliable event publication, one common pattern writes both domain state and an outbox record in the same transaction. A separate worker later publishes the outbox entry and records progress with idempotent handling.",[394,1211,1212],{},"This pattern provides durable coordination; it does not create a magical transaction across unrelated systems.",[389,1214,1216],{"id":1215},"keep-transactions-short","Keep transactions short",[394,1218,1219],{},"Do not wait for user input, call slow remote APIs, or perform large unrelated computation while holding a transaction. Long transactions retain connections and locks, increasing contention.",[394,1221,1222],{},"Prepare external input first, transact only the required database work, commit, then perform post-commit behaviour designed for failure.",[389,1224,1226],{"id":1225},"common-mistakes","Common mistakes",[398,1228,1229,1236,1248,1254,1260,1266],{},[401,1230,1231,1235],{},[1232,1233,1234],"strong",{},"Forgetting deferred rollback:"," an early return can leave resources tied up until cancellation or cleanup.",[401,1237,1238,1247],{},[1232,1239,1240,1241,1244,1245,852],{},"Using ",[408,1242,1243],{},"db"," during ",[408,1246,847],{}," work silently occurs outside the transaction.",[401,1249,1250,1253],{},[1232,1251,1252],{},"Ignoring commit failure:"," a successful final statement does not prove the commit succeeded.",[401,1255,1256,1259],{},[1232,1257,1258],{},"Calling an external API before commit:"," the API side effect remains when the database rolls back.",[401,1261,1262,1265],{},[1232,1263,1264],{},"Retrying an operation containing non-idempotent side effects:"," duplicate work can occur.",[401,1267,1268,1271],{},[1232,1269,1270],{},"Choosing serializable isolation without handling aborts:"," contention becomes unexplained failures.",[389,1273,1275],{"id":1274},"practice","Practice",[394,1277,1278,1279,1282],{},"Implement ",[408,1280,1281],{},"EnrollStudent"," so it checks course capacity, inserts an enrollment, and increments the enrolled count atomically. Prevent capacity from being exceeded under concurrent requests.",[1284,1285,1286],"accordion",{},[1287,1288,1291,1294,1315,1318,1340],"accordion-item",{"icon":1289,"label":1290},"i-lucide-lightbulb","Show solution design",[394,1292,1293],{},"One database-specific design uses a conditional update first:",[440,1295,1298],{"className":1296,"code":1297,"language":976,"meta":445,"style":445},"language-sql shiki shiki-themes solarized-light material-theme one-dark-pro","UPDATE courses\nSET enrolled = enrolled + 1\nWHERE id = $1 AND enrolled \u003C capacity;\n",[408,1299,1300,1305,1310],{"__ignoreMap":445},[449,1301,1302],{"class":451,"line":452},[449,1303,1304],{},"UPDATE courses\n",[449,1306,1307],{"class":451,"line":527},[449,1308,1309],{},"SET enrolled = enrolled + 1\n",[449,1311,1312],{"class":451,"line":568},[449,1313,1314],{},"WHERE id = $1 AND enrolled \u003C capacity;\n",[394,1316,1317],{},"Inside one transaction:",[1319,1320,1321,1324,1331,1337],"ol",{},[401,1322,1323],{},"Execute the conditional update.",[401,1325,1326,1327,1330],{},"Check ",[408,1328,1329],{},"RowsAffected","; zero means missing course or no capacity, which may require a separate bounded lookup to distinguish.",[401,1332,1333,1334,490],{},"Insert the enrollment with a unique constraint on ",[408,1335,1336],{},"(course_id, student_id)",[401,1338,1339],{},"Commit.",[394,1341,1342],{},"If the insert violates the unique enrollment constraint, roll back so the count increment also disappears. The conditional update makes the capacity decision atomic in the database instead of relying on a stale read followed by an unconditional write.",[389,1344,1346],{"id":1345},"summary","Summary",[398,1348,1349,1352,1358,1361,1364],{},[401,1350,1351],{},"Transactions make a group of database operations commit or roll back together.",[401,1353,1354,1355,1357],{},"Defer rollback immediately after ",[408,1356,410],{}," and check commit errors.",[401,1359,1360],{},"Use the transaction handle for every related database operation.",[401,1362,1363],{},"Choose isolation and retries from concrete database behaviour.",[401,1365,1366],{},"Coordinate external side effects with explicit durable patterns such as an outbox.",[394,1368,1369,1370,490],{},"Official reference: ",[1371,1372,1376],"a",{"href":1373,"rel":1374},"https:\u002F\u002Fgo.dev\u002Fdoc\u002Fdatabase\u002Fexecute-transactions",[1375],"nofollow","Executing transactions",[1378,1379],"learning-lesson-complete",{},[1381,1382],"learning-lesson-navigation",{"next":241,"next-label":240,"previous":231,"previous-label":230},[1384,1385,1386],"style",{},"html pre.shiki code .sEOdo, html code.shiki .sEOdo{--shiki-light:#859900;--shiki-default:#89DDFF;--shiki-dark:#C678DD}html pre.shiki code .shFME, html code.shiki .shFME{--shiki-light:#657B83;--shiki-default:#89DDFF;--shiki-dark:#ABB2BF}html pre.shiki code .syre3, html code.shiki .syre3{--shiki-light:#657B83;--shiki-light-font-style:inherit;--shiki-default:#EEFFFF;--shiki-default-font-style:italic;--shiki-dark:#E06C75;--shiki-dark-font-style:italic}html pre.shiki code .snwKR, html code.shiki .snwKR{--shiki-light:#CB4B16;--shiki-default:#FFCB6B;--shiki-dark:#E5C07B}html pre.shiki code .sisdC, html code.shiki .sisdC{--shiki-light:#268BD2;--shiki-default:#82AAFF;--shiki-dark:#61AFEF}html pre.shiki code .sF6sA, html code.shiki .sF6sA{--shiki-light:#586E75;--shiki-light-font-weight:bold;--shiki-default:#C792EA;--shiki-default-font-weight:inherit;--shiki-dark:#C678DD;--shiki-dark-font-weight:inherit}html pre.shiki code .s45-6, html code.shiki .s45-6{--shiki-light:#268BD2;--shiki-default:#EEFFFF;--shiki-dark:#E06C75}html pre.shiki code .su2KV, html code.shiki .su2KV{--shiki-light:#859900;--shiki-default:#89DDFF;--shiki-dark:#E5C07B}html pre.shiki code .sp8Z5, html code.shiki .sp8Z5{--shiki-light:#B58900;--shiki-default:#89DDFF;--shiki-dark:#D19A66}html pre.shiki code .s7Bcg, html code.shiki .s7Bcg{--shiki-light:#859900;--shiki-light-font-style:inherit;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#C678DD;--shiki-dark-font-style:inherit}html pre.shiki code .sRBoR, html code.shiki .sRBoR{--shiki-light:#859900;--shiki-default:#89DDFF;--shiki-dark:#56B6C2}html pre.shiki code .sED5a, html code.shiki .sED5a{--shiki-light:#2AA198;--shiki-default:#89DDFF;--shiki-dark:#98C379}html pre.shiki code .sVazx, html code.shiki .sVazx{--shiki-light:#2AA198;--shiki-default:#C3E88D;--shiki-dark:#98C379}html pre.shiki code .st3jj, html code.shiki .st3jj{--shiki-light:#CB4B16;--shiki-default:#F07178;--shiki-dark:#D19A66}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sN42N, html code.shiki .sN42N{--shiki-light:#859900;--shiki-default:#89DDFF;--shiki-dark:#ABB2BF}html pre.shiki code .sJsHy, html code.shiki .sJsHy{--shiki-light:#93A1A1;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#7F848E;--shiki-dark-font-style:italic}",{"title":445,"searchDepth":527,"depth":527,"links":1388},[1389,1390,1391,1392,1393,1394,1395,1396,1397,1398,1399,1400],{"id":391,"depth":527,"text":392},{"id":427,"depth":527,"text":428},{"id":437,"depth":527,"text":438},{"id":840,"depth":527,"text":841},{"id":921,"depth":527,"text":922},{"id":1094,"depth":527,"text":1095},{"id":1175,"depth":527,"text":1176},{"id":1202,"depth":527,"text":1203},{"id":1215,"depth":527,"text":1216},{"id":1225,"depth":527,"text":1226},{"id":1274,"depth":527,"text":1275},{"id":1345,"depth":527,"text":1346},"Keep related database changes atomic and avoid mixing transactional and non-transactional work.","md",null,{},{"icon":238},{"description":1407,"title":235},"Learn Go database\u002Fsql transactions with BeginTx, rollback, commit, isolation, retries, external side effects, and testing.","dXZM79Vwm0CMi1xK2KCQMBh8lL_fsDJrEIRnncGKLus",[1410,1412],{"title":230,"path":231,"stem":232,"description":1411,"icon":233,"children":-1},"Use database\u002Fsql safely with connection pools, contexts, parameters, row cleanup, and explicit mappings.",{"title":240,"path":241,"stem":242,"description":1413,"icon":243,"children":-1},"Verify identity, enforce permissions, protect sessions, and avoid common web-security mistakes.",1794118102598]