[{"data":1,"prerenderedAt":2074},["ShallowReactive",2],{"navigation_docs":3,"-backend-development-database-sql":377,"-backend-development-database-sql-surround":2069},[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":230,"body":379,"description":2061,"extension":2062,"links":2063,"meta":2064,"navigation":2065,"path":231,"seo":2066,"stem":232,"__hash__":2068},"docs\u002F5.backend-development\u002F7.database-sql.md",{"type":380,"value":381,"toc":2046},"minimark",[382,388,393,397,421,429,434,437,652,655,659,799,802,806,871,886,889,931,934,938,1283,1295,1299,1626,1636,1640,1651,1656,1660,1663,1666,1670,1673,1676,1680,1740,1744,1750,2001,2005,2026,2036,2039,2042],[383,384],"learning-lesson-meta",{"level":385,"prerequisites":386,"time":387},"Intermediate","Context, errors, application wiring, and basic SQL","60–75 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,409,412,415,418],"ul",{},[401,402,403,404,408],"li",{},"explain why ",[405,406,407],"code",{},"*sql.DB"," is a pool handle rather than one connection;",[401,410,411],{},"open and verify a database dependency;",[401,413,414],{},"execute parameterized statements and scan rows;",[401,416,417],{},"close rows and inspect iteration errors;",[401,419,420],{},"map storage failures into useful application errors.",[389,422,424,425,428],{"id":423},"mental-model-sqldb-manages-a-pool","Mental model: ",[405,426,427],{},"sql.DB"," manages a pool",[394,430,431,433],{},[405,432,407],{}," is a concurrency-safe handle that manages a pool of database connections. Opening the handle may not establish a connection immediately.",[394,435,436],{},"Create it once during application wiring, configure it, share it, and close it during process shutdown.",[438,439,444],"pre",{"className":440,"code":441,"language":442,"meta":443,"style":443},"language-go shiki shiki-themes solarized-light material-theme one-dark-pro","database, err := sql.Open(driverName, dataSourceName)\nif err != nil {\n    return nil, fmt.Errorf(\"open database handle: %w\", err)\n}\n\ndatabase.SetMaxOpenConns(20)\ndatabase.SetMaxIdleConns(10)\ndatabase.SetConnMaxLifetime(30 * time.Minute)\ndatabase.SetConnMaxIdleTime(5 * time.Minute)\n","go","",[405,445,446,490,510,550,556,563,581,598,627],{"__ignoreMap":443},[447,448,451,455,459,462,466,469,472,476,479,482,484,487],"span",{"class":449,"line":450},"line",1,[447,452,454],{"class":453},"s45-6","database",[447,456,458],{"class":457},"shFME",",",[447,460,461],{"class":453}," err",[447,463,465],{"class":464},"su2KV"," :=",[447,467,468],{"class":453}," sql",[447,470,471],{"class":457},".",[447,473,475],{"class":474},"sisdC","Open",[447,477,478],{"class":457},"(",[447,480,481],{"class":453},"driverName",[447,483,458],{"class":457},[447,485,486],{"class":453}," dataSourceName",[447,488,489],{"class":457},")\n",[447,491,493,497,499,503,507],{"class":449,"line":492},2,[447,494,496],{"class":495},"s7Bcg","if",[447,498,461],{"class":453},[447,500,502],{"class":501},"sRBoR"," !=",[447,504,506],{"class":505},"sp8Z5"," nil",[447,508,509],{"class":457}," {\n",[447,511,513,516,518,520,523,525,528,530,534,538,542,544,546,548],{"class":449,"line":512},3,[447,514,515],{"class":495},"    return",[447,517,506],{"class":505},[447,519,458],{"class":457},[447,521,522],{"class":453}," fmt",[447,524,471],{"class":457},[447,526,527],{"class":474},"Errorf",[447,529,478],{"class":457},[447,531,533],{"class":532},"sED5a","\"",[447,535,537],{"class":536},"sVazx","open database handle: ",[447,539,541],{"class":540},"st3jj","%w",[447,543,533],{"class":532},[447,545,458],{"class":457},[447,547,461],{"class":453},[447,549,489],{"class":457},[447,551,553],{"class":449,"line":552},4,[447,554,555],{"class":457},"}\n",[447,557,559],{"class":449,"line":558},5,[447,560,562],{"emptyLinePlaceholder":561},true,"\n",[447,564,566,568,570,573,575,579],{"class":449,"line":565},6,[447,567,454],{"class":453},[447,569,471],{"class":457},[447,571,572],{"class":474},"SetMaxOpenConns",[447,574,478],{"class":457},[447,576,578],{"class":577},"sAJzr","20",[447,580,489],{"class":457},[447,582,584,586,588,591,593,596],{"class":449,"line":583},7,[447,585,454],{"class":453},[447,587,471],{"class":457},[447,589,590],{"class":474},"SetMaxIdleConns",[447,592,478],{"class":457},[447,594,595],{"class":577},"10",[447,597,489],{"class":457},[447,599,601,603,605,608,610,613,617,620,622,625],{"class":449,"line":600},8,[447,602,454],{"class":453},[447,604,471],{"class":457},[447,606,607],{"class":474},"SetConnMaxLifetime",[447,609,478],{"class":457},[447,611,612],{"class":577},"30",[447,614,616],{"class":615},"sEOdo"," *",[447,618,619],{"class":453}," time",[447,621,471],{"class":457},[447,623,624],{"class":453},"Minute",[447,626,489],{"class":457},[447,628,630,632,634,637,639,642,644,646,648,650],{"class":449,"line":629},9,[447,631,454],{"class":453},[447,633,471],{"class":457},[447,635,636],{"class":474},"SetConnMaxIdleTime",[447,638,478],{"class":457},[447,640,641],{"class":577},"5",[447,643,616],{"class":615},[447,645,619],{"class":453},[447,647,471],{"class":457},[447,649,624],{"class":453},[447,651,489],{"class":457},[394,653,654],{},"Pool settings depend on database capacity, application replicas, workload, and driver behaviour. More connections are not automatically faster.",[389,656,658],{"id":657},"verify-startup-connectivity","Verify startup connectivity",[438,660,662],{"className":440,"code":661,"language":442,"meta":443,"style":443},"ctx, cancel := context.WithTimeout(parent, 5*time.Second)\ndefer cancel()\n\nif err := database.PingContext(ctx); err != nil {\n    database.Close()\n    return nil, fmt.Errorf(\"ping database: %w\", err)\n}\n",[405,663,664,707,717,721,752,764,795],{"__ignoreMap":443},[447,665,666,669,671,674,676,679,681,684,686,689,691,694,697,700,702,705],{"class":449,"line":450},[447,667,668],{"class":453},"ctx",[447,670,458],{"class":457},[447,672,673],{"class":453}," cancel",[447,675,465],{"class":464},[447,677,678],{"class":453}," context",[447,680,471],{"class":457},[447,682,683],{"class":474},"WithTimeout",[447,685,478],{"class":457},[447,687,688],{"class":453},"parent",[447,690,458],{"class":457},[447,692,693],{"class":577}," 5",[447,695,696],{"class":615},"*",[447,698,699],{"class":453},"time",[447,701,471],{"class":457},[447,703,704],{"class":453},"Second",[447,706,489],{"class":457},[447,708,709,712,714],{"class":449,"line":492},[447,710,711],{"class":495},"defer",[447,713,673],{"class":474},[447,715,716],{"class":457},"()\n",[447,718,719],{"class":449,"line":512},[447,720,562],{"emptyLinePlaceholder":561},[447,722,723,725,727,729,732,734,737,739,741,744,746,748,750],{"class":449,"line":552},[447,724,496],{"class":495},[447,726,461],{"class":453},[447,728,465],{"class":464},[447,730,731],{"class":453}," database",[447,733,471],{"class":457},[447,735,736],{"class":474},"PingContext",[447,738,478],{"class":457},[447,740,668],{"class":453},[447,742,743],{"class":457},");",[447,745,461],{"class":453},[447,747,502],{"class":501},[447,749,506],{"class":505},[447,751,509],{"class":457},[447,753,754,757,759,762],{"class":449,"line":558},[447,755,756],{"class":453},"    database",[447,758,471],{"class":457},[447,760,761],{"class":474},"Close",[447,763,716],{"class":457},[447,765,766,768,770,772,774,776,778,780,782,785,787,789,791,793],{"class":449,"line":565},[447,767,515],{"class":495},[447,769,506],{"class":505},[447,771,458],{"class":457},[447,773,522],{"class":453},[447,775,471],{"class":457},[447,777,527],{"class":474},[447,779,478],{"class":457},[447,781,533],{"class":532},[447,783,784],{"class":536},"ping database: ",[447,786,541],{"class":540},[447,788,533],{"class":532},[447,790,458],{"class":457},[447,792,461],{"class":453},[447,794,489],{"class":457},[447,796,797],{"class":449,"line":583},[447,798,555],{"class":457},[394,800,801],{},"The program must import and register an appropriate database driver. Drivers are third-party dependencies; choose and configure one from its maintained documentation.",[389,803,805],{"id":804},"parameterize-every-value","Parameterize every value",[438,807,809],{"className":440,"code":808,"language":442,"meta":443,"style":443},"result, err := database.ExecContext(\n    ctx,\n    `UPDATE lessons SET title = ? WHERE id = ?`,\n    title,\n    id,\n)\n",[405,810,811,832,840,853,860,867],{"__ignoreMap":443},[447,812,813,816,818,820,822,824,826,829],{"class":449,"line":450},[447,814,815],{"class":453},"result",[447,817,458],{"class":457},[447,819,461],{"class":453},[447,821,465],{"class":464},[447,823,731],{"class":453},[447,825,471],{"class":457},[447,827,828],{"class":474},"ExecContext",[447,830,831],{"class":457},"(\n",[447,833,834,837],{"class":449,"line":492},[447,835,836],{"class":453},"    ctx",[447,838,839],{"class":457},",\n",[447,841,842,845,848,851],{"class":449,"line":512},[447,843,844],{"class":532},"    `",[447,846,847],{"class":536},"UPDATE lessons SET title = ? WHERE id = ?",[447,849,850],{"class":532},"`",[447,852,839],{"class":457},[447,854,855,858],{"class":449,"line":552},[447,856,857],{"class":453},"    title",[447,859,839],{"class":457},[447,861,862,865],{"class":449,"line":558},[447,863,864],{"class":453},"    id",[447,866,839],{"class":457},[447,868,869],{"class":449,"line":565},[447,870,489],{"class":457},[394,872,873,874,877,878,881,882,885],{},"The placeholder syntax varies by database and driver. Some use ",[405,875,876],{},"?","; PostgreSQL drivers commonly use ",[405,879,880],{},"$1",", ",[405,883,884],{},"$2",", and so on.",[394,887,888],{},"Never concatenate untrusted values into SQL:",[438,890,892],{"className":440,"code":891,"language":442,"meta":443,"style":443},"\u002F\u002F Unsafe: input becomes SQL syntax.\nquery := \"SELECT id FROM users WHERE email = '\" + email + \"'\"\n",[405,893,894,900],{"__ignoreMap":443},[447,895,896],{"class":449,"line":450},[447,897,899],{"class":898},"sJsHy","\u002F\u002F Unsafe: input becomes SQL syntax.\n",[447,901,902,905,907,910,913,915,918,921,923,925,928],{"class":449,"line":492},[447,903,904],{"class":453},"query",[447,906,465],{"class":464},[447,908,909],{"class":532}," \"",[447,911,912],{"class":536},"SELECT id FROM users WHERE email = '",[447,914,533],{"class":532},[447,916,917],{"class":615}," +",[447,919,920],{"class":453}," email",[447,922,917],{"class":615},[447,924,909],{"class":532},[447,926,927],{"class":536},"'",[447,929,930],{"class":532},"\"\n",[394,932,933],{},"Parameters separate SQL code from data. Identifiers such as table names usually cannot be parameterized; choose them from a fixed allow-list rather than accepting arbitrary client input.",[389,935,937],{"id":936},"query-one-row","Query one row",[438,939,941],{"className":440,"code":940,"language":442,"meta":443,"style":443},"func (r *LessonRepository) Find(ctx context.Context, id string) (Lesson, error) {\n    const query = `\n        SELECT id, title, published, created_at\n        FROM lessons\n        WHERE id = ?`\n\n    var lesson Lesson\n    err := r.database.QueryRowContext(ctx, query, id).Scan(\n        &lesson.ID,\n        &lesson.Title,\n        &lesson.Published,\n        &lesson.CreatedAt,\n    )\n    if errors.Is(err, sql.ErrNoRows) {\n        return Lesson{}, ErrLessonNotFound\n    }\n    if err != nil {\n        return Lesson{}, fmt.Errorf(\"find lesson %q: %w\", id, err)\n    }\n    return lesson, nil\n}\n",[405,942,943,1003,1018,1023,1028,1036,1040,1051,1090,1105,1119,1133,1147,1153,1185,1200,1206,1219,1261,1266,1278],{"__ignoreMap":443},[447,944,945,948,951,955,957,961,964,967,969,971,973,975,978,980,983,987,989,991,994,996,999,1001],{"class":449,"line":450},[447,946,947],{"class":615},"func",[447,949,950],{"class":457}," (",[447,952,954],{"class":953},"syre3","r ",[447,956,696],{"class":615},[447,958,960],{"class":959},"snwKR","LessonRepository",[447,962,963],{"class":457},")",[447,965,966],{"class":474}," Find",[447,968,478],{"class":457},[447,970,668],{"class":953},[447,972,678],{"class":959},[447,974,471],{"class":457},[447,976,977],{"class":959},"Context",[447,979,458],{"class":457},[447,981,982],{"class":953}," id",[447,984,986],{"class":985},"sF6sA"," string",[447,988,963],{"class":457},[447,990,950],{"class":457},[447,992,993],{"class":959},"Lesson",[447,995,458],{"class":457},[447,997,998],{"class":985}," error",[447,1000,963],{"class":457},[447,1002,509],{"class":457},[447,1004,1005,1008,1012,1015],{"class":449,"line":492},[447,1006,1007],{"class":615},"    const",[447,1009,1011],{"class":1010},"sry10"," query",[447,1013,1014],{"class":464}," =",[447,1016,1017],{"class":532}," `\n",[447,1019,1020],{"class":449,"line":512},[447,1021,1022],{"class":536},"        SELECT id, title, published, created_at\n",[447,1024,1025],{"class":449,"line":552},[447,1026,1027],{"class":536},"        FROM lessons\n",[447,1029,1030,1033],{"class":449,"line":558},[447,1031,1032],{"class":536},"        WHERE id = ?",[447,1034,1035],{"class":532},"`\n",[447,1037,1038],{"class":449,"line":565},[447,1039,562],{"emptyLinePlaceholder":561},[447,1041,1042,1045,1048],{"class":449,"line":583},[447,1043,1044],{"class":615},"    var",[447,1046,1047],{"class":453}," lesson",[447,1049,1050],{"class":959}," Lesson\n",[447,1052,1053,1056,1058,1061,1063,1065,1067,1070,1072,1074,1076,1078,1080,1082,1085,1088],{"class":449,"line":600},[447,1054,1055],{"class":453},"    err",[447,1057,465],{"class":464},[447,1059,1060],{"class":453}," r",[447,1062,471],{"class":457},[447,1064,454],{"class":453},[447,1066,471],{"class":457},[447,1068,1069],{"class":474},"QueryRowContext",[447,1071,478],{"class":457},[447,1073,668],{"class":453},[447,1075,458],{"class":457},[447,1077,1011],{"class":453},[447,1079,458],{"class":457},[447,1081,982],{"class":453},[447,1083,1084],{"class":457},").",[447,1086,1087],{"class":474},"Scan",[447,1089,831],{"class":457},[447,1091,1092,1095,1098,1100,1103],{"class":449,"line":629},[447,1093,1094],{"class":615},"        &",[447,1096,1097],{"class":453},"lesson",[447,1099,471],{"class":457},[447,1101,1102],{"class":453},"ID",[447,1104,839],{"class":457},[447,1106,1108,1110,1112,1114,1117],{"class":449,"line":1107},10,[447,1109,1094],{"class":615},[447,1111,1097],{"class":453},[447,1113,471],{"class":457},[447,1115,1116],{"class":453},"Title",[447,1118,839],{"class":457},[447,1120,1122,1124,1126,1128,1131],{"class":449,"line":1121},11,[447,1123,1094],{"class":615},[447,1125,1097],{"class":453},[447,1127,471],{"class":457},[447,1129,1130],{"class":453},"Published",[447,1132,839],{"class":457},[447,1134,1136,1138,1140,1142,1145],{"class":449,"line":1135},12,[447,1137,1094],{"class":615},[447,1139,1097],{"class":453},[447,1141,471],{"class":457},[447,1143,1144],{"class":453},"CreatedAt",[447,1146,839],{"class":457},[447,1148,1150],{"class":449,"line":1149},13,[447,1151,1152],{"class":457},"    )\n",[447,1154,1156,1159,1162,1164,1167,1169,1172,1174,1176,1178,1181,1183],{"class":449,"line":1155},14,[447,1157,1158],{"class":495},"    if",[447,1160,1161],{"class":453}," errors",[447,1163,471],{"class":457},[447,1165,1166],{"class":474},"Is",[447,1168,478],{"class":457},[447,1170,1171],{"class":453},"err",[447,1173,458],{"class":457},[447,1175,468],{"class":453},[447,1177,471],{"class":457},[447,1179,1180],{"class":453},"ErrNoRows",[447,1182,963],{"class":457},[447,1184,509],{"class":457},[447,1186,1188,1191,1194,1197],{"class":449,"line":1187},15,[447,1189,1190],{"class":495},"        return",[447,1192,1193],{"class":959}," Lesson",[447,1195,1196],{"class":457},"{},",[447,1198,1199],{"class":453}," ErrLessonNotFound\n",[447,1201,1203],{"class":449,"line":1202},16,[447,1204,1205],{"class":457},"    }\n",[447,1207,1209,1211,1213,1215,1217],{"class":449,"line":1208},17,[447,1210,1158],{"class":495},[447,1212,461],{"class":453},[447,1214,502],{"class":501},[447,1216,506],{"class":505},[447,1218,509],{"class":457},[447,1220,1222,1224,1226,1228,1230,1232,1234,1236,1238,1241,1244,1247,1249,1251,1253,1255,1257,1259],{"class":449,"line":1221},18,[447,1223,1190],{"class":495},[447,1225,1193],{"class":959},[447,1227,1196],{"class":457},[447,1229,522],{"class":453},[447,1231,471],{"class":457},[447,1233,527],{"class":474},[447,1235,478],{"class":457},[447,1237,533],{"class":532},[447,1239,1240],{"class":536},"find lesson ",[447,1242,1243],{"class":540},"%q",[447,1245,1246],{"class":536},": ",[447,1248,541],{"class":540},[447,1250,533],{"class":532},[447,1252,458],{"class":457},[447,1254,982],{"class":453},[447,1256,458],{"class":457},[447,1258,461],{"class":453},[447,1260,489],{"class":457},[447,1262,1264],{"class":449,"line":1263},19,[447,1265,1205],{"class":457},[447,1267,1269,1271,1273,1275],{"class":449,"line":1268},20,[447,1270,515],{"class":495},[447,1272,1047],{"class":453},[447,1274,458],{"class":457},[447,1276,1277],{"class":505}," nil\n",[447,1279,1281],{"class":449,"line":1280},21,[447,1282,555],{"class":457},[394,1284,1285,1287,1288,1290,1291,1294],{},[405,1286,1069],{}," defers query errors until ",[405,1289,1087],{},". Handle ",[405,1292,1293],{},"sql.ErrNoRows"," separately when absence has domain meaning.",[389,1296,1298],{"id":1297},"query-several-rows","Query several rows",[438,1300,1302],{"className":440,"code":1301,"language":442,"meta":443,"style":443},"rows, err := database.QueryContext(ctx, query, published)\nif err != nil {\n    return nil, fmt.Errorf(\"query lessons: %w\", err)\n}\ndefer rows.Close()\n\nlessons := make([]Lesson, 0)\nfor rows.Next() {\n    var lesson Lesson\n    if err := rows.Scan(&lesson.ID, &lesson.Title); err != nil {\n        return nil, fmt.Errorf(\"scan lesson: %w\", err)\n    }\n    lessons = append(lessons, lesson)\n}\nif err := rows.Err(); err != nil {\n    return nil, fmt.Errorf(\"iterate lessons: %w\", err)\n}\nreturn lessons, nil\n",[405,1303,1304,1337,1349,1380,1384,1397,1401,1423,1440,1448,1494,1525,1529,1549,1553,1579,1610,1614],{"__ignoreMap":443},[447,1305,1306,1309,1311,1313,1315,1317,1319,1322,1324,1326,1328,1330,1332,1335],{"class":449,"line":450},[447,1307,1308],{"class":453},"rows",[447,1310,458],{"class":457},[447,1312,461],{"class":453},[447,1314,465],{"class":464},[447,1316,731],{"class":453},[447,1318,471],{"class":457},[447,1320,1321],{"class":474},"QueryContext",[447,1323,478],{"class":457},[447,1325,668],{"class":453},[447,1327,458],{"class":457},[447,1329,1011],{"class":453},[447,1331,458],{"class":457},[447,1333,1334],{"class":453}," published",[447,1336,489],{"class":457},[447,1338,1339,1341,1343,1345,1347],{"class":449,"line":492},[447,1340,496],{"class":495},[447,1342,461],{"class":453},[447,1344,502],{"class":501},[447,1346,506],{"class":505},[447,1348,509],{"class":457},[447,1350,1351,1353,1355,1357,1359,1361,1363,1365,1367,1370,1372,1374,1376,1378],{"class":449,"line":512},[447,1352,515],{"class":495},[447,1354,506],{"class":505},[447,1356,458],{"class":457},[447,1358,522],{"class":453},[447,1360,471],{"class":457},[447,1362,527],{"class":474},[447,1364,478],{"class":457},[447,1366,533],{"class":532},[447,1368,1369],{"class":536},"query lessons: ",[447,1371,541],{"class":540},[447,1373,533],{"class":532},[447,1375,458],{"class":457},[447,1377,461],{"class":453},[447,1379,489],{"class":457},[447,1381,1382],{"class":449,"line":552},[447,1383,555],{"class":457},[447,1385,1386,1388,1391,1393,1395],{"class":449,"line":558},[447,1387,711],{"class":495},[447,1389,1390],{"class":453}," rows",[447,1392,471],{"class":457},[447,1394,761],{"class":474},[447,1396,716],{"class":457},[447,1398,1399],{"class":449,"line":565},[447,1400,562],{"emptyLinePlaceholder":561},[447,1402,1403,1406,1408,1411,1414,1416,1418,1421],{"class":449,"line":583},[447,1404,1405],{"class":453},"lessons",[447,1407,465],{"class":464},[447,1409,1410],{"class":474}," make",[447,1412,1413],{"class":457},"([]",[447,1415,993],{"class":959},[447,1417,458],{"class":457},[447,1419,1420],{"class":577}," 0",[447,1422,489],{"class":457},[447,1424,1425,1428,1430,1432,1435,1438],{"class":449,"line":600},[447,1426,1427],{"class":495},"for",[447,1429,1390],{"class":453},[447,1431,471],{"class":457},[447,1433,1434],{"class":474},"Next",[447,1436,1437],{"class":457},"()",[447,1439,509],{"class":457},[447,1441,1442,1444,1446],{"class":449,"line":629},[447,1443,1044],{"class":615},[447,1445,1047],{"class":453},[447,1447,1050],{"class":959},[447,1449,1450,1452,1454,1456,1458,1460,1462,1464,1467,1469,1471,1473,1475,1478,1480,1482,1484,1486,1488,1490,1492],{"class":449,"line":1107},[447,1451,1158],{"class":495},[447,1453,461],{"class":453},[447,1455,465],{"class":464},[447,1457,1390],{"class":453},[447,1459,471],{"class":457},[447,1461,1087],{"class":474},[447,1463,478],{"class":457},[447,1465,1466],{"class":615},"&",[447,1468,1097],{"class":453},[447,1470,471],{"class":457},[447,1472,1102],{"class":453},[447,1474,458],{"class":457},[447,1476,1477],{"class":615}," &",[447,1479,1097],{"class":453},[447,1481,471],{"class":457},[447,1483,1116],{"class":453},[447,1485,743],{"class":457},[447,1487,461],{"class":453},[447,1489,502],{"class":501},[447,1491,506],{"class":505},[447,1493,509],{"class":457},[447,1495,1496,1498,1500,1502,1504,1506,1508,1510,1512,1515,1517,1519,1521,1523],{"class":449,"line":1121},[447,1497,1190],{"class":495},[447,1499,506],{"class":505},[447,1501,458],{"class":457},[447,1503,522],{"class":453},[447,1505,471],{"class":457},[447,1507,527],{"class":474},[447,1509,478],{"class":457},[447,1511,533],{"class":532},[447,1513,1514],{"class":536},"scan lesson: ",[447,1516,541],{"class":540},[447,1518,533],{"class":532},[447,1520,458],{"class":457},[447,1522,461],{"class":453},[447,1524,489],{"class":457},[447,1526,1527],{"class":449,"line":1135},[447,1528,1205],{"class":457},[447,1530,1531,1534,1536,1539,1541,1543,1545,1547],{"class":449,"line":1149},[447,1532,1533],{"class":453},"    lessons",[447,1535,1014],{"class":464},[447,1537,1538],{"class":474}," append",[447,1540,478],{"class":457},[447,1542,1405],{"class":453},[447,1544,458],{"class":457},[447,1546,1047],{"class":453},[447,1548,489],{"class":457},[447,1550,1551],{"class":449,"line":1155},[447,1552,555],{"class":457},[447,1554,1555,1557,1559,1561,1563,1565,1568,1571,1573,1575,1577],{"class":449,"line":1187},[447,1556,496],{"class":495},[447,1558,461],{"class":453},[447,1560,465],{"class":464},[447,1562,1390],{"class":453},[447,1564,471],{"class":457},[447,1566,1567],{"class":474},"Err",[447,1569,1570],{"class":457},"();",[447,1572,461],{"class":453},[447,1574,502],{"class":501},[447,1576,506],{"class":505},[447,1578,509],{"class":457},[447,1580,1581,1583,1585,1587,1589,1591,1593,1595,1597,1600,1602,1604,1606,1608],{"class":449,"line":1202},[447,1582,515],{"class":495},[447,1584,506],{"class":505},[447,1586,458],{"class":457},[447,1588,522],{"class":453},[447,1590,471],{"class":457},[447,1592,527],{"class":474},[447,1594,478],{"class":457},[447,1596,533],{"class":532},[447,1598,1599],{"class":536},"iterate lessons: ",[447,1601,541],{"class":540},[447,1603,533],{"class":532},[447,1605,458],{"class":457},[447,1607,461],{"class":453},[447,1609,489],{"class":457},[447,1611,1612],{"class":449,"line":1208},[447,1613,555],{"class":457},[447,1615,1616,1619,1622,1624],{"class":449,"line":1221},[447,1617,1618],{"class":495},"return",[447,1620,1621],{"class":453}," lessons",[447,1623,458],{"class":457},[447,1625,1277],{"class":505},[394,1627,1628,1629,1632,1633,1635],{},"Closing rows releases the connection back to the pool. Always check ",[405,1630,1631],{},"rows.Err()"," because iteration can stop due to an error after ",[405,1634,1321],{}," succeeds.",[389,1637,1639],{"id":1638},"nullable-database-values","Nullable database values",[394,1641,1642,1643,1646,1647,1650],{},"If a column can be SQL ",[405,1644,1645],{},"NULL",", scan into a suitable nullable representation such as ",[405,1648,1649],{},"sql.NullString",", a pointer, or a driver-supported nullable type. Convert that storage representation explicitly into the domain model.",[394,1652,1653,1654,471],{},"Do not make every domain field nullable simply because a legacy schema permits ",[405,1655,1645],{},[389,1657,1659],{"id":1658},"context-and-timeouts","Context and timeouts",[394,1661,1662],{},"Pass the request or job context through repository methods. A driver and database must cooperate for cancellation to interrupt work promptly, so also configure database-side statement timeouts where appropriate.",[394,1664,1665],{},"Do not create a fresh background context inside the repository; it disconnects the query from caller cancellation.",[389,1667,1669],{"id":1668},"repository-boundaries","Repository boundaries",[394,1671,1672],{},"Repositories should translate expected storage outcomes into domain-level errors while preserving unexpected errors for diagnostics.",[394,1674,1675],{},"Keep SQL details, driver constraint codes, and row shapes out of HTTP handlers. Keep HTTP status codes out of repositories.",[389,1677,1679],{"id":1678},"common-mistakes","Common mistakes",[398,1681,1682,1693,1705,1711,1725,1734],{},[401,1683,1684,1692],{},[1685,1686,1687,1688,1691],"strong",{},"Calling ",[405,1689,1690],{},"sql.Open"," per request:"," pools multiply and connections churn.",[401,1694,1695,1701,1702,1704],{},[1685,1696,1697,1698,1700],{},"Assuming ",[405,1699,1690],{}," proves connectivity:"," use a bounded ",[405,1703,736],{}," when startup requires it.",[401,1706,1707,1710],{},[1685,1708,1709],{},"Building SQL with client strings:"," this creates SQL injection risk.",[401,1712,1713,1724],{},[1685,1714,1715,1716,1719,1720,1723],{},"Forgetting ",[405,1717,1718],{},"rows.Close"," or ",[405,1721,1722],{},"rows.Err",":"," connections leak or late failures disappear.",[401,1726,1727,1733],{},[1685,1728,1729,1730,1723],{},"Using ",[405,1731,1732],{},"SELECT *"," column-order changes can break scans and fetch unnecessary data.",[401,1735,1736,1739],{},[1685,1737,1738],{},"Tuning the pool without database-wide limits:"," replicas can collectively exhaust the server.",[389,1741,1743],{"id":1742},"practice","Practice",[394,1745,1746,1747,1749],{},"Implement repository methods to create, find, and list lessons. Use contexts, parameterized values, explicit columns, pagination, ",[405,1748,1293],{}," mapping, and complete row cleanup.",[1751,1752,1753],"accordion",{},[1754,1755,1758,1765,1991],"accordion-item",{"icon":1756,"label":1757},"i-lucide-lightbulb","Show create-method outline",[394,1759,1760,1761,1764],{},"The exact generated-ID syntax is database-specific. A database supporting ",[405,1762,1763],{},"RETURNING"," may use:",[438,1766,1768],{"className":440,"code":1767,"language":442,"meta":443,"style":443},"func (r *LessonRepository) Create(ctx context.Context, lesson Lesson) (Lesson, error) {\n    const query = `\n        INSERT INTO lessons (title, published, created_at)\n        VALUES ($1, $2, $3)\n        RETURNING id`\n\n    err := r.database.QueryRowContext(\n        ctx,\n        query,\n        lesson.Title,\n        lesson.Published,\n        lesson.CreatedAt,\n    ).Scan(&lesson.ID)\n    if err != nil {\n        return Lesson{}, fmt.Errorf(\"insert lesson: %w\", err)\n    }\n    return lesson, nil\n}\n",[405,1769,1770,1817,1827,1832,1837,1844,1848,1866,1873,1880,1891,1901,1911,1930,1942,1973,1977,1987],{"__ignoreMap":443},[447,1771,1772,1774,1776,1778,1780,1782,1784,1787,1789,1791,1793,1795,1797,1799,1801,1803,1805,1807,1809,1811,1813,1815],{"class":449,"line":450},[447,1773,947],{"class":615},[447,1775,950],{"class":457},[447,1777,954],{"class":953},[447,1779,696],{"class":615},[447,1781,960],{"class":959},[447,1783,963],{"class":457},[447,1785,1786],{"class":474}," Create",[447,1788,478],{"class":457},[447,1790,668],{"class":953},[447,1792,678],{"class":959},[447,1794,471],{"class":457},[447,1796,977],{"class":959},[447,1798,458],{"class":457},[447,1800,1047],{"class":953},[447,1802,1193],{"class":959},[447,1804,963],{"class":457},[447,1806,950],{"class":457},[447,1808,993],{"class":959},[447,1810,458],{"class":457},[447,1812,998],{"class":985},[447,1814,963],{"class":457},[447,1816,509],{"class":457},[447,1818,1819,1821,1823,1825],{"class":449,"line":492},[447,1820,1007],{"class":615},[447,1822,1011],{"class":1010},[447,1824,1014],{"class":464},[447,1826,1017],{"class":532},[447,1828,1829],{"class":449,"line":512},[447,1830,1831],{"class":536},"        INSERT INTO lessons (title, published, created_at)\n",[447,1833,1834],{"class":449,"line":552},[447,1835,1836],{"class":536},"        VALUES ($1, $2, $3)\n",[447,1838,1839,1842],{"class":449,"line":558},[447,1840,1841],{"class":536},"        RETURNING id",[447,1843,1035],{"class":532},[447,1845,1846],{"class":449,"line":565},[447,1847,562],{"emptyLinePlaceholder":561},[447,1849,1850,1852,1854,1856,1858,1860,1862,1864],{"class":449,"line":583},[447,1851,1055],{"class":453},[447,1853,465],{"class":464},[447,1855,1060],{"class":453},[447,1857,471],{"class":457},[447,1859,454],{"class":453},[447,1861,471],{"class":457},[447,1863,1069],{"class":474},[447,1865,831],{"class":457},[447,1867,1868,1871],{"class":449,"line":600},[447,1869,1870],{"class":453},"        ctx",[447,1872,839],{"class":457},[447,1874,1875,1878],{"class":449,"line":629},[447,1876,1877],{"class":453},"        query",[447,1879,839],{"class":457},[447,1881,1882,1885,1887,1889],{"class":449,"line":1107},[447,1883,1884],{"class":453},"        lesson",[447,1886,471],{"class":457},[447,1888,1116],{"class":453},[447,1890,839],{"class":457},[447,1892,1893,1895,1897,1899],{"class":449,"line":1121},[447,1894,1884],{"class":453},[447,1896,471],{"class":457},[447,1898,1130],{"class":453},[447,1900,839],{"class":457},[447,1902,1903,1905,1907,1909],{"class":449,"line":1135},[447,1904,1884],{"class":453},[447,1906,471],{"class":457},[447,1908,1144],{"class":453},[447,1910,839],{"class":457},[447,1912,1913,1916,1918,1920,1922,1924,1926,1928],{"class":449,"line":1149},[447,1914,1915],{"class":457},"    ).",[447,1917,1087],{"class":474},[447,1919,478],{"class":457},[447,1921,1466],{"class":615},[447,1923,1097],{"class":453},[447,1925,471],{"class":457},[447,1927,1102],{"class":453},[447,1929,489],{"class":457},[447,1931,1932,1934,1936,1938,1940],{"class":449,"line":1155},[447,1933,1158],{"class":495},[447,1935,461],{"class":453},[447,1937,502],{"class":501},[447,1939,506],{"class":505},[447,1941,509],{"class":457},[447,1943,1944,1946,1948,1950,1952,1954,1956,1958,1960,1963,1965,1967,1969,1971],{"class":449,"line":1187},[447,1945,1190],{"class":495},[447,1947,1193],{"class":959},[447,1949,1196],{"class":457},[447,1951,522],{"class":453},[447,1953,471],{"class":457},[447,1955,527],{"class":474},[447,1957,478],{"class":457},[447,1959,533],{"class":532},[447,1961,1962],{"class":536},"insert lesson: ",[447,1964,541],{"class":540},[447,1966,533],{"class":532},[447,1968,458],{"class":457},[447,1970,461],{"class":453},[447,1972,489],{"class":457},[447,1974,1975],{"class":449,"line":1202},[447,1976,1205],{"class":457},[447,1978,1979,1981,1983,1985],{"class":449,"line":1208},[447,1980,515],{"class":495},[447,1982,1047],{"class":453},[447,1984,458],{"class":457},[447,1986,1277],{"class":505},[447,1988,1989],{"class":449,"line":1221},[447,1990,555],{"class":457},[394,1992,1993,1994,1996,1997,2000],{},"Other databases may use ",[405,1995,828],{}," followed by ",[405,1998,1999],{},"LastInsertId"," when supported. Keep the implementation in the database-specific adapter and test it against the actual database engine, not only a mock.",[389,2002,2004],{"id":2003},"summary","Summary",[398,2006,2007,2012,2015,2018,2023],{},[401,2008,2009,2011],{},[405,2010,407],{}," is a shared connection-pool handle.",[401,2013,2014],{},"Parameterize data values and allow-list dynamic identifiers.",[401,2016,2017],{},"Use context-aware operations and explicit query timeouts.",[401,2019,2020,2021,471],{},"Close row iterators and inspect ",[405,2022,1631],{},[401,2024,2025],{},"Translate expected persistence outcomes at the repository boundary.",[394,2027,2028,2029,471],{},"Official reference: ",[2030,2031,2035],"a",{"href":2032,"rel":2033},"https:\u002F\u002Fgo.dev\u002Fdoc\u002Fdatabase\u002F",[2034],"nofollow","Accessing relational databases",[2037,2038],"learning-lesson-complete",{},[2040,2041],"learning-lesson-navigation",{"next":236,"next-label":235,"previous":226,"previous-label":225},[2043,2044,2045],"style",{},"html pre.shiki code .s45-6, html code.shiki .s45-6{--shiki-light:#268BD2;--shiki-default:#EEFFFF;--shiki-dark:#E06C75}html pre.shiki code .shFME, html code.shiki .shFME{--shiki-light:#657B83;--shiki-default:#89DDFF;--shiki-dark:#ABB2BF}html pre.shiki code .su2KV, html code.shiki .su2KV{--shiki-light:#859900;--shiki-default:#89DDFF;--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 .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 .sp8Z5, html code.shiki .sp8Z5{--shiki-light:#B58900;--shiki-default:#89DDFF;--shiki-dark:#D19A66}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 pre.shiki code .sAJzr, html code.shiki .sAJzr{--shiki-light:#D33682;--shiki-default:#F78C6C;--shiki-dark:#D19A66}html pre.shiki code .sEOdo, html code.shiki .sEOdo{--shiki-light:#859900;--shiki-default:#89DDFF;--shiki-dark:#C678DD}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 .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}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 .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 .sry10, html code.shiki .sry10{--shiki-light:#268BD2;--shiki-default:#EEFFFF;--shiki-dark:#E5C07B}",{"title":443,"searchDepth":492,"depth":492,"links":2047},[2048,2049,2051,2052,2053,2054,2055,2056,2057,2058,2059,2060],{"id":391,"depth":492,"text":392},{"id":423,"depth":492,"text":2050},"Mental model: sql.DB manages a pool",{"id":657,"depth":492,"text":658},{"id":804,"depth":492,"text":805},{"id":936,"depth":492,"text":937},{"id":1297,"depth":492,"text":1298},{"id":1638,"depth":492,"text":1639},{"id":1658,"depth":492,"text":1659},{"id":1668,"depth":492,"text":1669},{"id":1678,"depth":492,"text":1679},{"id":1742,"depth":492,"text":1743},{"id":2003,"depth":492,"text":2004},"Use database\u002Fsql safely with connection pools, contexts, parameters, row cleanup, and explicit mappings.","md",null,{},{"icon":233},{"description":2067,"title":230},"Learn Go database\u002Fsql handles, pools, parameterized queries, QueryRow, Rows, nullable values, timeouts, and safe repository design.","GeFfji55HtWp-19E5uPXkP45LxitpUQZkVmhICEdbuI",[2070,2072],{"title":225,"path":226,"stem":227,"description":2071,"icon":228,"children":-1},"Use logs, metrics, traces, and profiles to understand a running service without guessing.",{"title":235,"path":236,"stem":237,"description":2073,"icon":238,"children":-1},"Keep related database changes atomic and avoid mixing transactional and non-transactional work.",1794118102379]